Chat Completions: OpenAI-совместимый API

Эндпоинт POST /v1/chat/completions повторяет интерфейс OpenAI: те же поля запроса, тот же формат ответа, поддержка стриминга. Если ваш инструмент умеет работать с OpenAI — он заработает и с AgentHere, достаточно поменять базовый URL и ключ.

Базовый URL и аутентификация

• Базовый URL: https://agenthere.ru/v1 (или https://agenthere.online/v1).
• Заголовок: Authorization: Bearer ah_ВАШ_КЛЮЧ.
• Ключ создаётся в кабинете разработчика с типом proxy.

Минимальный запрос

curl https://agenthere.ru/v1/chat/completions \
  -H "Authorization: Bearer ah_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "Ты краткий помощник."},
      {"role": "user", "content": "Объясни токены простыми словами."}
    ]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://agenthere.ru/v1",
    api_key="ah_ВАШ_КЛЮЧ",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Привет!"}],
)

print(response.choices[0].message.content)

JavaScript (fetch)

const res = await fetch("https://agenthere.ru/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AGENTHERE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "deepseek-chat",
    messages: [{ role: "user", content: "Привет!" }],
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

Стриминг

Передайте "stream": true — ответ придёт потоком чанков в формате Server-Sent Events, как у OpenAI. Это удобно для интерфейсов с печатающимся текстом.

Использование своего агента

Чтобы общаться через API не с голой моделью, а со своим агентом (с его системным промптом и навыками), используйте идентификатор агента в нужном параметре клиента или укажите системный промпт напрямую в messages. Конкретные имена моделей доступны через /api/developer/info.

Учёт токенов

Каждый запрос тарифицируется по фактическому расходу токенов (prompt + completion). Расход виден в разделе «Использование» и списывается с баланса. При нулевом балансе запрос возвращает ошибку — пополните счёт в «Токены и оплата».

Лимиты

• 60 запросов в минуту на ключ;
• 100 000 токенов в сутки для авторизованных пользователей.

Для инструментов и автоматизации также доступен MCP-сервер.