Документация API go2llm

Один аккаунт, USD-баланс и API-ключи для опубликованных AI-моделей. Базовый адрес Anthropic-совместимого API — https://go2llm.tech, OpenAI-совместимого — https://go2llm.tech/v1.

Быстрый старт

1. Зарегистрируйтесь и создайте API-ключ в кабинете.
2. Получите актуальный каталог через GET /v1/models.
3. Выберите model ID и один из объявленных для него endpoints.
4. Отправьте короткий запрос и проверьте списание в кабинете.

curl https://go2llm.tech/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","max_tokens":120,"messages":[{"role":"user","content":"Ответь: OK"}]}'

Авторизация

API-запросы авторизуются пользовательским ключом. OpenAI-совместимые endpoints принимают Authorization: Bearer YOUR_API_KEY; Anthropic Messages также принимает x-api-key: YOUR_API_KEY. Регистрация и вход в кабинет доступны по email/password, Google и Telegram. Браузерная сессия кабинета не заменяет API-ключ.

Получение и использование API-ключа

Создайте ключ во вкладке ключей, сразу сохраните показанное значение и не передавайте его в клиентский JavaScript, репозиторий, скриншот или поддержку. Для production, разработки и CI используйте разные ключи. По умолчанию каждый ключ ограничен 20 RPM.

Во всех примерах документации используется только безопасный заполнитель YOUR_API_KEY.

Каталог моделей

Таблица ниже строится из того же актуального каталога, что GET /v1/models. В ней перечислены доступные модели, их точный ID, цены, возможности и endpoints — используйте их без изменений, таблица обновляется вместе с опубликованным snapshot.

Одну модель можно запросить отдельно: GET /v1/models/{id} возвращает ту же запись, что элемент массива в /v1/models, и тоже не требует ключа. Алиас резолвится, но в ответе id канонический — запрос claude-sonnet-5 вернёт claude-sonnet-4-5, и подстановка видна сразу. Неизвестный ID даёт 404 model_not_found.

curl https://go2llm.tech/v1/models/MODEL_ID_FROM_CATALOG

Выбор endpoint

Используйте только значение из endpoints выбранной модели:

• messages → POST /v1/messages в формате Anthropic;
• chat.completions → POST /v1/chat/completions в формате OpenAI;
• images.generations → POST /v1/images/generations;
• images.edits → POST /v1/images/edits (img2img).

Неподходящая пара model ID и endpoint возвращает 400 model_protocol_mismatch.

POST /v1/responses в поле endpoints не появляется: это не то, что продаётся на модели, а то, как с ней можно разговаривать. Маршрут обслуживает ровно те же модели, что chat.completions.

Anthropic Messages

curl https://go2llm.tech/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","max_tokens":120,"messages":[{"role":"user","content":"Ответь: OK"}]}'

Маршрут доступен моделям с endpoint messages.

OpenAI Chat Completions

curl https://go2llm.tech/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","max_tokens":120,"messages":[{"role":"user","content":"Ответь: OK"}]}'

Маршрут доступен моделям с endpoint chat.completions.

OpenAI Responses API

POST /v1/responses принимает формат OpenAI Responses API и работает как адаптер поверх chat.completions: те же модели, тот же резерв, то же списание и тот же usage.cost_usd. Модель, у которой в каталоге только messages, через этот маршрут недоступна.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://go2llm.tech/v1")

response = client.responses.create(
    model="MODEL_ID_FROM_CATALOG",
    instructions="Отвечай одной строкой.",
    input="Ответь: OK",
    max_output_tokens=64,
)

print(response.output_text)

Поддержаны input строкой и массивом, instructions, tools и tool_choice в плоской форме Responses, function_call и function_call_output, max_output_tokens, stream, parallel_tool_calls, response_format.

Шим stateless: шлюз не хранит историю ответов. previous_response_id, store: true и background: true отклоняются с 400 stateful_responses_unsupported — передавайте всю историю в input. Подробности и примеры потока и вызова инструмента: Responses API.

Подсчёт токенов

POST /v1/messages/count_tokens принимает то же тело, что POST /v1/messages (model, messages, system, tools), и возвращает размер входа. Ключ обязателен, но резерв не ставится и списания нет — вызов бесплатный. Отдельный лимит: 60 RPM на ключ.

curl https://go2llm.tech/v1/messages/count_tokens \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","messages":[{"role":"user","content":"Ответь: OK"}]}'

{
  "input_tokens": 14,
  "go2llm": { "exact": false, "method": "byte_estimate", "typical_error_pct": null }
}

