Протокол OpenAI compatible
Подключите совместимый клиент через Base URL /v1.
Основные конечные точки
Здесь перечислены OpenAI compatible endpoint для текста, Responses, изображений, видео-задач, аудио, векторов, модерации и realtime. Параметры видео и порядок опроса описаны отдельно; доступность зависит от модели и группы Key.
Модели и поиск
| Назначение | Метод | Путь |
|---|---|---|
| Список моделей | GET | /v1/models |
Текст и ответы
| Назначение | Метод | Путь |
|---|---|---|
| Текстовые дополнения (устаревший формат) | POST | /v1/completions |
| Chat Completions | POST | /v1/chat/completions |
| Responses | POST | /v1/responses |
| Сжатие Responses | POST | /v1/responses/compact |
Изображения
| Назначение | Метод | Путь |
|---|---|---|
| Генерация изображений | POST | /v1/images/generations |
| Редактирование изображений | POST | /v1/images/edits |
Видео-задачи
| Назначение | Метод | Путь |
|---|---|---|
| Создать видео-задачу | POST | /v1/videos |
| Получить статус видео-задачи | GET | /v1/videos/{task_id} |
| Получить видео | GET | /v1/videos/{task_id}/content |
| Создать видео-задачу (совместимый) | POST | /v1/video/generations |
| Получить статус видео-задачи (совместимый) | GET | /v1/video/generations/{task_id} |
Аудио
| Назначение | Метод | Путь |
|---|---|---|
| Транскрипция аудио | POST | /v1/audio/transcriptions |
| Перевод аудио | POST | /v1/audio/translations |
| Синтез речи | POST | /v1/audio/speech |
Векторы и поиск
| Назначение | Метод | Путь |
|---|---|---|
| Текстовые эмбеддинги | POST | /v1/embeddings |
| Переранжирование документов | POST | /v1/rerank |
Безопасность и realtime
| Назначение | Метод | Путь |
|---|---|---|
| Модерация контента | POST | /v1/moderations |
| Realtime (WebSocket) | GET | /v1/realtime |
Минимальный запрос
Обычно клиент использует Base URL https://api.popgo.site/v1 и Authorization: Bearer YOUR_API_KEY. Замените YOUR_MODEL на ID со страницы моделей и проверьте поддержку нужного endpoint.
curl https://api.popgo.site/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"messages": [
{"role": "user", "content": "Подтвердите подключение"}
]
}'
Проверка
Сначала проверьте модель и протокол минимальным запросом, затем включайте streaming, инструменты и медиа-параметры. При 404 проверьте двойное добавление /v1, при 400 — поддержку endpoint.