> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # SkyReels Segmented Camera Motion > **[Core Function]** SkyReels Segmented Camera Motion (audio-to-video) generates a talking-avatar video with directed camera movement across time segments. **[Strengths]** Combines an audio-driven avatar with per-segment camera trajectories such as push, pan, crane and rotation. **[Best For]** Dynamic presenter clips and cinematic avatar shots with controlled camera motion. **[Limitations]** Do NOT use this when you need a completely static camera (use single-actor-avatar). It requires first_frame_image and one audio segment; use camera_control_pro for multi-segment or compound moves. mode=std outputs 720p, mode=pro outputs 1080p. **[Routing]** Set a single traj_type plus camera_control_strength for a simple move, or supply camera_control_pro (a list of per-segment {start_time, end_time, traj_type, ...}) for compound motion; choose mode=pro for 1080p. ## OpenAPI ````yaml /model-api/skywork/skyreels-i2v.json post /skywork/segmented-camera-motion openapi: 3.1.0 info: description: >- The image-to-video models API from SkyReels (Skywork). Includes keyframe image-to-video, multi-subject reference-to-video, and audio-driven talking-avatar generation. Tasks are asynchronous: submit, then poll the task endpoint for the result. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: SkyReels Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from SkyReels (Skywork). security: - bearerAuth: [] paths: /skywork/segmented-camera-motion: post: summary: SkyReels Segmented Camera Motion description: >- **[Core Function]** SkyReels Segmented Camera Motion (audio-to-video) generates a talking-avatar video with directed camera movement across time segments. **[Strengths]** Combines an audio-driven avatar with per-segment camera trajectories such as push, pan, crane and rotation. **[Best For]** Dynamic presenter clips and cinematic avatar shots with controlled camera motion. **[Limitations]** Do NOT use this when you need a completely static camera (use single-actor-avatar). It requires first_frame_image and one audio segment; use camera_control_pro for multi-segment or compound moves. mode=std outputs 720p, mode=pro outputs 1080p. **[Routing]** Set a single traj_type plus camera_control_strength for a simple move, or supply camera_control_pro (a list of per-segment {start_time, end_time, traj_type, ...}) for compound motion; choose mode=pro for 1080p. operationId: segmentedCameraMotionAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CameraMotionRequest' examples: simple: summary: Single trajectory value: prompt: A woman singing in a recording studio first_frame_image: https://example.com/portrait.png audios: - https://example.com/voice.wav traj_type: push_in camera_control_strength: 0.8 compound: summary: Per-segment compound motion value: prompt: A woman singing in a studio first_frame_image: https://example.com/portrait.png audios: - https://example.com/voice.wav camera_control_pro: - start_time: 0 end_time: 2 traj_type: push_in camera_control_strength: 0.7 - start_time: 2 end_time: -1 traj_type: static camera_control_strength: 0.5 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-skyreels-camera-001 model_id: skyreels/segmented-camera-motion get_result: method: GET url: >- https://api.modellix.ai/api/v1/tasks/task-skyreels-camera-001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CameraMotionRequest: type: object required: - prompt - first_frame_image - audios description: >- SkyReels segmented camera-motion request (image + audio + camera trajectories). properties: prompt: type: string minLength: 1 description: Text description of the video (max 512 tokens). example: A woman singing in a recording studio first_frame_image: type: string minLength: 1 description: Portrait image URL (jpg/jpeg/png/gif/bmp). example: https://example.com/portrait.png audios: type: array minItems: 1 maxItems: 1 description: Exactly one audio URL (mp3/wav, each segment <=200s). items: type: string minLength: 1 example: - https://example.com/voice.wav traj_type: type: string enum: - static - push_in - push_out - pan_left - pan_right - crane_up - crane_down - swing - left_rotation - right_rotation description: >- Single camera trajectory; omit to leave unspecified. Takes effect together with camera_control_strength when camera_control_pro is not used. example: push_in camera_control_strength: type: number minimum: 0 maximum: 1 default: 0.8 description: Strength of the single camera trajectory. example: 0.8 camera_control_pro: type: array description: >- Per-segment compound camera motion. When provided, overrides the single traj_type. items: $ref: '#/components/schemas/CameraControlPro' mode: type: string enum: - std - pro default: std description: 'Output mode: std returns 720p, pro returns 1080p.' example: std AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier for polling example: task-abc123 model_id: type: string description: Model ID in `provider/model` format example: skyreels/skyreels-i2v get_result: type: object description: API information to query the task result properties: method: type: string example: GET url: type: string example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. CameraControlPro: type: object required: - start_time - end_time - traj_type description: >- A single camera-motion segment. start_time/end_time ranges must not overlap; end_time=-1 keeps the motion to the end of the clip. properties: start_time: type: number description: Segment start time in seconds. example: 0 end_time: type: number description: Segment end time in seconds; -1 means to the end of the clip. example: 2 traj_type: type: string enum: - static - push_in - push_out - pan_left - pan_right - crane_up - crane_down - swing - left_rotation - right_rotation description: Primary camera trajectory for this segment. example: push_in camera_control_strength: type: number minimum: 0 maximum: 1 default: 0.8 description: Strength of the primary trajectory. example: 0.7 traj_type_2: type: string enum: - static - push_in - push_out - pan_left - pan_right - crane_up - crane_down - swing - left_rotation - right_rotation description: Optional second trajectory to combine (dual-motion). example: crane_up camera_control_strength_2: type: number minimum: 0 maximum: 1 description: Strength of the second trajectory. example: 0.4 ErrorResponse: type: object required: - code - message properties: code: type: integer example: 400 message: type: string example: 'Invalid parameters: parameter ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''prompt'' is required' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````