Z-Image Spicy

Model ID alibaba/z-image-spicy

概览

文生图模型：支持自定义尺寸、可复现随机种子，以及可选的智能提示词改写。

Alibaba · text-to-image

重要: size 与 width/height 字段互斥，同一请求中不可混用。

接口

POST /v1/images/generations/async

认证

Authorization: Bearer <AIAPIAIAPI_API_KEY>

请求体

model

类型：string · 必填：是 · 可空：否

用于路由请求的模型 ID。

prompt

类型：string · 必填：是 · 可空：否

描述待生成图像的文本提示词。

size

类型：string · 必填：否 · 可空：否

可选的输出尺寸，格式为 WIDTHxHEIGHT；不可与 width 或 height 同时使用，每个维度须为 256-1536 像素。

width

类型：integer · 必填：否 · 可空：否

输出图像宽度（像素），不可与 size 同时使用。

height

类型：integer · 必填：否 · 可空：否

输出图像高度（像素），不可与 size 同时使用。

seed

类型：integer · 必填：否 · 可空：否

随机种子；省略或设为 0 时随机生成，使用正整数时可复现结果。

prompt_extend

类型：boolean · 必填：否 · 可空：否

启用智能提示词改写；默认开启，使用时单独计费。

output_format

类型：string · 必填：否 · 可空：否

生成图像的文件格式；Z-Image Spicy 当前仅支持 PNG。

n

类型：integer · 必填：否 · 可空：否

每个任务生成的图像数量；Z-Image Spicy 仅支持生成 1 张。

请求示例

curl --request POST \
  --url https://aiapiaiapi.com/v1/images/generations/async \
  --header 'Authorization: Bearer $AIAPIAIAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "alibaba/z-image-spicy",
      "prompt": "A cinematic camera movement through a forest",
      "width": 1024,
      "height": 1536,
      "prompt_extend": true
    }'

JSON

{
  "model": "alibaba/z-image-spicy",
  "prompt": "A cinematic camera movement through a forest",
  "width": 1024,
  "height": 1536,
  "prompt_extend": true
}

响应

{
  "code": "success",
  "message": "",
  "data": { "task_id": "image_01K2ABC123" }
}

任务状态

使用创建响应中的 task_id 查询：

GET /v1/images/generations/async/{task_id}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "image_01K2ABC123",
    "status": "SUCCESS",
    "progress": "100%",
    "outputs": ["https://cdn.example.com/images/image_01K2ABC123.png"],
    "start_time": 1786960805,
    "finish_time": 1786960900,
    "submit_time": 1786960800,
    "fail_reason": ""
  }
}

错误响应

参数校验错误返回 HTTP 400，并包含稳定的错误代码。

{
  "code": "unsupported_parameter",
  "message": "The parameter is not supported by this model.",
  "data": null
}