Quickstart

1. Get an API key

Create a key in developer settings. Your key is shown once — store it somewhere safe. Keys start with sk_live_.

2. Generate an image

Send an action, a model (or "auto"), and a prompt. The response contains a job whose outputs hold the result URLs.

curl https://api.dreamward.ai/v1/generations \
  -H "Authorization: Bearer $DREAMWARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_image",
    "model": "nano-banana-2",
    "prompt": "A sunset over the ocean",
    "params": { "ratio": "16:9", "count": 1 }
  }'

3. Poll for longer jobs

Video and audio jobs return with status queued or submitted. Poll GET /v1/generations/{id} until status is done.