Это оценка по байтам, а не вендорский токенайзер. Блок go2llm в ответе говорит об этом явно: exact: false. Годится, чтобы решить, влезает ли контекст в окно, и прикинуть стоимость; не годится как точный биллинговый счётчик. Фактическое количество токенов и фактическую цену смотрите в usage реального ответа модели.

typical_error_pct приходит null: типичное отклонение оценки от факта мы ещё не измерили и поэтому не публикуем. Как только оценщик будет откалиброван по накопленному расходу, в этом поле появится число.

Streaming

Передайте stream: true и читайте SSE до штатного финального события. Не повторяйте запрос автоматически после первого содержательного SSE-фрагмента: fallback после начала ответа запрещён.

Tool calls

Для моделей, в чьих публичных возможностях есть tool, передайте tools и tool_choice в формате выбранного протокола. Описание инструмента включает имя, назначение и JSON Schema аргументов. Сам инструмент выполняется вашим приложением; модель только запрашивает его вызов.

Изображения и опубликованные возможности

Для распознавания изображений выбирайте текстовую модель, у которой modalities.input в GET /v1/models содержит image. У каждой text-only модели каталог публикует vision_companion — ближайшую доступную мультимодальную модель, по возможности того же семейства. Audio, video, PDF и другие неподдерживаемые блоки возвращают 400 unsupported_content_type.

Генерация изображений доступна только если живой каталог содержит endpoint images.generations. Передавайте опубликованные для модели size, quality и допустимое количество результатов. Для media-запроса используйте уникальный Idempotency-Key; повторяйте его только с идентичным телом.

curl https://go2llm.tech/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: project-image-0001" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","prompt":"Minimal API diagram","n":1,"size":"1024x1024","quality":"standard","response_format":"url"}'

img2img работает у моделей, в чьих endpoints есть images.edits. Исходную картинку передавайте файлом, как это делает OpenAI SDK (client.images.edit(image=open("photo.png", "rb"), ...)). До 4 файлов PNG, JPEG или WebP передаются как image[]. Цена за результат та же, что у генерации.

curl https://go2llm.tech/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: project-edit-0001" \
  -F model=MODEL_ID_FROM_CATALOG \
  -F "prompt=Сделай фон белым" \
  -F size=1024x1024 \
  -F image=@photo.png

Непубликованные возможности не являются частью контракта.

Claude Code

В Claude Code годится не любая модель каталога, а только та, у которой в GET /v1/models в списке endpoints есть messages. Модель из каталога без него вернёт 400 model_protocol_mismatch. Список печатает однострочник:

curl -s https://go2llm.tech/v1/models \
  | python3 -c 'import json,sys; print(*(m["id"] for m in json.load(sys.stdin)["data"] if "messages" in m.get("endpoints",[])), sep="\n")'

export ANTHROPIC_BASE_URL=https://go2llm.tech
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-opus-4-8
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-5
claude

ANTHROPIC_SMALL_FAST_MODEL Claude Code дёргает сам для служебных задач, и она тоже обязана быть с endpoint messages.

Используйте ANTHROPIC_AUTH_TOKEN: если на машине уже есть личный вход в Claude Code, ANTHROPIC_API_KEY может уступить сохранённому логину, и запрос уйдёт мимо go2llm с 401.

Codex

Актуальные версии Codex CLI (@openai/codex) поддерживают для кастомных провайдеров только wire_api = "responses" — формат OpenAI Responses API. Раньше это и было причиной отказа: маршрута /v1/responses у go2llm не существовало, и Codex получал 404.

Теперь POST /v1/responses опубликован и проверен живым прогоном Codex CLI 0.151.0 2026-09-14: codex exec прочитал файл тестового проекта, исполнил инструменты и внёс правку. Прогон был на модели qwen3-8-flash; интерактивный TUI codex мы не гоняли. Настройка ~/.codex/config.toml и границы проверки — на странице инструментов для кода и на Codex API.

OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://go2llm.tech/v1" });
const response = await client.chat.completions.create({
  model: "MODEL_ID_FROM_CATALOG",
  messages: [{ role: "user", content: "Ответь: OK" }],
});

Anthropic SDK

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ apiKey: "YOUR_API_KEY", baseURL: "https://go2llm.tech" });
const response = await client.messages.create({
  model: "MODEL_ID_FROM_CATALOG",
  max_tokens: 120,
  messages: [{ role: "user", content: "Ответь: OK" }],
});

Python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://go2llm.tech/v1")
response = client.chat.completions.create(
    model="MODEL_ID_FROM_CATALOG",
    messages=[{"role": "user", "content": "Ответь: OK"}],
)

