API для разработчиков: обзор

AgentHere предоставляет OpenAI-совместимый API и MCP-сервер. Вы можете подключить платформу к своему коду, Cursor, Claude Desktop, opencode или любому клиенту, который умеет работать с OpenAI-совместимыми эндпоинтами.

Что доступно

• Chat Completions — POST /v1/chat/completions (стриминг и обычный режим), совместимо с OpenAI.
• Anthropic Messages — POST /anthropic/v1/messages (Anthropic-совместимый эндпоинт для клиентов Claude).
• Список моделей — GET /v1/models.
• MCP-сервер — POST /api/mcp с инструментами зрения, аудио, генерации изображений и видео, поиска и чтения страниц.

Все запросы тарифицируются по токенам с вашего баланса — так же, как чат в вебе.

Создание API-ключа

1. Войдите в аккаунт и откройте «Ключи API».
2. Создайте ключ с типом proxy — он открывает /v1/* и /api/mcp.
3. Скопируйте ключ сразу: он показывается один раз и хранится в виде хэша.

Ключ начинается с ah_ и передаётся в заголовке Authorization: Bearer ah_....

curl https://agenthere.ru/v1/chat/completions \
  -H "Authorization: Bearer ah_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"Привет!"}]}'

Базовый URL — https://agenthere.ru/v1. Для API-клиентов используйте agenthere.ru: agenthere.online редиректит на него, и при редиректе ключ может потеряться.

Точка информации для разработчиков

Чтобы узнать базовые URL и каталог моделей программно, вызовите:

curl https://agenthere.ru/api/developer/info \
  -H "Authorization: Bearer ah_ВАШ_КЛЮЧ"

Ответ содержит openai_base_url, mcp_url и список моделей с их идентификаторами. Значения формируются на лету и всегда синхронны с шлюзом.

Типы ключей

Для большинства задач достаточно ключа proxy.

Что дальше

• Подробно про чат-эндпоинт и примеры на Python/JS — в Chat Completions.
• Про MCP-сервер и инструменты — в MCP-сервер и инструменты.