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.

VideoAudio
From 36 credits/sec

Pricing

From 36 credits/sec
ResolutionGenerate audio: Disabled / Not specifiedGenerate audio: Enabled
360p36 credits/second48 credits/second
540p48 credits/second60 credits/second
720p / Not specified60 credits/second78 credits/second
1080p114 credits/second144 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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNo The same seed and the same prompt given to the same version of the model will output the same video every time. —
request_body.promptstringYesThe prompt for the reference-to-video generation. Use @ref_name to refer to uploaded references.—
request_body.durationintegerNoThe duration of the generated video in seconds (1-15)5
request_body.resolutionenum (360p | 540p | 720p | 1080p)NoThe resolution of the generated video720p
request_body.aspect_ratioenum (16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 2:3 | 3:2 | 21:9)NoThe aspect ratio of the generated video16:9
request_body.image_referencesarrayYesList of reference images with type and name. Use @ref_name in the prompt to refer to each reference.—
request_body.image_references[].typeenum (subject | background)NoType of reference: 'subject' for character/object references, 'background' for scene/environment referencessubject
request_body.image_references[].ref_namestringYesA short name for this reference. Use @ref_name in the prompt to refer to this image.—
request_body.image_references[].image_urlstringYesURL of the reference image—
request_body.generate_audio_switchbooleanNoEnable audio generation (BGM, SFX, dialogue)false

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit 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
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