Several steps. One call.

curl https://api.windpaint.ai/v1/workflows/text-to-clip/runs \  -H "Authorization: Bearer $WINDPAINT_API_KEY" \  -H "Content-Type: application/json" \  -d '{"inputs": {"idea": "a paper boat drifting down a rainy street", "aspect": "9:16"}}'

Video generation, coming soon

• A run uses z-image-turbo, which you can call directly today, and wan-2.2-i2v, which is coming soon.

Z-Image Turbo Wan 2.2 image-to-video (coming soon)

• All three are saved as assets in the run's project, with the same shape as a job's outputs. Download them through their url with your key and curl -L.
• The resized frame is saved too and appears in that step's outputs, but it isn't one of the run's named outputs.
• Pass the cover asset id as start_frame to video.generate to continue the shot.

How assets work

1. Estimate.

   POST /v1/workflows/{slug}/estimate prices a run with your actual inputs and validates them the same way a run would.

2. Run.

   POST /v1/workflows/{slug}/runs returns 202 with the run. Add webhook_url, retention_days or an Idempotency-Key header as needed.

3. Follow.

   Poll the run's status_url, take a signed webhook when it starts or finishes, or open its event stream. Each step reports its status, progress and outputs as it goes.

4. Collect.

   When the run completes, outputs holds every named output, keyed by name, and credits.actual holds what you paid.

# Start the run and keep its idrun_id=$(curl -s https://api.windpaint.ai/v1/workflows/text-to-clip/runs \  -H "Authorization: Bearer $WINDPAINT_API_KEY" \  -H "Content-Type: application/json" \  -d '{"inputs": {"idea": "steam rising from a coffee cup on a windowsill at sunrise", "aspect": "16:9"}}' \  | jq -r '.data.id')# Poll every 10 seconds until the run is terminalwhile :; do  run=$(curl -s "https://api.windpaint.ai/v1/workflows/runs/$run_id" \    -H "Authorization: Bearer $WINDPAINT_API_KEY")  status=$(echo "$run" | jq -r '.data.status')  echo "$status"  case "$status" in completed|failed|canceled) break ;; esac  sleep 10done# Download each output (follow the redirect to the signed URL)for name in video still cover; do  url=$(echo "$run" | jq -r ".data.outputs.$name[0].url")  ext=$(echo "$run" | jq -r ".data.outputs.$name[0].content_type" | cut -d/ -f2)  curl -sL "$url" -H "Authorization: Bearer $WINDPAINT_API_KEY" -o "$name.$ext"done

• Starting a run checks your available balance against the whole estimate but doesn't reserve it, so a run can fail partway if other jobs spend the balance in the meantime.
• Canceling marks the run and its unfinished steps canceled and releases the hold of any job still in flight.

• If a step fails, the run stops: unfinished steps are canceled with job.canceled_by_workflow and the run's status becomes failed.
• The run's error_code is the failing step's code, such as job.capacity_unavailable. Branch on it rather than on the error text.