跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。

模型

alibaba/z-image/turbo 根据文本生成图像,也可编辑单张参考图。

输入参数

  • prompt:必填字符串,1 到 1000 个字符。描述要生成的图像或要做的编辑。
  • image_urls:可选数组,只包含一个 HTTP(S) 图像 URL。提供此字段即选择图像编辑。
  • size:文生图必填,图像编辑可选。取值:1:1、4:3、3:4、16:9、9:16。
  • enable_safety_checker:可选布尔值。默认 true。

文生图

图像编辑

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
enum<string>
必填

Z-Image Turbo 模型标识。

可用选项:
alibaba/z-image/turbo
示例:

"alibaba/z-image/turbo"

input
object
必填

图像生成参数。文生图时 size 必填;通过 image_urls 提供编辑参考图时可选。

size、image_urls 至少提供一个。

callback_url
string<uri>

可选的 Webhook 回调 URL。

响应

任务提交成功

code
integer
必填
示例:

200

data
object
必填