跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
starvideos
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/starvideos/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "赛博朋克城市夜景，镜头慢慢推进",
    "model": "starvideos_v3",
    "duration": 5,
    "ratio": "16:9"
  }'

{
  "id": "video_starvideos_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_v3",
  "status": "queued",
  "error": null
}

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.

​
StarVideos 创建视频任务

创建 StarVideos 视频生成任务。该接口支持纯文生、单图生视频，以及首尾帧视频 3 种模式。

​
认证

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

​
基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

​
请求参数

​
prompt
string
必填
视频生成提示词。示例："赛博朋克城市夜景，镜头慢慢推进"
​
model
string
必填
模型名称，当前固定为 starvideos_v3。
​
duration
integer
视频时长，单位为秒。默认 5，允许范围 3-15。
​
ratio
string
输出比例。默认 16:9。可选值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
​
images
array
参考图 URL 数组，最多使用前 2 张。使用规则：
  • 不传 images：按文生视频处理
  • 传 1 张图：按单图生视频处理
  • 传 2 张图：按首尾帧视频处理
超过 2 张时，仅前 2 张生效

​
模式说明

文生视频

不传 images，仅依赖 prompt 生成视频

单图生视频

传入 1 张参考图，增强主体和风格控制

首尾帧视频

传入 2 张参考图，分别作为首帧和尾帧

​
响应参数

​
id
string
视频生成任务的唯一标识符，用于后续查询任务状态。
​
object
string
对象类型，固定为 video。
​
created
integer
任务创建时间戳。
​
model
string
使用的模型名称。
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
error
string
错误信息。当任务状态为 failed 时返回。

​
参数约束

关键约束：
  • model 当前仅支持 starvideos_v3
  • duration 必须在 3-15 秒之间
  • ratio 仅支持 16:9 或 9:16
  • images 最多使用前 2 张
最佳实践：
  1. 创建任务为异步处理，请保存返回的 id。
  2. 提示词建议同时包含主体、动作、镜头和风格信息。
  3. 首尾帧模式下，建议两张图片在风格和主体上保持连贯。
  4. 单图或双图 URL 需要为可访问的公网地址。
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/starvideos/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "赛博朋克城市夜景，镜头慢慢推进",
    "model": "starvideos_v3",
    "duration": 5,
    "ratio": "16:9"
  }'

{
  "id": "video_starvideos_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_v3",
  "status": "queued",
  "error": null
}