OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建文生视频任务

POST

/queue/fal-ai/veo3.1/fast

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\""
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建首尾帧生视频任务

POST

/queue/fal-ai/veo3.1/fast/first-last-frame-to-video

使用首帧和尾帧图片生成视频，支持 Google Veo 3.1 模型。两张图片如果是 HTTP URL 会自动并行转存到 GCS。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
first_frame_urlstring, 必填
URL of the first frame of the video
last_frame_urlstring, 必填
URL of the last frame of the video
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast/first-last-frame-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast/first-last-frame-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": "A woman looks into the camera, breathes in, then exclaims energetically, \"have you guys checked out Veo3.1 First-Last-Frame-to-Video on Fal? It'\''s incredible!\"",
  "first_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-1.jpeg",
  "last_frame_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31-flf2v-input-2.jpeg",
  "aspect_ratio": "16:9"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

创建图生视频任务

POST

/queue/fal-ai/veo3.1/fast/image-to-video

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

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

请求体

请求体属性

promptstring, 必填
The text prompt describing the video you want to generate
- 4s
- 6s
- 8s
auto_fixboolean
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
default: false
generate_audioboolean
Whether to generate audio for the video.
default: true
- auto
- 16:9
- 9:16
- 720p
- 1080p
- 4k
image_urlstring, 必填
URL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit.
- 1
- 2
- 3
- 4
- 5
- 6
- anyOf[0]integer
  可选。
- anyOf[1]null
  可选。
- anyOf[0]string
  可选。
- anyOf[1]null
  可选。

请求

POST/queue/fal-ai/veo3.1/fast/image-to-video

curl 'https://api.qnaigc.com/queue/fal-ai/veo3.1/fast/image-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": "A monkey and polar bear host a casual podcast about AI inference, bringing their unique perspectives from different environments (tropical vs. arctic) to discuss how AI systems make decisions and process information.\nSample Dialogue:\nMonkey (Banana): \"Welcome back to Bananas & Ice! I am Banana\"\nPolar Bear (Ice): \"And I'\''m Ice!\"",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg"
}'

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}