mingyanmingyan
wechatwechat
mingyan

StarVideos O3 - Create Task

Create StarVideos O3 video generation tasks with text, image references, first/last frames, video references, and mixed image-video references

POST/kyyReactApiServer/v1/starvideos/videos

StarVideos O3 Create Video Task

Create a video generation task with starvideos_o3. This API supports text-to-video, single/multiple image references, first/last frame generation, video reference, image + video, and multi-image + video modes.

Authentication

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

modelbodystringrequired
Model name. The value is fixed to starvideos_o3.
promptbodystringrequired
Video generation prompt. Describe the subject, motion, camera movement, and style.
Example: "A cyberpunk city at night with a slow camera push-in"
durationbodyinteger
Video duration in seconds. Applies to text, image reference, and first/last frame modes.
  • Default: 3
  • Supported range: 3-15
  • For video reference, image + video, and multi-image + video modes, duration follows the reference video material
ratiobodystring
Output aspect ratio. Applies to text, image reference, and first/last frame modes.
  • Default: 9:16
  • Available values: 1:1, 9:16, 16:9
  • For video reference, image + video, and multi-image + video modes, the aspect ratio follows the reference video material
referenceImagesbodyarray
Image reference URL array. This is the primary image input field for O3.
Rules:
  • Image-only reference: up to 7 images
  • With referenceVideos: up to 4 images
  • Do not use this field for first/last frame mode. Use first_image + last_image instead
Example: ["https://example.com/image1.jpg", "https://example.com/image2.jpg"]
first_imagebodystring
First frame image URL. Only used for first/last frame mode and must be paired with last_image.
last_imagebodystring
Last frame image URL. Only used for first/last frame mode and must be paired with first_image.
referenceVideosbodyarray
Video reference URL array. Supports up to 1 video. The reference video duration must be within 3-10 seconds.
When video reference is used, the generated duration and aspect ratio follow the reference video material.
Example: ["https://example.com/source.mp4"]

Modes

Text to Video

Provide model and prompt; duration and ratio are optional.

Image Reference

Use referenceImages to provide 1-7 reference images.

First/Last Frame

Use first_image and last_image to control the start and end frames.

Video Reference

Use referenceVideos to provide 1 reference video. The reference video duration must be within 3-10 seconds.

Image + Video

Use referenceImages with referenceVideos; images are limited to 4.

Multi-image + Video

Use multiple images and a reference video to constrain subject, style, and motion.

Constraints

Key constraints:
  • model only supports starvideos_o3
  • duration supports 3-15 seconds and defaults to 3
  • ratio supports 1:1, 9:16, and 16:9; default is 9:16
  • referenceImages supports up to 7 images, or up to 4 images when used with video reference
  • referenceVideos supports up to 1 video; the reference video duration must be within 3-10 seconds
  • first_image and last_image must be provided together
  • first_image / last_image cannot be used together with referenceImages or referenceVideos
Field note: For starvideos_o3, image input uses referenceImages, while first/last frame input uses first_image + last_image.

Response Parameters

idstring
Unique identifier for the video generation task, used for subsequent status queries.
objectstring
Object type, always video.
createdinteger
Task creation timestamp.
modelstring
Model name used for generation.
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
errorstring
Error message returned when the task status is failed.