Image Generation

POST/v1/run

Generate images using AI models like FLUX, Stable Diffusion, DALL-E, and more.

Request body

stringmodelrequired

Current model identifier, for example bfl/flux-1/schnell.

stringpromptrequired

Text description of the image

Optional<string>aspect_ratio

Output aspect ratio. Flux 1 Schnell defaults to 16:9.

Optional<number>guidance_scale

Prompt guidance strength from 1 to 20.

Optional<jpeg | png>output_format

Output image format. Flux 1 Schnell defaults to jpeg.

Optional<string>mode

Set to async only when the selected model supports asynchronous execution

Optional<string>webhook_url

Public HTTPS callback URL for this async task only

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"bfl/flux-1/schnell","prompt":"A futuristic city at sunset","aspect_ratio":"1:1"}'

Response200 OK

{
  "id": "run_01...",
  "status": "completed",
  "outputs": [
    {
      "url": "https://media.sandbase.ai/images/output.png"
    }
  ]
}