Image Generation

POST/v1/run

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

Request body

stringmodelrequired

Model name (e.g. flux/schnell, dall-e-3)

stringpromptrequired

Text description of the image

Optional<integer>width

Image width in pixels

Optional<integer>height

Image height in pixels

Optional<integer>num_images

Number of images to generate (default: 1)

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":"flux/schnell","prompt":"A futuristic city at sunset","width":1024,"height":1024}'

Response200 OK

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