跳转到主要内容
POST
提交 Qwen Image 3.0 图像编辑任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
此模型支持基于参考图的编辑,适用于海报、产品视觉、文字排版和自然语言创意任务。

模型

  • qwen-image-3.0/edit - 标准版参考图编辑,输出 1K 和 2K

参数

  • prompt 必填,最多 5,000 个字符。
  • size 支持 1:1、3:2、2:3、4:3、3:4、16:9、9:16 和 21:9。
  • resolution 支持 1K 和 2K。
  • output_format 支持 png 和 jpeg。
  • prompt_extend 控制是否自动增强提示词。
  • negative_prompt 描述不希望出现在输出中的内容。
  • seed 取值范围为 0 到 2,147,483,647。
  • enable_safety_checker 控制内容安全检查。
  • image_urls 必填。
  • 按输出图像计费,每张输入图像另计使用费用。

参考图示例

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"qwen-image-3.0/edit"

input
object
必填
callback_url
string<uri>

可选的 Webhook 回调 URL。

响应

任务提交成功

code
integer
必填
示例:

200

data
object
必填