Generation

Generate videos

Submit a video generation, poll for completion, then download the result.

Submit

Use the create_video action. Video jobs are asynchronous: the response returns immediately with status queued or submitted.

curl https://api.dreamward.ai/v1/generations \
  -H "Authorization: Bearer $DREAMWARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_video",
    "model": "auto",
    "prompt": "A slow dolly-in on a neon-lit alley at night",
    "params": { "ratio": "16:9", "duration_s": 6, "quality": "720p" }
  }'

Parameters

Field	Type	Description
`action`required	string	create_video.
`model`required	string	A video model id or "auto".
`prompt`	string	Describe the motion and subject action.
`params.ratio`	string	Aspect ratio, e.g. 16:9, 9:16.
`params.duration_s`	integer	Clip length in seconds; allowed values depend on the model.
`params.quality`	string	Resolution tier, e.g. 720p, 1080p.
`input_media_ids`	string[]	First/last frame or reference images for image-to-video.

Poll for the result

Call GET /v1/generations/{id} until status becomes done (or failed). On success, outputs[0].url is the video.

curl https://api.dreamward.ai/v1/generations/JOB_ID \
  -H "Authorization: Bearer $DREAMWARD_API_KEY"

A failed job is refunded automatically — credits are only kept for deliverable output.