跳转到主要内容
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_starvideos_1234567890 \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_starvideos_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_v3",
  "status": "processing",
  "video_url": null,
  "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 查询视频任务

使用任务 ID 查询 StarVideos 视频生成任务的状态和结果。

​
认证

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

​
基础 URL

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

​
路径参数

​
id
string
必填
任务 ID。
这里的 {id} 取值来自创建接口返回的 id。

​
响应参数

​
id
string
视频生成任务的唯一标识符。
​
object
string
对象类型，固定为 video。
​
created
integer
任务创建时间戳。
​
model
string
使用的模型名称。
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
video_url
string
生成的视频 URL。当状态为 completed 时返回。
​
actualDuration
number
视频实际输出时长（秒）。当状态为 completed 时返回。
​
error
string
错误信息。当状态为 failed 时返回。

​
状态说明

1

queued

任务已创建并进入队列，等待处理。
2

processing

任务处理中，StarVideos 模型正在生成视频。
3

completed

任务完成，可通过 video_url 获取结果。

​
轮询建议

轮询策略：
  • 建议轮询间隔：30-60 秒
  • 当 status 变为 completed 或 failed 时停止轮询
  • 结果地址可能为临时链接，建议尽快保存
重要提示：
  • 查询接口中的 {id} 必须使用创建接口返回的 id
  • 生成结果通常为临时下载地址，请及时保存
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_starvideos_1234567890 \
  --header 'Authorization: Bearer {{key}}'

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