Руководство по интеграции
Текстовые модели здесь говорят на протоколах, которые ваш SDK уже знает: Chat Completions, бессостоятельное подмножество Responses, Anthropic Messages и Google generateContent. Интересно другое: что происходит с параметром, которого целевая модель никогда не объявляла.
Задача
Классический сбой — не 500. Это параметр, который шлюз принял, выбросил и ни словом не упомянул: модель отработала без вашей temperature, без описаний инструментов и без формата ответа, а результат выглядел просто слабым, а не сломанным.
01
messages, tools, tool_choice, response_format, max_tokens, temperature и top_p ложатся на объявленные поля модели. Всё остальное передаётся в её схему и возвращает 400, если модель этого не объявляет. Молчание никогда не бывает ответом.
02
На /v1 тело — это объект ошибки OpenAI или Anthropic, а не конверт {code, msg, data, request_id} из /api/v1. Если продукт использует обе поверхности, обрабатывайте обе формы.
03
stream: true возвращает события chat.completion.chunk, завершённые data: [DONE]. Тарификация по-прежнему идёт по измеренному потреблению, поэтому прерванный поток не становится бесплатным запросом.
Подход
Измените base_url и api_key, замените строку модели значением из GET /v1/models и запустите уже имеющийся набор тестов. Если параметр вернул 400, выбранная модель никогда его не поддерживала — этой информации «тихий» вариант не давал.
Подойдёт любой OpenAI-совместимый клиент. Меняются только базовый адрес и значение model.
POST /v1/chat/completions
from openai import OpenAI
client = OpenAI(
base_url="https://api.spicyapi.ai/v1",
api_key=os.environ["SPICY_API_KEY"],
)
stream = client.chat.completions.create(
model="<publisher>/<model>/chat", # exact value from GET /v1/models
messages=[{"role": "user", "content": "Summarise these notes in three bullets."}],
temperature=0.7,
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")text/event-stream
data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"- "}}]}
data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"Ships"}}]}
data: [DONE]Контракт
| Поле или заголовок | Значение или предел |
|---|---|
| POST /v1/chat/completions | chat.completion · SSE with stream: true |
| GET /v1/models | every callable model value |
| Authorization: Bearer · x-api-key · x-goog-api-key | accepted on /v1 |
| undeclared parameter | 400 · never silently dropped |
Проведите по горизонтали, чтобы увидеть все столбцы.
Интеграция
Применимость
Проверки
/v1/chat/completions, /v1/responses, /v1/messages и /v1beta/models/{model}:generateContent аутентифицируются одним ключом. Authorization: Bearer, x-api-key и x-goog-api-key принимаются там, где их ожидает SDK.
GET /v1/models возвращает ровно те идентификаторы, которые принимает любая операция /v1 и /api/v1, а разработчик указан в owned_by. Цены приходят из /api/v1/models: они зависят от аккаунта и потому не публичны.
Слой совместимости использует ту же аутентификацию, те же ограничения частоты, ту же проверку ввода, тот же расчёт цены и тот же резерв, что и нативная поверхность. Отличается только конверт.
Перед запуском
Частые вопросы
Модели
Каждая ссылка ведёт на страницу семейства моделей: входные данные, ограничения, контентная политика и текущая цена за единицу.
Дальше
Направьте существующий клиент OpenAI, Anthropic или Google на SpicyAPI. Что проходит как есть, что отклоняется намеренно и как тарифицируется текст.
