Техническое руководство
GPT API и OpenAI‑compatible API
GPT API обычно означает программный вызов GPT‑моделей OpenAI. OpenAI‑compatible API означает схожий формат запроса и не гарантирует, что за ним стоит модель OpenAI. Mocoore явно разделяет эти понятия.
GPT API, ChatGPT API и совместимый API — в чём разница?
GPT API — распространённое поисковое название API моделей GPT. Фраза «ChatGPT API» тоже часто используется, хотя ChatGPT — это готовое приложение, а API‑платформа имеет свои модели, маршруты, ключи и биллинг.
OpenAI‑compatible API — это техническая совместимость с частью схемы OpenAI. Она может упростить замену base URL, но не означает полную идентичность. Могут отличаться список моделей, tool calls, потоковые события, ошибки, usage‑поля и лимиты. Mocoore не является OpenAI или ChatGPT и не заявляет официальную связь.
Chat Completions и Responses API
Многие готовые SDK и скрипты ожидают маршрут /v1/chat/completions с массивом messages. Новые прямые интеграции OpenAI также используют Responses API. При выборе шлюза нужно проверять не слово «compatible», а каждый нужный маршрут и поле.
curl https://api.mocoore.win/v1/chat/completions \
-H "Authorization: Bearer $MOCOORE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "available-model",
"messages": [{"role": "user", "content": "Привет"}],
"stream": true
}'Пример показывает схему, а не обещает конкретную GPT‑модель. Значение available-model заменяется на имя из фактического списка, выданного аккаунту.
Как проверить миграцию на другой base URL?
Замена адреса и ключа — только первый шаг. Вначале следует снять набор тестов на исходном API: обычный ответ, streaming, tool call, длинный контекст, ошибка авторизации, ошибка лимита и timeout. После замены тот же набор запускается повторно.
- Сравнить HTTP‑коды и форму ошибок.
- Проверить порядок SSE‑событий и завершение потока.
- Убедиться, что usage и finish reason читаются клиентом.
- Проверить JSON Schema для tools и structured output.
- Начать с малой квоты и тестового проекта.
Для критичного продакшена нужен также план отката. Переводить весь трафик до сравнительного теста не стоит.
Как понять, какая GPT‑модель доступна?
Название в рекламе не является техническим доказательством. Перед оплатой Mocoore должен показать модель в списке для конкретного аккаунта и подтвердить тариф, контекст, RPM/TPM, максимум выхода и нужные функции. Если модель не подтверждена, мы не должны описывать её как доступную.
Совместимый интерфейс может маршрутизировать и другие AI‑модели. Это полезно для единого SDK, но качество, поведение и цена будут зависеть от фактической модели.
Как выбрать GPT‑модель для продукта?
Выбор начинается не с названия, а с набора задач. Соберите 30–50 типичных примеров и заранее определите критерии: точность, формат JSON, следование инструкции, правильность tool call, задержка и цена. Одинаковый prompt и одинаковые параметры запускаются на всех кандидатах.
Лучшая модель для демо может оказаться не лучшей для серийной обработки. Отдельно измеряйте первый токен, полное время, частоту 429/5xx, число повторов и стоимость успешной задачи. Результат пилота сохраняйте с датой и версией, чтобы повторить оценку после обновления.
Надёжность, ключи и данные
Каждому проекту нужен свой ключ, срок действия и квота. Ключ хранится на сервере или в secret manager, а не в browser JavaScript, мобильном бинарном коде или Git. В журналах нужно искать аномалии, а при утечке сразу отзывать ключ.
Запрос через шлюз проходит через Mocoore и внешнего поставщика. Не следует передавать пароли, платёжные данные, закрытый код или личную информацию без явного правового и договорного основания.
Частые вопросы о GPT API
Подписка ChatGPT включает API?
Обычно подписка на потребительское приложение и API‑биллинг не являются одним и тем же. Это нужно сверять с текущими условиями OpenAI. В Mocoore оплата и ключ также оформляются отдельно.
Как проверить, что это именно GPT?
Запросите точное имя модели, её поставщика и описание маршрута. Одинаковая схема Chat Completions не доказывает происхождение модели. Если поставщик не подтверждён, следует считать такой маршрут просто совместимым API.
Поддерживается ли Responses API?
Это нужно проверять на конкретном маршруте. Поддержка Chat Completions не означает автоматическую поддержку Responses, всех его tools и событий.
От чего зависит цена?
От фактической модели, числа входных и выходных токенов, caching, tools и условий маршрута. Цену нужно получить письменно до запуска, а расход контролировать квотами.
Источники и проверка актуальности
Схемы прямого OpenAI API и поведение Responses API нужно проверять по официальной API‑документации OpenAI. Для любого независимого шлюза отдельно сверяются реально поддерживаемые маршруты. Эта страница не заменяет документацию поставщика.
Дата обновления указана вверху. При изменении API мы должны повторно проверить маршруты, поля, streaming и tool calls, а затем обновить материал.