CloseRouter API

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

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

Скачать .mdAPI-ключиМодели
Base URL
https://api.closerouter.dev/v1
Авторизация
Authorization: Bearer closerouter_...
Каталог
GET /models

Images API

Генерация и редактирование изображений для моделей с image endpoint-ами.

GPT Image generation

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

Gemini image generation

curl
curl https://api.closerouter.dev/v1/chat/completions \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3-pro-image",
    "messages": [
      { "role": "user", "content": "A minimal product photo on a white background" }
    ],
    "modalities": ["image", "text"],
    "image_config": {
      "aspect_ratio": "1:1",
      "image_size": "4K"
    }
  }'

Image edits

multipart/form-data
curl https://api.closerouter.dev/v1/images/edits \
  -H "Authorization: Bearer $CLOSEROUTER_API_KEY" \
  -F "model=openai/gpt-image-2-edit" \
  -F "image[]=@input.png" \
  -F "prompt=Replace the background with a clean studio backdrop"

Форматы ввода

  • GPT Image использует /images/generations; quality выбирает качество, а size задаёт размеры изображения.
  • Gemini image использует /chat/completions; размер задаётся через image_config.image_size (1K, 2K или 4K, если модель поддерживает).
  • google/gemini-3.1-flash-lite-image поддерживает только 1K.
  • Для edits используйте multipart image[] uploads или JSON images как inline data: URL.
  • Внешние media URL в inference inputs отклоняются; отправляйте файлы как data URL или multipart upload.