PixVerse V6 API
Generate 720p frame transitions or new scenes from reference images, with optional native audio.
- no audio
- APIMart $0.032 / second
- Official
$0.0420% less - audio
- APIMart $0.04 / second
- Official
$0.053325% less
Compare prices
Compare public channel prices for the same output specification
Pricing notes
Billed by the channel that actually runs the job. Failover may switch channels, which can change cost and time.
Use the API
Hand the code to a coding agent, generate right in the chat with MCP or the Skill, or integrate yourself with the SDK or the OpenAI-compatible API.
Let a coding agent integrate it
Copy the integration prompt, or open it directly in Codex or Claude. The agent reads this page and the model contract, then writes submit, wait and result handling into your project.
Add the Yir MCP server
Connect it to ChatGPT, Claude or Cursor, then mention @Yir and ask for PixVerse V6 by name. It quotes first and only generates after you confirm.
https://gateway.yir.ai/mcpOne command for Claude Code
Create an API key in the console, set it as YIR_API_KEY, then run:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Install the Yir Skill
Set YIR_API_KEY where your agent runs, add the Skill to Claude Code, Codex or another coding agent, then say “use PixVerse V6 on Yir to make…”.
npx skills add yir-ai/skillsInstall the official SDK with your package manager, or copy the code snippet below to get started
| // Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL. |
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Submit a video generation job |
| const job = await client.submitVideo({ |
| model: "pixverse/pixverse-v6", |
| input: { |
| type: "image", |
| prompt: "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell", |
| references: [{ role: "first_frame", ...{ url: "https://example.com/your-reference-image.png" } }], |
| }, |
| parameters: { |
| duration: 5, |
| resolution: "720p", |
| aspect_ratio: "auto", |
| generate_audio: false, |
| n: 1, |
| }, |
| }); |
| // 2. Wait for the job to finish and deliver its result |
| const result = await client.waitForJob(job.id); |
| console.log("Delivered files:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Projects already on the OpenAI protocol, or gateways such as new-api, only need a new Base URL and key. OpenAI compatibility guide
- OpenAI SDK base_url
https://gateway.yir.ai/openai/v1- new-api channel Base URL
https://gateway.yir.ai/openai- Key
- Yir API key
- Model ID
pixverse/pixverse-v6
# Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL.
curl https://gateway.yir.ai/openai/v1/videos \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse/pixverse-v6",
"prompt": "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
"resolution": "720p",
"aspect_ratio": "auto",
"input_reference": {
"image_url": "https://example.com/your-reference-image.png"
},
"seconds": "5"
}'Parameter overview
Common parameters; limits depend on the current model and selected channel
- Resolution resolution
- 720p
Output resolution tier. Higher resolutions offer sharper pixel fidelity and scale pricing accordingly
- Aspect ratio aspect_ratio
- auto
Geometric aspect ratio. Choose according to target medium (portrait, banner, or square)
- Input mode input_mode
- Image input
- Reference input
Reference limits and formats depend on the model and selected channel
- Duration duration
- 5 seconds
- 8 seconds
Video output duration tier, billed per second or stepped tier
- Audio generate_audio
- Optional
Optional synchronized native audio generation track
- References references
- first_frame ≤ 2
- last_frame ≤ 2
- reference_image ≤ 7
Reference limits across input modes depend on the selected channel. Counts in the price table are examples, not input limits or free allowances.





