SUPER API文档中心
官网
官网
  1. 万相3.0-视频生成
  • API 接口
    • Chat
      • 对话补全
      • Claude原生消息接口
    • Models
      • 列出可用模型
    • Responses
      • Responses API
    • Embeddings
      • 文本向量化
    • Images
      • 生成图像
    • Audio
      • 文本转语音(TTS)
      • 语音转文本(STT)
      • 语音翻译
    • Video
      • 火山
        • 创建视频任务
        • 查询视频任务
      • 素材管理
        • 删除素材组
        • 拉起真人认证 H5
        • 获取真人
      • 阿里万相
        • 万相3.0-视频生成
          • 创建任务获取任务ID
            POST
          • 任务ID查询结果
            GET
      • 生成视频
        POST
    • Moderation
      • 内容审核
    • Rerank
      • 重排序
    • 余额查询
      • 查询余额(OpenAI兼容)
      • 查询已用额度(OpenAI兼容)
  1. 万相3.0-视频生成

任务ID查询结果

GET
/ali/api/v1/tasks/{task_id}
根据 task_id 查询任务状态与结果。
轮询建议:视频生成过程约需数分钟,建议采用轮询机制,并设置合理的查询间隔(如 15 秒)来获取结果。
任务状态流转:PENDING(排队中)→ RUNNING(处理中)→ SUCCEEDED(成功)/ FAILED(失败)。
结果链接:任务成功后返回视频链接,有效期为 24 小时。建议在获取链接后立即下载并转存至永久存储(如阿里云 OSS)。
task_id 有效期 24 小时,超时后将无法查询结果,接口将返回任务状态为 UNKNOWN。
RPS 限制:查询接口默认 RPS 为 20。如需更高频查询或事件通知,建议配置异步任务回调。
更多操作:如需批量查询、取消任务等操作,请参见管理异步任务。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Path 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ali/api/v1/tasks/' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200
application/json
查询成功(任务状态见 output.task_status)
Bodyapplication/json

示例
{
    "request_id": "78c9b768-0285-996c-b682-xxxxxx",
    "output": {
        "task_id": "17ed7e50-00cf-4509-aea1-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-06 10:01:35.452",
        "scheduled_time": "2026-08-06 10:01:35.507",
        "end_time": "2026-08-06 10:13:33.838",
        "orig_prompt": "A golden retriever running on a sunny beach, waves crashing in the background, cinematic lighting",
        "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/video.mp4"
    },
    "usage": {
        "video_count": 1,
        "duration": 5,
        "input_video_duration": 0,
        "output_video_duration": 5,
        "fps": 30,
        "SR": 720,
        "ratio": "16:9"
    }
}
上一页
创建任务获取任务ID
下一页
生成视频
Built with