Referencia de la API

URL base

Elige la que corresponda a tu SDK. Las dos comparten clave y saldo.

Autenticación

Envía tu clave de API en una cabecera en cada petición. Las claves se crean en la página API Keys de la consola y solo se muestran una vez, al crearlas.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Los endpoints de Anthropic usan la cabecera x-api-key y también aceptan Authorization: Bearer.

Gestionar claves de API →

Endpoints

Todas las rutas cuelgan de https://nezhagate.com. Los endpoints síncronos devuelven el resultado; los de imagen y vídeo devuelven un id de trabajo.

Trabajos asíncronos (imagen y vídeo)

Las llamadas de imagen y vídeo devuelven al momento HTTP 202 y un id de trabajo; la generación sigue en segundo plano. Consulta el estado con ese id, o recibe el resultado por webhook.

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

• Consulta las imágenes cada 2–3 segundos y los vídeos cada 5–10 segundos. Las consultas son gratis.
• data[0].url es un enlace de nuestro alojamiento de medios que se guarda 60 días y luego se borra; descarga lo que quieras conservar.
• Añade callback_url al enviar y, cuando termine el trabajo, el mismo resultado que da la consulta llegará a esa URL. Documentación de webhooks →

Lista de modelos

Devuelve todos los ID de modelo a la venta, con el formato de OpenAI. Los modelos retirados no aparecen; un modelo que llega pronto sí aparece, pero responde 400 model_coming_soon hasta que se abra.

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": "..."}]}

Saldo y consumo

Cualquier clave de API puede leer el saldo y el gasto de la cuenta, sin entrar en la consola.

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 es el saldo en dólares y balance.credits el mismo saldo en créditos (1 USD = 200 créditos).

Para herramientas que ya saben consultar un saldo de OpenAI, usa el endpoint al estilo de OpenAI; el saldo es total_available.

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

Formato de error

Todos los errores tienen la misma forma. code es un identificador estable y legible por máquina: decide según code, nunca según el texto de message.

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

Lista completa de códigos de error →

Límites y reintentos

• Las cuentas no tienen un límite de peticiones por defecto. En la consola puedes dar a cada clave su propio tope de peticiones por minuto, presupuesto diario, límite de gasto total, lista de modelos permitidos y lista de IP permitidas.
• Ante un 429, espera lo que indique la cabecera Retry-After y reintenta. Para 502, 503 y tiempos de espera agotados, reintenta con espera exponencial (por ejemplo 1, 2 y luego 4 segundos).
• Las peticiones fallidas nunca se cobran. Si un streaming se corta a medias, solo pagas lo que llegó.
• Si necesitas alta concurrencia de forma sostenida, avísanos con antelación y ampliaremos la capacidad para tu volumen.

SDK y ejemplos

No hace falta un SDK propio: los SDK oficiales de OpenAI y Anthropic funcionan cambiando 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)

Más ejemplos listos para ejecutar (Python, Node.js, curl, incluido el flujo asíncrono de imagen y vídeo): github.com/gaoorange/nezhagate-api-examples

Documentación de cada modelo

Cada modelo tiene su propia página: valores admitidos de los parámetros, código de ejemplo, formato de respuesta y forma de cobro.

Modelos de chat

• 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
• 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
• Doubao Seed 2.1 Pro
• Doubao Seed 2.1 Turbo
• Grok 4.7

Modelos de imagen

• 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

Modelos de vídeo

• 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