MaiToken
登录/注册

DashScope 图像生成(万相 / Wan 图)

阿里百炼原生异步协议:提交生图任务 → 轮询获取结果

POST/api/v1/services/aigc/text2image/image-synthesis

DashScope(阿里百炼)系生图模型走百炼原生协议,平台透明转发。与 OpenAI 兼容图像生成(同步)不同,百炼生图是异步任务:提交返回 task_id,轮询到 SUCCEEDED 后取结果。可用模型以 列出模型 返回为准(protocols 含 dashscope)。

Authorizations

Authorizationstring必填

Bearer Token 认证,无需阿里云 AK。

Authorization: Bearer YOUR_API_KEY

提交生图任务

三个提交端点(按模型选择,与百炼官方一致):

POST /api/v1/services/aigc/text2image/image-synthesis      # 文生图POST /api/v1/services/aigc/image2image/image-synthesis     # 图生图POST /api/v1/services/aigc/image-generation/generation     # wan2.6 图(action 为 generation,同样异步)

请求头

Header 必选 说明
Authorization 是 Bearer YOUR_API_KEY
Content-Type 是 application/json
X-DashScope-Async 是 必须设为 enable。百炼官方语义:HTTP 只支持异步调用,缺失该头会报错 current user api does not support synchronous calls

请求体为百炼原生格式:

  • model(必填)
  • input:prompt、negative_prompt、参考图等,按模型支持
  • parameters:size(如 1024*1024,注意是 * 分隔)、n、seed 等

查询任务

GET /api/v1/tasks/{task_id}

output.task_status:PENDING / RUNNING / SUCCEEDED / FAILED / CANCELED。成功后图片在 output.results[].url,URL 有效期以百炼为准(通常 24 小时),请及时转存。查询 / 取消接口只需 Authorization 头。

注意事项

  • 任务查询必须使用提交时所用的同一个 API Key;任务 Id 可查询窗口 7 天,过期返回 404 task_not_found
  • 建议 2–5 秒轮询一次直到终态
  • 取消:POST /api/v1/tasks/{task_id}/cancel(仅 PENDING 可取消)
  • 各模型 input / parameters 字段以阿里百炼官方文档为准,平台不做字段改写