OpenAPI 参考

Modelink API · 视频

Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo、MiniMax H3/H3 Max 等多厂商的文生视频、图生视频与任务查询能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。

版本 1.0.0

查询任务状态

GET

/queue/byteplus/seedance-2.0/requests/{request_id}/status

轮询任务状态。fast 变体任务的状态查询与 fal 官方一致，路径中不含 /fast。

处理中：HTTP 202，status 为 IN_QUEUE 或 IN_PROGRESS
完成/失败：HTTP 200，status 为 COMPLETED

建议轮询间隔：2～5 秒

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务时返回的 request_id

请求体

暂无请求体

请求

GET/queue/byteplus/seedance-2.0/requests/{request_id}/status

curl https://api.qnaigc.com/queue/byteplus/seedance-2.0/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object & object & object

任务已完成（成功或失败）

响应体属性

allOf[0]object & object
状态查询响应。
- allOf[0]object
  fal 标准 URL 集合，所有响应均内联此字段。
  - request_idstring, 必填
    任务唯一标识符。
  - response_urlstring, 必填
    获取结果的完整 URL。
  - status_urlstring, 必填
    查询状态的完整 URL。
  - cancel_urlstring
    取消任务的 URL（暂不支持）。
- allOf[1]object
  - statusenum, 必填
    
    IN_QUEUE：排队等待
    
    IN_PROGRESS：生成中
    
    COMPLETED：已完成（成功或失败，通过 detail 字段区分）
    
    IN_QUEUE
    IN_PROGRESS
    COMPLETED
  - queue_positioninteger
    队列位置，仅 IN_QUEUE 状态有意义。
  - logsobject[]
    messagestring
    可选。
    levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
    sourcestring
    可选。
    timestampstring<date-time>
    ISO 8601 格式。
  - metricsobject
    inference_timenumber<double>
    推理耗时（秒）。
  - detailobject
    任务失败时的错误详情。
    allOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - resultobject
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Dreamina Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens。
  - allOf[0]object
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

object & object & object

任务处理中

响应体属性

allOf[0]object & object
状态查询响应。
- allOf[0]object
  fal 标准 URL 集合，所有响应均内联此字段。
  - request_idstring, 必填
    任务唯一标识符。
  - response_urlstring, 必填
    获取结果的完整 URL。
  - status_urlstring, 必填
    查询状态的完整 URL。
  - cancel_urlstring
    取消任务的 URL（暂不支持）。
- allOf[1]object
  - statusenum, 必填
    
    IN_QUEUE：排队等待
    
    IN_PROGRESS：生成中
    
    COMPLETED：已完成（成功或失败，通过 detail 字段区分）
    
    IN_QUEUE
    IN_PROGRESS
    COMPLETED
  - queue_positioninteger
    队列位置，仅 IN_QUEUE 状态有意义。
  - logsobject[]
    messagestring
    可选。
    levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
    sourcestring
    可选。
    timestampstring<date-time>
    ISO 8601 格式。
  - metricsobject
    inference_timenumber<double>
    推理耗时（秒）。
  - detailobject
    任务失败时的错误详情。
    allOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - resultobject
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Dreamina Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens。
  - allOf[0]object
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

响应

{
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "status": "IN_QUEUE",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ],
  "metrics": {
    "inference_time": 42
  }
}

获取任务结果

GET

/queue/byteplus/seedance-2.0/requests/{request_id}

获取已完成任务的视频结果。fast 变体任务的结果查询与 fal 官方一致，路径中不含 /fast。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
创建任务时返回的 request_id

请求体

暂无请求体

请求

GET/queue/byteplus/seedance-2.0/requests/{request_id}

curl https://api.qnaigc.com/queue/byteplus/seedance-2.0/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object & object

任务成功，返回视频结果

响应体属性

allOf[0]object
任务成功时的结果响应体。
- videoobject
  - urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
allOf[1]object
- usageobject
  Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
  - completion_tokensinteger
    模型输出视频消耗的 token 数。
  - total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

object & object & object

任务仍在处理中

响应体属性

allOf[0]object & object
状态查询响应。
- allOf[0]object
  fal 标准 URL 集合，所有响应均内联此字段。
  - request_idstring, 必填
    任务唯一标识符。
  - response_urlstring, 必填
    获取结果的完整 URL。
  - status_urlstring, 必填
    查询状态的完整 URL。
  - cancel_urlstring
    取消任务的 URL（暂不支持）。
- allOf[1]object
  - statusenum, 必填
    
    IN_QUEUE：排队等待
    
    IN_PROGRESS：生成中
    
    COMPLETED：已完成（成功或失败，通过 detail 字段区分）
    
    IN_QUEUE
    IN_PROGRESS
    COMPLETED
  - queue_positioninteger
    队列位置，仅 IN_QUEUE 状态有意义。
  - logsobject[]
    messagestring
    可选。
    levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
    sourcestring
    可选。
    timestampstring<date-time>
    ISO 8601 格式。
  - metricsobject
    inference_timenumber<double>
    推理耗时（秒）。
  - detailobject
    任务失败时的错误详情。
    allOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - resultobject
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
allOf[1]object
- resultobject & object
  Dreamina Seedance 视频任务结果。存在有效 token 用量时返回 usage，其中包含 completion_tokens 和 total_tokens。
  - allOf[0]object
    任务成功时的结果响应体。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
  - allOf[1]object
    usageobject
    Seedance 视频任务 token 用量（扁平字段位于结果或成功 Webhook 的 usage 下）。仅在任务存在有效 token 用量时返回；进行中、全零或历史缺失用量时省略 usage。内部 tool_usage 不会对外暴露。
    completion_tokensinteger
    模型输出视频消耗的 token 数。
    total_tokensinteger
    总消耗 token；Seedance 视频模型输入 token 计为 0，通常与 completion_tokens 相等。

响应

{
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  },
  "usage": {
    "completion_tokens": 42,
    "total_tokens": 42
  }
}