Modelink

OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建视频任务

POST
/v1/videos

OpenAI 风格的统一视频创建接口，服务端根据 model 前缀自动路由到对应供应商：

  • 可灵（Kling）：kling-v3-omni 等 Omni 模型，支持文生 / 图生 / 视频生视频、首尾帧、有声视频等，参数结构见 KlingV3OmniCreateRequest。
  • Sora：sora-2、sora-2-pro，支持文生视频与图生视频（通过 input_reference 传参考图），参数结构见 SoraVideoCreateRequest。

请求体结构按 model 区分，下方示例分别给出可灵与 Sora 两类模型的用法。任务创建成功后返回任务 ID，可通过 GET /v1/videos/{id} 轮询任务状态并获取生成的视频。

Sora 分辨率限制：sora-2 仅支持 1280x720 / 720x1280；sora-2-pro 额外支持 1792x1024 / 1024x1792。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

请求体

请求体属性

    • multi_shotboolean

      是否生成多镜头视频。当前参数为 true 时，prompt 参数无效；当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。

      default: false

    • promptstring

      文本提示词，可包含正向描述和负向描述。可将提示词模板化来满足不同的视频生成需求。Omni 模型可通过 Prompt 与主体、图片、视频等内容实现多种能力：通过 <<<>>> 的格式来指定某个主体、图片、视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>。长度不能超过 2500 个字符。当 multi_shot 参数为 false 或 shot_type 参数为 intelligence 时，当前参数不得为空。不同模型版本、视频模式支持范围不同，详见能力地图。

    • sizestring

      生成视频的画面纵横比（宽:高）。对应可灵的 aspect_ratio 字段，服务内部自动将 size（如 1280x720）转换为 aspect_ratio（如 16:9）。可灵文档枚举值：16:9, 9:16, 1:1。未使用首帧参考或视频编辑功能时，当前参数必填。

    • promptstring, 必填

      文本提示词，描述希望生成的视频内容。最大 2500 字符。

    • input_referencestring<uri>

      参考图片 URL，用于图生视频。传入该字段后自动走图生视频流程，图片尺寸需与 size 一致。仅支持文生视频时可省略。

请求

POST/v1/videos
curl https://api.qnaigc.com/v1/videos \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v3-omni",
  "prompt": "视频连贯在一起",
  "image_list": [
    {
      "image": "https://picsum.photos/1280/720",
      "type": "first_frame"
    },
    {
      "image": "https://picsum.photos/1280/720",
      "type": "end_frame"
    }
  ],
  "size": "1920x1080",
  "mode": "pro"
}'

响应

object

视频任务创建成功

响应体属性

  • idstring, 必填

    视频任务唯一 ID，用于后续查询任务状态

  • modelstring

    使用的模型名称，例如 kling-video-o1

  • modestring

    生成模式，std（标准模式）或 pro（专家模式）

  • statusstring, 必填

    任务状态，通常为 queued（排队中）

  • created_atinteger

    创建时间（Unix 时间戳，秒）

  • updated_atinteger

    更新时间（Unix 时间戳，秒）

  • secondsstring

    视频时长（秒）

  • sizestring

    请求体中的视频分辨率（宽 x 高）

  • job_type_descriptionstring

    任务类型描述。

  • billing_type_descriptionstring

    计费类型描述。

响应

application/json
{
  "id": "qvideo-user123-1766391125174150336",
  "object": "video",
  "model": "kling-v3-omni",
  "mode": "pro",
  "status": "queued",
  "created_at": 1766391125,
  "updated_at": 1766391125,
  "seconds": "5",
  "size": "1920x1080"
}

查询视频生成状态

GET
/v1/videos/{id}

根据视频任务 ID 查询视频生成状态和结果，适用于通过 POST /v1/videos 创建的可灵（kling-v3-omni 等）与 Sora（sora-2、sora-2-pro）任务。建议定期轮询直到状态变为 completed 或 failed。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

  • Name
    id
    Type
    string, 必填
    Description

    视频任务 ID，创建视频时返回的 id 字段

请求体

暂无请求体

请求

GET/v1/videos/{id}
curl https://api.qnaigc.com/v1/videos/{id} \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json'

响应

object

成功获取视频任务状态

响应体属性

  • idstring, 必填

    视频任务唯一 ID

  • modelstring

    使用的模型名称

  • modestring

    生成模式，std 或 pro，仅在成功时返回

  • created_atinteger

    创建时间（Unix 时间戳，秒）

  • updated_atinteger

    更新时间（Unix 时间戳，秒）

  • completed_atinteger

    完成时间（Unix 时间戳，秒），仅在已完成或失败时返回

  • secondsstring

    视频时长（秒）

  • sizestring

    视频分辨率（宽 x 高）

    • codestring

      错误码

    • messagestring

      错误描述

响应

application/json
{
  "id": "qvideo-user123-1766391125174150336",
  "object": "video",
  "model": "kling-video-o1",
  "status": "in_progress",
  "created_at": 1766391125,
  "updated_at": 1766391150
}

视频 Remix

POST
/v1/videos/{id}/remix

基于已完成的视频任务，使用新的提示词重新生成视频。保持原视频的时长和分辨率。支持的模型：sora-2、sora-2-pro（需为通过 POST /v1/videos 创建并已完成的 Sora 视频任务）。

认证方式

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

  • Name
    id
    Type
    string, 必填
    Description

    原视频任务 ID（必须是已完成的视频任务）

请求体

请求体属性

  • promptstring, 必填

    新的视频生成提示词，最大 2500 字符。描述希望在新视频中呈现的变化、风格或效果。

请求

POST/v1/videos/{id}/remix
curl https://api.qnaigc.com/v1/videos/{id}/remix \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "将场景改为夜晚,增加霓虹灯效果,赛博朋克风格"
}'

响应

object & object

Remix 任务创建成功

响应体属性

    • idstring, 必填

      视频任务唯一 ID，用于后续查询任务状态

    • modelstring

      使用的模型名称，例如 kling-video-o1

    • modestring

      生成模式，std（标准模式）或 pro（专家模式）

    • statusstring, 必填

      任务状态，通常为 queued（排队中）

    • created_atinteger

      创建时间（Unix 时间戳，秒）

    • updated_atinteger

      更新时间（Unix 时间戳，秒）

    • secondsstring

      视频时长（秒）

    • sizestring

      请求体中的视频分辨率（宽 x 高）

    • job_type_descriptionstring

      任务类型描述。

    • billing_type_descriptionstring

      计费类型描述。

    • remixed_from_video_idstring, 必填

      源视频任务 ID。

响应

application/json
{
  "id": "qvideo-user123-1766454050923137689",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "created_at": 1766454050,
  "updated_at": 1766454050,
  "seconds": "4",
  "size": "1280x720",
  "remixed_from_video_id": "qvideo-user123-1766453713089395279"
}

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify