跳转到主要内容
文字变形

文字变形 — 查询结果

查询文字变形任务状态

GET
/tasks/{task_id}
查询任务结果
curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
{
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "output": {
    "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
    "task_status": "SUCCEEDED",
    "results": [
      {
        "png_url": "https://xxx/1.png",
        "svg_url": "https://xxx/1.svg"
      },
      {
        "png_url": "https://xxx/2.png",
        "svg_url": "https://xxx/2.svg"
      },
      {
        "code": "DataInspectionFailed",
        "message": "The output image may contain inappropriate content."
      },
      {
        "png_url": "https://xxx/4.png",
        "svg_url": "https://xxx/4.svg"
      }
    ]
  },
  "usage": {
    "image_count": 3
  }
}
查询任务状态并获取生成的文字变形图片。

轮询策略

  1. 通过提交文字变形任务接口提交任务,获取 task_id
  2. 5 秒轮询一次,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,从 results 中获取 png_urlsvg_url

响应字段说明

任务成功后,results 数组中每个元素包含以下字段:
字段说明
png_url生成的 PNG 格式图片 URL
svg_url生成的 SVG 格式图片 URL
code单张图片的错误码(仅在该图片生成失败时返回)
message单张图片的错误信息(仅在该图片生成失败时返回)

注意事项

  • 部分失败:当 n > 1 时,部分图片可能因内容安全审核未通过而失败,此时对应元素返回 codemessage,其余图片正常返回。
  • URL 有效期:生成的图片 URL 有效期为 24 小时,请及时下载。
  • 任务状态流转PENDINGRUNNINGSUCCEEDEDFAILEDUNKNOWN
  • 任务 ID 有效期task_id 有效期为 24 小时,过期后无法查询状态和结果。

鉴权

string
header
必填

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

路径参数

string
必填

任务 ID,由提交文字变形任务接口返回。

响应

200-application/json
string

请求唯一标识。

object
object