---
title: "Generate image using AI"
method: POST
path: "/collection/{collection_id}/generate/image/"
---

# Generate image using AI

`POST /collection/{collection_id}/generate/image/`

## Path parameters

- `collection_id` string, required

## Request body

- object
  - `prompt` string, required
  - `aspect_ratio` string
  - `model_name` string — Model used for image generation.
  - `config` object — Model configuration. For FLUX supports size, num_inference_steps, guidance_scale, negative_prompt, and seed.
  - `sandbox_id` string — Sandbox ID used for self-hosted image generation.
  - `callback_url` string

## Response `200`

Image generation started

- AsyncResponse
  - `success` boolean
  - `status` 'processing' | 'done' | 'failed'
  - `data` object
    - `id` string
    - `output_url` string

---

[API](https://skmtc.net/video-db/apis/videodb-server-api.md) · [All operations](https://skmtc.net/video-db/apis/videodb-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/video-db/videodb-server-api/versions/21b1d1d3eae8/schema)