Справочник API

Base URL

Выберите адрес под ваш SDK. Оба адреса используют один ключ и один баланс.

Авторизация

Передавайте API-ключ в заголовке каждого запроса. Ключи создаются на странице API Keys в консоли и показываются только один раз — при создании.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Эндпоинты Anthropic принимают заголовок x-api-key, а также Authorization: Bearer.

Управлять API-ключами →

Список эндпоинтов

Все пути находятся под https://nezhagate.com. Синхронные эндпоинты сразу возвращают результат, эндпоинты изображений и видео — id задачи.

Асинхронные задачи (изображения и видео)

Запросы изображений и видео сразу возвращают HTTP 202 и id задачи, а генерация идёт в фоне. Опрашивайте задачу по id или получайте результат вебхуком.

curl https://nezhagate.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "nano-banana-2", "prompt": "a lighthouse at dawn, watercolor", "size": "16:9"}'

# HTTP 202
{"id": "img_3f9a...c2", "object": "image.generation.job", "status": "queued", "model": "nano-banana-2"}

curl https://nezhagate.com/v1/images/jobs/img_3f9a...c2 -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "img_3f9a...c2",
  "object": "image.generation.job",
  "status": "succeeded",
  "created": 1791199400,
  "model": "nano-banana-2",
  "data": [{"url": "https://img.nezhagate.com/i/9f86d081a8....png"}],
  "usage": {"images": 1, "resolution": "1K", "model": "nano-banana-2"}
}

• Опрашивайте изображения каждые 2–3 секунды, видео — каждые 5–10 секунд. Опрос бесплатный.
• data[0].url — ссылка на нашем медиахостинге; файл хранится 60 дней и затем удаляется. Скачайте то, что нужно сохранить.
• Добавьте callback_url при отправке — когда задача завершится, тот же результат, что и при опросе, придёт на этот адрес. Документация по вебхукам →

Список моделей

Возвращает все ID моделей в продаже в формате OpenAI. Снятых с продажи моделей в списке нет; модель со статусом «скоро» в списке есть, но до открытия отвечает 400 model_coming_soon.

curl https://nezhagate.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"

{"object": "list", "data": [{"id": "gpt-5.5", "object": "model", "owned_by": "..."}, {"id": "claude-sonnet-5", "object": "model", "owned_by": "..."}]}

Баланс и расход

Любой API-ключ может узнать баланс и расход аккаунта — входить в консоль не нужно.

curl https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"

{
  "object": "usage",
  "balance": {"usd": 12.5, "credits": 2500},
  "total": {"cost_usd": 37.5, "requests": 1840, "billed_requests": 1822, "failed_requests": 18},
  "today": {"cost_usd": 1.2, "requests": 64, "billed_requests": 63, "failed_requests": 1},
  "by_model": [
    {"model": "gpt-5.5", "cost_usd": 20.1, "requests": 900, "billed_requests": 896, "failed_requests": 4,
     "prompt_tokens": 1520000, "completion_tokens": 410000, "image_count": 0}
  ]
}

balance.usd — баланс в долларах, balance.credits — тот же баланс в кредитах (1 доллар = 200 кредитов).

Для готовых инструментов проверки баланса OpenAI используйте эндпоинт в стиле OpenAI; баланс в поле total_available.

curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"

Формат ошибок

У всех ошибок одинаковая структура. code — стабильный машиночитаемый идентификатор: ориентируйтесь на code, а не на текст message.

{
  "error": {
    "message": "Model not enabled: gpt-9",
    "type": "invalid_request_error",
    "code": "model_not_found",
    "param": "model"
  }
}

Полный список кодов ошибок →

Лимиты и повторы

• По умолчанию у аккаунта нет ограничения на частоту запросов. В консоли для каждого ключа можно задать лимит запросов в минуту, дневной бюджет, общий лимит расходов, список разрешённых моделей и список разрешённых IP.
• Получив 429, подождите столько, сколько указано в заголовке Retry-After, и повторите. При 502, 503 и таймаутах повторяйте с экспоненциальной задержкой (например, 1, 2, затем 4 секунды).
• Неудачные запросы не оплачиваются. Если поток оборвался на середине, вы платите только за то, что успело прийти.
• Если нужна стабильно высокая параллельность, предупредите нас заранее — мы расширим мощности под ваш объём.

SDK и примеры

Отдельный SDK не нужен: официальные SDK OpenAI и Anthropic работают, если поменять base_url.

from openai import OpenAI

client = OpenAI(base_url="https://nezhagate.com/v1", api_key="YOUR_API_KEY")
resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Hello"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nezhagate.com/v1", apiKey: "YOUR_API_KEY" });
const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

import anthropic

client = anthropic.Anthropic(base_url="https://nezhagate.com/anthropic", api_key="YOUR_API_KEY")
msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

Больше готовых примеров (Python, Node.js, curl, включая асинхронный сценарий для изображений и видео): github.com/gaoorange/nezhagate-api-examples

Документация по моделям

У каждой модели своя страница: допустимые значения параметров, примеры кода, формат ответа и порядок оплаты.

Чат-модели

• DeepSeek V4.1 Flash
• DeepSeek V4 Flash 0731
• GLM-5.3
• GLM-5.3 Flash
• Kimi K3
• Qwen3.7 Max
• Qwen3.8 Max
• Qwen3.8 Max 0902
• Qwen3.8 Flash
• GPT-5.6 Sol
• GPT-5.6 Terra
• GPT-5.6 Luna
• GPT-5.5
• GPT-6 Astra
• GPT-6.1 Sol
• GPT-6 Sol
• GPT-6 Luna
• Claude Sonnet 4.6
• Claude Opus 5
• Claude Fable 5
• Claude Sonnet 5
• Claude Opus 5.5
• Claude Sonnet 5.5
• Gemini 3.1 Pro
• Gemini 3.8 Flash
• Gemini 3.7 Flash
• Gemini 3.6 Flash
• Gemini 3.6 Flash High
• Gemini 3.6 Flash Low
• Gemini 3.6 Flash Tiered
• Gemini 3 Flash
• Gemini 2.5 Flash
• Doubao Seed 2.1 Pro
• Doubao Seed 2.1 Turbo
• Grok 4.7

Модели изображений

• GPT Image 2
• GPT Image 2.5 Flare
• GPT Image 2.5 Sunburst
• Nano Banana 2
• Nano Banana Pro
• Grok Imagine Image
• Grok Imagine Image Quality

Видеомодели

• Veo 3.1
• Gemini Omni Flash
• Seedance 2.5
• Seedance 2.0
• Seedance 2.0 Fast
• Seedance 2.0 · Clip
• Seedance 2.5 · 30s
• Wan 3.0
• Wan 3.0 Prime
• MiniMax H3
• Grok Imagine Video 1.5