API Reference

Generate an image

Generate an image and return the completed result.

POST /v1/generations

Body

Field	Type	Description
`action`required	string	create_image.
`model`required	string	Model id or "auto".
`prompt`required	string	Text prompt.
`params`	object	ratio, count, quality.
`input_media_ids`	string[]	Reference image ids.

Request

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" } }'

Response

{
  "data": [
    {
      "id": "gen_9f2c...",
      "action": "create_image",
      "model": "nano-banana-2",
      "status": "done",
      "cost_credits": 11,
      "outputs": [{ "id": "med_a1b2...", "url": "https://cdn.dreamward.ai/..." }],
      "error": null
    }
  ]
}