v5

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-0112516159.5 KB

Generate image using AI

post/collection/{collection_id}/generate/image/

Path parameters

collection_idstring required

Example:default

Request body

promptstring required

aspect_ratiostring

model_namestring

Model used for image generation.

configobject

Model configuration. For FLUX supports size, num_inference_steps, guidance_scale, negative_prompt, and seed.

sandbox_idstring

Sandbox ID used for self-hosted image generation.

callback_urlstring

Example request

{
  "prompt": "A beautiful sunset over mountains",
  "aspect_ratio": "16:9",
  "model_name": "black-forest-labs/FLUX.1-dev",
  "sandbox_id": "bx-123abc",
  "callback_url": "https://webhook.example.com/callback"
}

Response

Image generation started

successboolean

status'processing' | 'done' | 'failed'

Example response

{
  "success": true,
  "status": "processing",
  "data": {
    "id": "job-123",
    "output_url": "https://api.videodb.io/async-response/job-123"
  }
}