Скилл: форматы API
Выбор запроса и правильного обработчика ответа
Маршруты
| Формат | Метод и путь | Текст ответа |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | choices[].message.content |
| Messages | POST /v1/messages | Текстовые блоки content |
| GenerateContent | POST /v1beta/models/{model}:generateContent | candidates[].content.parts[].text |
| Responses | POST /v1/responses | Зависит от совместимости модели |
У OpenAI SDK base URL заканчивается на /v1, у Anthropic SDK используется корень https://api.getapi.ru
Обработка
Не выбирай формат только по названию модели. Сохраняй схему существующего клиента, если модель её поддерживает
В Messages системная инструкция передаётся полем system, в GenerateContent полем systemInstruction
Собирай все текстовые блоки и отдельно обрабатывай инструменты, reasoning и причины завершения
Responses
Не предполагай, что любая модель вернёт object: response. Возможен ответ Chat Completions
ID с префиксом resp_ не доказывает хранение состояния или поддержку previous_response_id. Не строй продолжение диалога на этом предположении
У gpt-4.1-mini запрос store: true отклоняется с 400 store: true is not supported on this proxy, передавай store: false и сохраняй историю в приложении
У этой же модели previous_response_id отклоняется с 400 previous_response_id is not supported on this proxy
Подробности: форматы API, Responses
Аудио
Transcriptions через OpenRouter принимают json и verbose_json, значения text, srt и vtt отклоняются. Массив временных меток передавай отдельными полями timestamp_granularities[]=word и timestamp_granularities[]=segment
Для eleven-v3 используй mp3 или pcm, скорость от 0.7 до 1.2 включительно. Сырой PCM сохраняй с учётом частоты и каналов из Content-Type
Примеры: распознавание, синтез речи