V2 API

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

Короткий справочник по публичному V2 API CloseRouter. Базовый endpoint для inference, кабинета, admin и billing: https://api.closerouter.dev/v1.

Скачать .mdОткрыть API-ключиОткрыть модели

Base URL

https://api.closerouter.dev/v1

Добавляйте путь endpoint после /v1.

Авторизация

Bearer closerouter_...

Подходит тот же API-ключ из кабинета.

Каталог

GET /models

Смотрите доступные модели и поддерживаемые API.

Баланс

GET /credits

Проверка кредитов и уже списанного usage.

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

Создайте ключ в кабинете, сохраните его в переменную окружения и отправьте первый OpenAI-compatible запрос.

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
  }'

Endpoint-ы

Все пути ниже указаны относительно base URL. Перед генерацией лучше получить /models и выбрать модель, у которой есть нужный endpoint.

MethodPathUse
GET/modelsКаталог доступных моделей, цены, modalities, endpoint-ы
GET/models/countКоличество доступных моделей
GET/models/{provider}/{model}/endpointsПараметры и streaming для конкретной модели
GET/providersЛогические публичные провайдеры без upstream-деталей
GET/creditsТекущий баланс и суммарное использование аккаунта
POST/chat/completionsOpenAI-style chat completions, включая stream
POST/responsesOpenAI Responses API для текстовых сценариев
POST/messagesAnthropic-style Messages API
POST/images/generationsГенерация изображений для image-моделей
POST/videos/submitСоздать video task для video-модели
GET/videos/tasks/{task_id}Проверить статус video task и получить outputs

Примеры

Chat Completions

Минимальный OpenAI-compatible запрос.

Chat Completions
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 SDK

Тот же chat endpoint через официальный JS SDK.

OpenAI SDK
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);

Responses API

Текстовый Responses-запрос.

Responses API
curl https://api.closerouter.dev/v1/responses \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "input": "Reply with exactly: ok",
    "max_output_tokens": 16
  }'

Messages API

Anthropic-style формат сообщений.

Messages API
curl https://api.closerouter.dev/v1/messages \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-haiku-4.5",
    "max_tokens": 16,
    "messages": [
      { "role": "user", "content": "Reply with exactly: ok" }
    ]
  }'

Images API

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

Images API
curl https://api.closerouter.dev/v1/images/generations \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gemini-3-pro-image-preview",
    "prompt": "A minimal product photo on a white background",
    "n": 1,
    "size": "1024x1024"
  }'