JavaScript и TypeScript

Используйте OpenAI SDK для chat.completions и Anthropic SDK для messages. Передавайте точный model ID из каталога, задавайте разумный max_tokens и обрабатывайте HTTP-код до чтения тела ответа. Серверный ключ — YOUR_API_KEY; не включайте его в браузерный bundle.

Этот запрет исполним, а не только написан: Access-Control-Allow-Origin: * стоит ровно на публичном чтении — GET /v1/models, GET /v1/models/{id}, GET /api/pricing, GET /status. На маршрутах, которые берут ключ, CORS нет намеренно, и OPTIONS к ним отвечает 405 с объяснением: вызывайте go2llm со своего сервера. Каталог и цены из браузера читать можно — например, чтобы собрать селектор моделей.

cURL

Примеры cURL приведены в quickstart и разделах endpoints. Для диагностики добавьте -i, чтобы увидеть HTTP-код и Retry-After, но не публикуйте команду с реальным ключом.

Другие клиенты

Другой клиент можно использовать только после проверки, что он позволяет задать base URL, передаёт нужный заголовок, вызывает опубликованный endpoint и корректно читает обычный или SSE-ответ. Непроверенные клиенты не заявляются совместимыми.

Баланс и биллинг

go2llm работает только по pay-as-you-go без подписки. Баланс и цены ведутся в USD. Баланс можно самостоятельно пополнить в кабинете по СБП или криптовалютой; зачисление происходит после подтверждения платежа. API резервирует оценочную стоимость до внешнего запроса, затем списывает фактическое использование и освобождает остаток. Сумма списания возвращается в usage.cost_usd обычного ответа или финального usage-блока SSE. Подробности: цены и биллинг.

Бюджет по ключу: GET /v1/me

Чтобы агент не узнавал о пустом балансе из 402 посреди длинного прогона, остаток и квоту можно прочитать тем же ключом:

curl https://go2llm.tech/v1/me -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "api_key",
  "key": { "name": "prod", "masked": "gk_sk_abcd…wxyz", "quota_usd": 50,
           "spent_usd": 12.34, "rpm_limit": 20, "allowed_models": ["*"],
           "expires_at": null },
  "balance": { "spendable_usd": 87.66, "reserved_usd": 0.12, "currency": "USD" },
  "limits": { "account_max_concurrency": 2 }
}

Сравнивайте с оценкой предстоящей работы именно spendable_usd: reserved_usd — это деньги, уже удержанные под выполняющиеся запросы, тратить их нельзя. expires_at приходит строкой ISO-8601 или null. Ключ без привязанного аккаунта отдаёт "balance": null — его расход ограничен только квотой.

Маршрут не отдаёт email, другие ключи аккаунта, реферальные и платёжные данные и полный секрет ключа: утёкший ключ не должен превращаться в опознание владельца и в доступ к остальным его ключам. Лимит — 60 RPM на ключ, ответ идёт с cache-control: no-store. Подробнее: Баланс и расходы.

Rate limits

Лимит по умолчанию — 20 RPM на каждый ключ независимо. При превышении API возвращает HTTP 429 и Retry-After. Учитывайте этот заголовок и используйте ограниченный exponential backoff.

Ошибки

Ошибки под /v1/ приходят JSON-конвертом с error.type, error.code, error.message и error.request_id. Заголовок x-go2llm-request-id есть на всех ответах /v1/*, включая ошибочные — логируйте его. Полный разбор: Ошибки API.

Fallback-поведение

До начала ответа сервис может автоматически повторить запрос при временной сетевой ошибке, timeout, 429 или 5xx. На клиентском 400 повтор не выполняется. После первого байта или валидного SSE-события автоматический повтор отключается, чтобы не смешивать и не дублировать ответ.

FAQ

Где брать model ID? Только из GET /v1/models или динамической таблицы выше.

Хранятся ли промпты и ответы? Нет, они не сохраняются в продуктовых логах. Для выполнения запроса они передаются выбранному внешнему AI-провайдеру.

Можно ли использовать один ключ для разных моделей? Да, если эти модели разрешены настройками ключа.

Есть ли подписка? Нет, используется USD-баланс pay-as-you-go.

Поддержка

Поддержка разбирает проблемы и ошибки после самостоятельной настройки. Интеграции, SDK, ключи и окружение настраиваются по документации.

Telegram: @go2llm_support. Email: support@go2llm.tech.

Укажите время и часовой пояс, endpoint, HTTP-код, model ID и request_id. Не отправляйте пароль, сессионные cookie, полный API-ключ или платёжные реквизиты.