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

В этом руководстве вы отправите базовый запрос к OpenAI-совместимому эндпоинту Chat Completions.

Предварительные требования

  • Ключ API GetRouter
  • Идентификатор совместимой модели со страницы Models

Задайте переменные окружения для примеров:

export GETROUTER_API_KEY="YOUR_API_KEY"
export GETROUTER_MODEL="MODEL_ID"

cURL

curl https://getrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $GETROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$GETROUTER_MODEL"'",
    "messages": [
      {"role": "user", "content": "Напиши одно предложение о надёжных API."}
    ]
  }'

Сгенерированный текст возвращается в:

choices[0].message.content

Python

Установите OpenAI SDK:

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GETROUTER_API_KEY"],
    base_url="https://getrouter.ai/v1",
)

response = client.chat.completions.create(
    model=os.environ["GETROUTER_MODEL"],
    messages=[
        {"role": "user", "content": "Напиши одно предложение о надёжных API."}
    ],
)

print(response.choices[0].message.content)

Node.js / TypeScript

Установите OpenAI SDK:

bun add openai
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.GETROUTER_API_KEY,
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.chat.completions.create({
  model: process.env.GETROUTER_MODEL!,
  messages: [
    { role: 'user', content: 'Напиши одно предложение о надёжных API.' },
  ],
})

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

Распространённые ошибки первого запроса

ОшибкаЧто проверить
401Ключ API указан полностью, активен и отправляется как Bearer YOUR_API_KEY
404Базовый URL не дублируется, а клиент обращается к /chat/completions
Модель не найденаИспользуйте точный идентификатор модели со страницы Models
Недостаточно средств или квотыПроверьте баланс учётной записи и лимит использования ключа API
Операция не поддерживаетсяВыберите модель, совместимую с Chat Completions

Дальнейшие действия