Ключі OpenRouter ai: Посібник для початківців

Базова URL-адреса та аутентифікація

Ваш API-ключ автентифікує кожен запит до нашого ендпоінту. Використовуйте базовий URL https://api.openrouteraikeys.com/v1 і передайте свій ключ у Authorization header. Ця конфігурація працює з будь-яким SDK, сумісним з OpenAI, оскільки ми відтворюємо їхній стандартний шаблон автентифікації. Вам не потрібно змінювати бібліотеку клієнта, лише конфігурацію базової URL-адреси.

• Заголовок: Authorization: Bearer YOUR_API_KEY
• Базовий URL: https://api.openrouteraikeys.com/v1

Перший запит

Надішліть стандартний запит chat completion для тестування з’єднання та формату відповіді. Ідентифікатор моделі — uncensored і приймає стандартні масиви повідомлень. Цей ендпоінт повертає лише текст, тому не очікуйте зображень чи аудіо у відповіді.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Інтеграція SDK Python

Ініціалізуйте клієнта, вказавши свій ключ та кастомний базовий URL. Це дозволяє використовувати знайомий chat.completions.create метод без обгортання додаткової логіки. Бібліотека автоматично обробляє серіалізацію та логіку повторних спроб.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Інтеграція Node SDK

Налаштуйте OPENAI_API_KEY та OPENAI_BASE_URL environment variables or pass them directly to the client constructor. Це гарантує, що всі подальші виклики маршрутизуються через наш нецензерований endpoint. Ви можете продовжувати використовувати ту саму версію SDK, яку вже встановили.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraikeys.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потокові відповіді

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає чанки Server-Sent Events (SSE) по мірі генерації тексту моделлю. Статистика використання токенів з'являється у фінальному чанку потоку, дозволяючи відстежувати витрати в реальному часі, не чекаючи повної відповіді.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Ліміти, помилки & контекст

Вікно контексту підтримує загальну кількість 100 000 токенів для запиту та відповіді. Ліміт становить 300 запитів на хвилину на один ключ. Помилка 401 означає, що ваш API-ключ недійсний або відсутній. Помилка 402 вказує на недостатній попередньо оплачений баланс. Помилка 429 сигналізує про перевищення ліміту швидкості. Відмови через політику контенту є безкоштовними, але помилки обчислень можуть споживати токени.