CloseRouter API

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

Короткая документация по публичному inference API: модели, запросы, ключи, баланс и ошибки.

Base URL
https://api.closerouter.dev/v1
Авторизация
Authorization: Bearer closerouter_...
Каталог
GET /models

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

Создайте ключ в кабинете, сохраните его на backend/server-side стороне и отправьте первый OpenAI-compatible запрос.

Минимум для интеграции

  • Используйте base URL https://api.closerouter.dev/v1.
  • Передавайте ключ через Authorization: Bearer <closerouter_...> или x-api-key.
  • Для POST-запросов отправляйте Content-Type: application/json.
  • Не вставляйте API-ключи во frontend-код, публичные репозитории, логи и скриншоты.

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

curl
export CLOSEROUTER_API_KEY="closerouter_your_key"

curl https://api.closerouter.dev/v1/chat/completions \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "Reply with exactly: ok" }
    ],
    "max_tokens": 16
  }'

OpenAI JavaScript SDK

TypeScript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.CLOSEROUTER_API_KEY,
  baseURL: 'https://api.closerouter.dev/v1',
});

const completion = await client.chat.completions.create({
  model: 'openai/gpt-5.4-mini',
  messages: [{ role: 'user', content: 'Reply with exactly: ok' }],
  max_tokens: 16,
});

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

Основные endpoint-ы

GET /models

Каталог моделей, цены, modalities и поддерживаемые endpoint-ы.

GET /models/count

Количество доступных моделей.

GET /models/{provider}/{model}/endpoints

Параметры и streaming для одной модели.

GET /providers

Модели и доступные provider options для каждой.

PATCH /providers

Сохранить provider по умолчанию для модели.

GET /credits

Текущий баланс и суммарное использование аккаунта.

POST /chat/completions

OpenAI-style Chat Completions.

POST /responses

OpenAI Responses API.

POST /messages

Anthropic-style Messages API.

POST /images/generations

Генерация изображений.

POST /images/edits

Редактирование изображений.

POST /videos/submit

Создать video task.

GET /videos/tasks/{task_id}

Проверить статус video task.

POST /keys

Создать API-ключ аккаунта.

GET /keys

Список активных ключей аккаунта.

PATCH /keys/{key_id}/limit

Задать или очистить spend limit.

DELETE /keys/{key_id}

Отозвать ключ аккаунта.