Start an image generation
Generates an image. Same authentication, billing, and error conventions as video generation. Model IDs come from GET /v1/models?type=image.
Async contract: returns 202 with a Location header pointing at the poll URL; poll every ~5 seconds until status is completed or failed. Idempotency: send Idempotency-Key so a retry cannot double-charge. Sandbox: send X-Sandbox: true to rehearse without spending credits.
Request
- Base URL: https://aicontentdrop.com
- URL: https://aicontentdrop.com/v1/generate/image
- Auth: HTTP bearer
Query parameters
Query-parameter form of the X-Sandbox header, for clients that cannot set headers.
Headers
Client-generated unique key (max 200 chars). Retrying with the same key returns the FIRST response instead of starting a second generation, so a dropped connection cannot double-charge. Reusing a key with a different body returns 409.
Set to true to validate the request and receive a synthetic completed generation. No provider call, no credits spent, no record created. Use it to rehearse an integration before it costs money.
Send true to rehearse this call. Returns a synthetic completed generation: no provider call, no credits, no history row. Validation still runs. Works without an API key, so the response shape is observable before a credential exists. Documented at https://aicontentdrop.com/docs/sandbox.
Client-generated key (max 200 characters). A retry with the same key returns the FIRST response instead of starting a second generation. The same key with a different body is a 409. Keys are retained 24 hours.
Request body
Example request
{
"model": "nano_banana_pro"
}Response
Accepted. Poll GET /v1/videos/{id} until status is completed or failed.
Changes
No recorded changes to this operation across all 1 revision of this API.