OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

文生视频

POST

/queue/fal-ai/kling-video/v3/turbo/{mode}/text-to-video

可灵 3.0 Turbo 文生视频。mode 仅支持 pro(1080P)/standard(720P)；含声音、按秒计费（720P 0.8 元/s、1080P 1.0 元/s）。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
mode
Type
enum, 必填
Description
清晰度档位：pro=1080P，standard=720P。

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring
文本提示词。与 multi_prompt 互斥。建议不超过 2500 字符。
- indexinteger
  分镜序号，从 1 开始。
- promptstring
  该分镜的内容提示词。
- durationstring
  该分镜的时长（秒）；所有分镜总时长不能超过模型允许的总时长。
- 16:9
- 9:16
- 1:1
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15

请求

POST/queue/fal-ai/kling-video/v3/turbo/{mode}/text-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/kling-video/v3/turbo/{mode}/text-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只红色的狐狸在雪地森林中行走，电影质感",
  "aspect_ratio": "16:9",
  "duration": "5"
}'

响应

object & object

任务已入队。

响应体属性

- request_idstring, 必填
  任务唯一标识符。
- response_urlstring, 必填
  获取结果的完整 URL。
- status_urlstring, 必填
  查询状态的完整 URL。
- cancel_urlstring
  取消任务的 URL（暂不支持）。
- - IN_QUEUE
- queue_positioninteger
  队列位置（入队时为 0）。
- - messagestring
    可选。
  - STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。

响应

{
  "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"
    }
  ]
}

图生视频