Generate images
Triggers an asynchronous image generation job. The response returns a jobId; poll GET /jobs/{id} for status and outputs.
Authorization
BearerAuth Developer API key. Send as Authorization: Bearer <api_key>.
In: header
Request Body
application/json
Image generation request. Choose the schema matching modelID.
TypeScript Definitions
Use the request body type in TypeScript.
Generate images with nanobanana, nanobanana-pro, or nanobanana-2.
Generate images with nanobanana, nanobanana-pro, or nanobanana-2.
Options for this model family. Send only the option group matching modelID.
At least one of prompt or preset is required. You may provide both.
At least one of prompt or preset is required. You may provide both.
Reference image limits: nanobanana 3; nanobanana-pro/nanobanana-2 14; seedream/seedream-4_5/seedream-5-lite/gpt-image-2 10.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/images/generation" \ -H "Content-Type: application/json" \ -d '{ "aspectRatio": "1:1", "modelID": "nanobanana", "numImages": 1, "options": { "gemini": { "imageSize": "1K", "safetyFilterLevel": "OFF", "sequentialMode": "disabled" } }, "preset": "editorial", "prompt": "Editorial portrait in warm window light", "referenceImageURLs": [] }'{ "result": { "jobId": "job_123", "status": "queued" }, "status": "OK"}{ "err": "string", "message": "string", "result": null, "status": "NOK"}{ "err": "string", "message": "string", "result": null, "status": "NOK"}{ "err": "string", "message": "string", "result": null, "status": "NOK"}{ "err": "string", "message": "string", "result": null, "status": "NOK"}