1. 豆包视频
ModelPort.AI 接口文档
  • 快速开始
    • 平台简介
    • 控制台(入门)
    • API key
    • Base URL
  • AI大模型接口
    • 图像
      • GPT Image 2
      • Kwai-Kolors
      • flux-kontext-max
      • grok-imagine-image
    • 视频
      • 通用视频生成接口
      • 豆包视频
        • 文生视频示例
          POST
        • 图生视频示例
          POST
        • 查询单个任务
          GET
        • Seedance-2.0系列
          POST
      • grok视频
      • Agnes-Video
        • Agnes-Video
        • Agnes-Video查询
    • OpenAI格式(支持各大原厂模型)
      • 聊天(Response)
        • 创建模型响应
        • 创建网络搜索
        • 创建模型响应 gpt-5启用思考
        • 创建函数调用
        • 创建模型响应(流式返回)
        • 创建模型响应 (控制思考长度)
    • Anthropic格式
      • Anthropic简介
      • 聊天
      • 聊天(深度思考)
      • 聊天(新模型-深度思考)
      • 流式返回
      • 工具调用(function call)
      • 分析图片
    • 谷歌Gemini接口
      • Gemini API
      • 文本
        • 聊天
        • 文本生成-流
      • 图片NanoBanana
        • Nano Banana
        • OpenAI请求方式
          • 生成图片
          • 编辑图像
        • Gemini请求方式
          • 生成图片
          • 编辑图片
      • 视频Veo
        • Veo
      • 文档理解
    • Rerank重排序模型
      • 重排序
    • 文生音乐Suno
      • 生成歌曲(灵感模式)
      • 生成歌词
      • 查询单个任务
      • 查询批量任务
    • Midjourney格式
      • Midjourney简介
  • 素材资产
    • CreateAssetGroup
      POST
    • CreateAsset
      POST
    • GetAsset
      POST
  1. 豆包视频

查询单个任务

开发中
GET
/v1/video/generations/{id}
官方文档:https://www.volcengine.com/docs/82379/1521309?lang=zh
模型:
doubao-seedance-1-5-pro-251215
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
返回值状态status:
IN_PROGRESS 生成中 / 运行中
SUCCESS 生成成功
FAILED 生成失败
PENDING 排队中
CANCELED 已取消
时间相关字段:
submit_time = 1776830438 (任务提交)
start_time = 1776830442 (开始执行)
finish_time = 1776830636 (完成生成)
1.
排队耗时
start_time - submit_time= 1776830442 - 1776830438 = 4 秒
2.
模型生成耗时
finish_time - start_time= 1776830636 - 1776830442 = 194 秒
3.
总耗时(提交 → 完成)
finish_time - submit_time= 1776830636 - 1776830438 = 198 秒

请求参数

Path 参数

Header 参数

Body 参数application/json

示例
{}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.modelport.ai/v1/video/generations/' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <您的真实API_KEY>' \
--header 'Content-Type: application/json' \
--data '{}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": "success",
    "message": "",
    "data": {
        "id": 12,
        "created_at": 1776830438,
        "updated_at": 1776830636,
        "task_id": "task_8HrtGiIZ41ADcpmNh82yzUh2p2VRK1dG",
        "platform": "45",
        "user_id": 2,
        "group": "doubao-of",
        "channel_id": 16,
        "quota": 500,
        "action": "generate",
        "status": "SUCCESS",
        "fail_reason": "",
        "result_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177683043878500000000000000000000ffffac1545b472ac99.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260422%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260422T040334Z&X-Tos-Expires=86400&X-Tos-Signature=b2122a9e4731701f87aff10f127d8eb82ac176ccc3f5ed67a8e4220fd4aa210c&X-Tos-SignedHeaders=host",
        "submit_time": 1776830438,
        "start_time": 1776830442,
        "finish_time": 1776830636,
        "progress": "100%",
        "properties": {
            "input": "",
            "upstream_model_name": "doubao-seedance-2-0-260128",
            "origin_model_name": "doubao-seedance-2-0-260128"
        },
        "data": {
            "id": "cgt-20260422120038-7jrzp",
            "seed": 3828,
            "draft": false,
            "model": "doubao-seedance-2-0-260128",
            "ratio": "16:9",
            "usage": {
                "total_tokens": 108900,
                "completion_tokens": 108900
            },
            "status": "succeeded",
            "content": {
                "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177683043878500000000000000000000ffffac1545b472ac99.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260422%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260422T040334Z&X-Tos-Expires=86400&X-Tos-Signature=b2122a9e4731701f87aff10f127d8eb82ac176ccc3f5ed67a8e4220fd4aa210c&X-Tos-SignedHeaders=host"
            },
            "duration": 5,
            "created_at": 1776830438,
            "resolution": "720p",
            "updated_at": 1776830634,
            "service_tier": "default",
            "generate_audio": true,
            "framespersecond": 24,
            "execution_expires_after": 172800
        }
    }
}
修改于 2026-04-22 04:21:11
上一页
图生视频示例
下一页
Seedance-2.0系列
Built with