Stable, asynchronous, and decoupled from execution nodes.

Quick start

Create an API key in the console, submit a job, then use the returned job_id to look it up. Only successful jobs are charged to the account balance.

curl https://gateway.example.com/v1/images/generations \
  -H "Authorization: Bearer sk-gw-your-key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: product-asset-2026-001" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Minimal product photo, soft daylight",
    "image_urls": [],
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }'

Authentication

Every v1 endpoint uses a Bearer key.

Authorization: Bearer sk-gw-...

Create image job

Response

{
  "object": "generation.job",
  "job_id": "job_...",
  "model": "gpt-image-2",
  "status": "running",
  "artifacts": [],
  "error": null,
  "price": {
    "amount_micros": 50000,
    "amount": "0.050000",
    "currency": "usd"
  }
}

Create video job

Video models share one async endpoint. Omni Flash accepts image_urls and reference_video_urls through one Gateway contract; ZexAPI and KIE map them to their own upstream fields, with at most 7 total references.

curl https://gateway.example.com/v1/videos/generations \
  -H "Authorization: Bearer sk-gw-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-v1",
    "prompt": "Create a bright product video from the references",
    "image_urls": ["https://cdn.example.com/product.png"],
    "reference_video_urls": ["https://cdn.example.com/demo.mp4"],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 10
  }'

Create audio job

Audio models use the same asynchronous job lifecycle. The selected model controls all accepted fields.

curl https://gateway.example.com/v1/audio/generations
  -H "Authorization: Bearer sk-gw-your-key"
  -H "Content-Type: application/json"
  -d '{
    "model": "sunoai",
    "generation_mode": "custom",
    "title": "Late Summer Road",
    "style": "Warm acoustic folk, intimate vocal, gentle strings",
    "lyrics": "[Verse 1]\nWe drove until the sunset...",
    "model_version": "V5_5",
    "include_timed_lyrics": true
  }'

Create completion

Completions remain synchronous by default and return an OpenAI-compatible result in the same request. text-generation-v1, palm-reading-v1, and fortune-reading-v1 can opt into async job polling; async images must use publicly reachable HTTP(S) URLs, and streaming is not supported.

curl https://gateway.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-gw-your-key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: prompt-copy-2026-001" \
  -d '{
    "model": "openai/gpt-5.6-luna",
    "messages": [
      { "role": "user", "content": "Return a JSON object with three concise product tagline options." }
    ],
    "max_tokens": 512,
    "response_format": { "type": "json_object" },
    "reasoning_effort": "medium"
  }'

Async + vision

curl https://gateway.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-gw-your-key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: async-vision-2026-001" \
  -d '{
    "model": "openai/gpt-5.6-luna",
    "async": true,
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "Analyze this image and return JSON." },
        { "type": "image_url", "image_url": { "url": "https://cdn.example.com/input.jpg" } }
      ]
    }],
    "max_completion_tokens": 12000,
    "response_format": { "type": "json_object" },
    "reasoning_effort": "high"
  }'

Query job

The public status is limited to queued, running, succeeded, and failed. After success, artifacts contains image, video, or audio URLs, and completion contains text or vision completion results; polling stops at a terminal state.

curl https://gateway.example.com/v1/jobs/job_... \
  -H "Authorization: Bearer sk-gw-your-key"

Models

Returns active logical models, capabilities, and minimum–maximum price ranges without exposing their execution-node mapping. Successful jobs settle at the price of the route actually used.

Error codes