Image Generations

OpenAI-style image generation endpoint built on the platform task pipeline.

Endpoint

POST /api/v1/images/generations

Example

curl https://your-domain.com/api/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "prompt": "A cinematic robot reading API docs",
    "size": "1024x1024"
  }'

Response

{
  "created": 1710000000,
  "data": [{ "url": null, "b64_json": null }],
  "task_id": "local-task-id",
  "provider_task_id": "provider-task-id",
  "status": "pending",
  "model": "google/nano-banana-pro"
}

Notes

The platform returns task metadata immediately.
Image generation continues through the existing async task pipeline.
Credits are charged using the model registry cost.

On this page