Model reference
Z-Image
Lightweight Alibaba image model producing photorealistic output from text prompts at maximum cost efficiency.
| Property | Value |
|---|---|
modelSlug | z-image |
| Kind | Image |
| Maker | Alibaba |
Copies per request (variations) | 1 to 5 |
| How the cost is counted | per copy |
| Over MCP | yes, with the generate tool |
Credit amounts are left out because they change. The lowest price is creditCost on GET /v1/models, and POST /v1/jobs answers with the exact creditCost of a request.
input fields
Send the fields below inside the input object. A field you leave out takes its Default. Unknown field names are dropped without an error, so check the spelling if a setting seems to have no effect.
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
prompt | string | yes | – | Up to 1,000 characters |
aspect_ratio | string (one of) | – | 1:1 | 1:1, 4:3, 3:4, 16:9, 9:16 |
Example request
{
"modelSlug": "z-image",
"input": {
"prompt": "Product photo of white running shoes on a river stone, soft side light in the morning"
}
}