跳转到主要内容
创意海报

创意海报 — 查询结果

查询创意海报生成任务状态

GET
/tasks/{task_id}
查询任务结果
curl --location --request GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "b67df059-ca6a-9d51-afcd-9b3c4456b1e2",
  "output": {
    "task_id": "d76ec1e8-ea27-4038-8913-235c88ef0f70",
    "task_status": "SUCCEEDED",
    "submit_time": "2024-05-16 13:50:01.247",
    "scheduled_time": "2024-05-16 13:50:01.354",
    "end_time": "2024-05-16 13:50:27.795",
    "render_urls": [
      "http://vision-poster.oss-cn-shanghai.aliyuncs.com/xxxxxx"
    ],
    "auxiliary_parameters": [
      "xxxxxx"
    ],
    "bg_urls": [
      "http://vision-poster.oss-cn-shanghai.aliyuncs.com/xxxxxx"
    ]
  },
  "usage": {
    "image_count": 1
  }
}
查询任务状态并获取生成的海报图片。

轮询策略

  1. 通过生成海报接口提交任务,获取 task_id
  2. 5 秒轮询一次,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,从响应中获取海报图片。

响应字段说明

任务成功后,响应中包含以下字段:
字段说明
render_urls渲染后的海报图片 URL 列表
bg_urls背景图片 URL 列表
auxiliary_parameters辅助参数列表,用于 srhrf 模式的二次生成

注意事项

  • URL 有效期:生成的图片 URL 有效期为 24 小时,请及时下载。
  • 任务状态流转PENDINGRUNNINGSUCCEEDEDFAILEDSUSPENDED
  • 任务 ID 有效期task_id 有效期为 24 小时,过期后无法查询状态和结果。
  • 避免重复提交:请通过轮询获取结果,不要重复提交请求。

错误码

HTTP 状态码错误码错误信息含义
400InvalidParametercheck input data style输入参数不满足入参要求
500InternalErrorinference error算法内部错误

常见问题

Q:创意海报生成需要多长时间? A:生成时间一般为 20~60 秒,受排队情况影响可能有所延迟。建议以 5 秒为间隔轮询查询接口,避免频繁请求。 Q:render_urlsbg_urls 有什么区别? A:render_urls 是包含文字排版的完整海报图片;bg_urls 是不含文字的背景图片,可用于后续二次编辑。

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

路径参数

string
必填

任务 ID,由生成海报接口返回。

响应

200-application/json
string

请求唯一标识。

object
object