Roko API
Консоль

Документация

Совместимость с OpenAI

Обновлено: 2026-07-21

/v1/chat/completions является основным универсальным эндпоинтом. Замените Base URL в официальном OpenAI SDK на https://api.rokoapi.com/v1, чтобы вызывать доступные на платформе модели.

Эта страница описывает «режим совместимости». Если вам нужен нативный протокол OpenAI Responses, см. Responses API.

Зачем использовать режим совместимости

  • Один код для разных моделей: один и тот же SDK позволяет вызывать доступные каналы, такие как DeepSeek, OpenAI и модели для генерации изображений
  • Зрелая экосистема: LangChain, плагины для IDE и прокси-клиенты по умолчанию используют Chat Completions
  • Низкая стоимость миграции: достаточно изменить base_url / baseURL и model

Когда переходить на Responses: если вам явно нужны структурированный outputв Responses, семантические потоковые события или функции, доступные только на этом эндпоинте — см. Responses API.

Быстрый старт

curl https://api.rokoapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "Вы — лаконичный помощник"},
      {"role": "user", "content": "Представьтесь одним предложением"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "Вы — лаконичный помощник"},
        {"role": "user", "content": "Представьтесь одним предложением"},
    ],
)
print(resp.choices[0].message.content)
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.rokoapi.com/v1',
})

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [
    { role: 'system', content: 'Вы — лаконичный помощник' },
    { role: 'user', content: 'Представьтесь одним предложением' },
  ],
})

console.log(resp.choices[0]?.message?.content)

model Параметр model должен содержать реальный ID модели из руководства по доступным моделям; не используйте имена моделей, которые не активированы.

Справочник параметров запроса

ПараметрТипОписание
modelstringОбязательный, ID доступной модели
messagesarrayОбязательный, сообщения диалога
streambooleantrue при значении true возвращает SSE
temperaturenumberТемпература выборки; некоторые модели рассуждений могут не поддерживать этот параметр
max_tokens / max_completion_tokensintМаксимальная длина вывода
tools / tool_choice—Вызов функций; поддержка зависит от модели и канала
response_formatobjectОграничения формата вывода, например JSON

Подробное описание полей см. в Chat Completions.

Структура ответа

При успешном выполнении возвращается стандартный JSON Chat Completion, текст находится в choices[0].message.content. В случае ошибки обычно возвращается error.message(а также необязательные error.type / error.code）.

Потоковый вывод

Установите "stream": true. Подробности о потоковом режиме см. в Потоковые запросы.

Не текстовые возможности, такие как изображения

Для генерации изображений и т. п. используйте соответствующий эндпоинт (например, /v1/images/generations), и замените model на ID модели для изображений. Примеры для разных серий см. в разделе «Доступные модели» в боковой панели. model Замените на ID модели изображения. Примеры для каждой серии см. в разделе «Доступные модели» на боковой панели.

Полезные ссылки