跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
videos
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/videos/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "videos",
    "prompt": "一只可爱的小猫在草地上玩耍，阳光明亮，电影感镜头",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

{
  "code": "0",
  "msg": null,
  "data": {
    "projectId": "proj_1234567890"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.globalaiopc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Videos 创建视频任务

使用 Videos 系列模型创建视频生成任务，支持标准和快速两种模型，并支持纯文生、首尾帧、多图参考、视频参考与图视频混合参考。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
模型介绍

支持的模型：
  • videos：标准模型，按次计费
  • videos_fast：快速模型，按次计费

​
请求参数

​
model
string
必填
模型名称。可选值：
  • videos - 标准模型
  • videos_fast - 快速模型
​
prompt
string
必填
视频生成提示词，最大 1500 个字符。建议避免违规、侵权、涉政、涉黄等高风险内容。示例："一只可爱的小猫在草地上玩耍"
​
duration
integer
必填
视频时长（秒），范围 4-15 秒。
​
ratio
string
输出比例，默认 16:9。支持的值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
​
resolution
string
输出分辨率，默认 720p。当前仅支持：
  • 720p

​
首尾帧模式

​
image
string
首帧图片 URL。
  • 仅用于首尾帧场景
  • 必须搭配 lastFrameImage 使用
不能与 referenceImages 或 referenceVideos 同时使用
​
lastFrameImage
string
尾帧图片 URL。
  • 必须搭配 image 使用
不能与 referenceImages 或 referenceVideos 同时使用

​
引用素材模式

​
referenceImages
array
参考图片 URL 列表。规则说明：
  • 最多 4 张
  • 每张图片不能超过 20MB
  • 可与 referenceVideos 组合形成图视频混合参考
不能与 image 或 lastFrameImage 同时使用
​
referenceVideos
array
参考视频 URL 列表。规则说明：
  • 最多 3 个
  • 总时长不能超过 15 秒
  • 总大小不能超过 200MB
  • 单个参考视频分辨率需在 720px-2160px 之间
不能与 image 或 lastFrameImage 同时使用

​
响应参数

​
code
string
状态码，0 表示成功。
​
msg
string
返回信息，失败时通常包含错误原因。
​
data.projectId
string
任务 ID。用于后续查询任务状态和结果。

​
参数选择规则

互斥规则：
  • 首尾帧模式：image 和 lastFrameImage 必须成对使用
  • 引用素材模式：referenceImages、referenceVideos 可单独或组合使用
  • 模式互斥：首尾帧模式不能与引用素材模式同时使用

​
使用场景

纯文生视频

仅传 prompt、model、duration 等基础参数

首尾帧视频

通过 image 和 lastFrameImage 精确控制开头与结尾画面

图视频混合参考

通过 referenceImages 与 referenceVideos 组合提供更强的素材约束

​
模型特性

模型计费方式时长范围适用场景
videos按次计费4-15 秒标准质量场景
videos_fast按次计费4-15 秒对生成速度更敏感的场景
最佳实践：
  1. 视频生成为异步处理，请保存创建返回的任务 ID 用于后续查询。
  2. 提示词尽量包含具体场景、动作、镜头和风格描述。
  3. 使用首尾帧模式时，确保两张图片在风格和构图上连续。
  4. 使用视频参考时，优先提供清晰、时长较短、主体明确的素材。
  5. 如需更稳定的结果，优先使用 videos；如需更快返回，可选择 videos_fast。
提示词建议：
  • 描述主体、动作和镜头语言
  • 补充风格词，如“电影感”“写实”“梦幻”
  • 如果有运动轨迹诉求，可直接写明镜头推进、转场或视角变化
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/videos/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "videos",
    "prompt": "一只可爱的小猫在草地上玩耍，阳光明亮，电影感镜头",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

{
  "code": "0",
  "msg": null,
  "data": {
    "projectId": "proj_1234567890"
  }
}