Getting started
Models
List available models and choose the right one for each action.
Listing models
GET /v1/models returns the catalog. Filter by kind (image, video, audio) to narrow it down.
curl "https://api.dreamward.ai/v1/models?kind=image" \
-H "Authorization: Bearer $DREAMWARD_API_KEY"Model object
| Field | Type | Description |
|---|---|---|
id | string | Model identifier used in the model field, e.g. nano-banana-2. |
name | string | Human-readable name. |
kind | string | image | video | audio. |
unit | string | Billing unit: image, second or char. |
prices | object | Credits per unit, keyed by variant ('default' plus quality variants). |
capabilities | object | Supported ratios, durations, qualities, input slots. |
min_plan | string | Lowest plan tier that can use the model. |
Auto model
Pass "auto" as the model to let the API pick a sensible default for the action. The chosen model is echoed back on the returned job.