Скилл: форматы 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. Не строй продолжение диалога на этом предположении
Подробности: форматы API, Responses