• 简体中文
  • 查询状态与下载视频(即梦格式)

    端点

    POST /jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31

    请求体

    查询结果用 POST 请求,任务 ID 放在 body 里:

    字段类型必填说明
    task_idstring是创建接口返回的任务 ID

    请求示例

    cURL
    Python
    Node.js
    # 查询任务结果
    curl -X POST "https://api-model.shuntianchuang.cn/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31" \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{ "task_id": "task_xxxxxxxx" }'
    
    # 任务 SUCCESS 后,从 data.result_url 取视频直链下载
    curl -o jimeng.mp4 "data 中返回的视频URL"

    响应体

    查询响应为统一任务 JSON,关键字段如下:

    data 字段说明
    task_id任务 ID
    status状态流转:NOT_START(已提交待处理)→ QUEUED / SUBMITTED(排队、已提交)→ IN_PROGRESS(生成中)→ SUCCESS(成功)或 FAILURE(失败)
    progress进度百分比字符串,如 "50%"
    result_url成功后的视频下载直链,建议及时下载转存
    fail_reason失败原因

    响应示例

    {
      "code": "success",
      "data": {
        "task_id": "task_xxxxxxxx",
        "status": "SUCCESS",
        "progress": "100%",
        "result_url": "https://xxxx/video.mp4",
        "fail_reason": ""
      }
    }
    NOTE

    即梦格式的参数由网关映射后转发上游,可用性、计费与响应字段以本站实际响应为准;模型名与价格以模型广场显示为准。计费按任务完成时的实际用量结算(失败自动退还)。