Выбор API
Для новой LLM-интеграции начинайте с Responses API. Остальные API нужны для отдельных модальностей или совместимости с существующими клиентами.
Сравнение
| API | Назначение | Когда использовать | Результат |
|---|---|---|---|
Responses API | Основной | Новое LLM-приложение: текст, потоковая передача, инструменты, структурированные ответы, мультимодальный ввод | Объект response с типизированным output[] |
Embeddings API | Основной | Поиск, ранжирование, кластеризация и RAG | Массив эмбеддингов |
Audio API | Основной | Синтез, распознавание или перевод речи | Аудио или {text} |
Moderations API | Основной | Классификация безопасности текста и изображений | Результаты модерации |
Images API | Основной | Генерация или редактирование изображений | Результаты генерации |
Chat Completions API | Совместимость | Уже используется формат OpenAI messages[] | Завершение чата |
Messages API | Совместимость | Уже используются блоки содержимого Anthropic или агентские инструменты | Блоки сообщений Anthropic |
Быстрый выбор
- Новые текстовые, мультимодальные и агентские сценарии: Responses API.
- Поиск и RAG: Embeddings API.
- TTS, распознавание и перевод речи: Audio API.
- Проверка безопасности: Moderations API.
- Генерация или редактирование изображений: Images API.
- Существующий OpenAI-клиент с
messages[]: Chat Completions API. - Anthropic-совместимый клиент: Messages API.
Совместимые интерфейсы
Совместимый API нужен, когда сохранение существующего формата клиента важнее перехода на основной интерфейс:
- Chat Completions API сохраняет формат чата OpenAI;
- Messages API сохраняет Anthropic Messages-формат.
Для новой интеграции Responses API обычно проще и даёт больше возможностей.
Точные поля
Схемы запросов, ответов и требования к аутентификации находятся в Справочнике API.