⌘K

Spark Actor Imitation

spark_actor_imitation

Input an image and a template video, can drive the person in the image according to the template video's actions/expressions/lip-sync, maintaining consistency with the input image's subject and background characteristics

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request.

Value: spark_actor_imitation


video_url string required

Reference video URL


image_url string required

Image URL


Polling

Since video generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error object

Error information. Only present when status is failed.

code string

Error code

error_message string

Detailed error message


output array

Generation results. Only present when status is completed.

content array

List of generated content

type string

Resource type, e.g., video, image

url string

Generated content URL


usage object

Usage statistics. Only present when status is completed.

cost string

Total cost in USD

discount number

Discount amount


metadata object

Metadata information


Error Codes

Error CodeDescription
003017001Reference video URL missing
003017002Image URL missing
003017095Internal generation error
003017096Result parsing error
003017097HTTP error response
003017098Status check error
003017099Task creation error/Service unavailable