PixVerse C1 Reference To Video
From 36 credits/sec
ae_pixverse_c1_reference_to_video
Create a video from a prompt and reference images for characters, objects, or backgrounds, with controls for duration, framing, resolution, and optional audio.
From 36 credits/sec
Pricing
From 36 credits/sec
| Resolution | Generate audio: Disabled / Not specified | Generate audio: Enabled |
|---|---|---|
| 360p | 36 credits/second | 48 credits/second |
| 540p | 48 credits/second | 60 credits/second |
| 720p / Not specified | 60 credits/second | 78 credits/second |
| 1080p | 114 credits/second | 144 credits/second |
When duration is omitted, billing is based on five seconds. Starting price applies to Generate audio: Disabled, Resolution: 360p.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.seed | integer | unknown | No | The same seed and the same prompt given to the same version of the model will output the same video every time. | — |
request_body.prompt | string | Yes | The prompt for the reference-to-video generation. Use @ref_name to refer to uploaded references. | — |
request_body.duration | integer | No | The duration of the generated video in seconds (1-15) | 5 |
request_body.resolution | enum (360p | 540p | 720p | 1080p) | No | The resolution of the generated video | 720p |
request_body.aspect_ratio | enum (16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 2:3 | 3:2 | 21:9) | No | The aspect ratio of the generated video | 16:9 |
request_body.image_references | array | Yes | List of reference images with type and name. Use @ref_name in the prompt to refer to each reference. | — |
request_body.image_references[].type | enum (subject | background) | No | Type of reference: 'subject' for character/object references, 'background' for scene/environment references | subject |
request_body.image_references[].ref_name | string | Yes | A short name for this reference. Use @ref_name in the prompt to refer to this image. | — |
request_body.image_references[].image_url | string | Yes | URL of the reference image | — |
request_body.generate_audio_switch | boolean | No | Enable audio generation (BGM, SFX, dialogue) | false |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
Request coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_pixverse_c1_reference_to_video' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio_switch": false,
"image_references": [
{
"image_url": "https://agentearth.ai/fileserver/file/9581f3f7-12ec-4421-819f-4189ce0cbd63.jpg",
"ref_name": "lead",
"type": "subject"
},
{
"image_url": "https://agentearth.ai/fileserver/file/259f3eb8-6c25-4bb0-a7fa-d451cce46dcc.jpg",
"ref_name": "friendb",
"type": "subject"
},
{
"image_url": "https://agentearth.ai/fileserver/file/84de40a9-8802-417a-9032-f8e687d308e4.jpg",
"ref_name": "friendc",
"type": "subject"
}
],
"prompt": "Live-action surreal Chinese comedy, 16:9, inside the same canteen 六十七餐厅. The three friends @lead @friendb and @friendc sit at the round table with the plate of unfinished flowing liquid chocolate. Suddenly a whimsical cascade rains down from the ceiling above: many small cute creatures gently tumble all around them, tiny friendly dragons, little wolves, shiny silver fish and round pink piglets, bouncing softly onto the table and floor like a playful cartoon shower, completely harmless and cheerful, no gore and no injury. The three friends look up open-mouthed in astonishment and burst out laughing. Camera tilts up then back down, warm indoor light mixed with a soft magical glow, realistic-composite style, keep every face identity consistent, no subtitles, no text overlay.",
"resolution": "360p"
}
}
}'Response exampleresponse.json
{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "926fcf60-ef60-4254-8dcf-52fff2e759a3"
}Guides using this tool
See how this tool fits into real workflows




