Первый запрос

Это руководство шаг за шагом проведёт вас через первый вызов API с нуля. Перед началом убедитесь, что:

1. Вы создали API-ключ и сохранили полный ключ.
2. У вас есть Base URL: войдите в консоль, откройте диалог «Быстрый старт», выберите протокол и скопируйте его. В примерах ниже https://<your-base-url> используется как заполнитель — замените его на свой.

Платформа поддерживает три нативных протокола; выберите тот, что вам подходит, — тарификация и баланс одинаковы для всех них.

Протокол, совместимый с OpenAI (рекомендуется по умолчанию)

Полностью совместим с SDK OpenAI: укажите base_url на платформу, и ваш существующий код продолжит работать.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (SDK openai)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (SDK openai)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Протокол Anthropic

Изоморфен Anthropic Messages API: аутентификация через x-api-key и заголовок anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Протокол Gemini

Изоморфен Google GenAI API: ID модели помещается в путь, а аутентификация использует x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Проверка результата

Успешный запрос возвращает ответ модели (для протокола OpenAI он находится в choices[0].message.content). Далее вы можете:

• Проверить использование и изменение баланса на странице «Использование» в консоли;
• Заменить your-model на реальный ID модели из каталога моделей (поддерживаются модальности текст, изображение, аудио, видео и файл).

Частые ошибки при первом вызове

Советы для продакшена: храните ключ в переменной окружения (например, OPENAI_API_KEY), а не жёстко прописывайте его в коде, и предпочитайте официальный SDK вызовам HTTP, написанным вручную, — SDK берёт на себя детали совместимости протоколов.