PixMind Docs
Api referenceVideo ModelsVeo 3.1 Video Generation

Veo 3.1 Video Generation

Generate cinematic text- or image-guided video with synchronized audio through the PixMind API.

Cinematic text- or image-guided video generation with synchronized audio and endpoint-frame control.

Provider

Google

Model ID

veo-3.1

Endpoint

POST /v1/generations

Model notes

  • The current quality route supports clips up to 8 seconds.
  • 4K uses a higher per-second pricing tier.

Request parameters

ParameterTypeRequiredDescription
modelstringYes

Stable PixMind model ID. Use `veo-3.1`.

Allowed values: veo-3.1

promptstringYes

Natural-language generation or editing instructions.

resolutionstringNo

Output video resolution. This field affects per-second pricing.

Allowed values: 720p, 1080p, 4K

Default: 720p

durationintegerNo

Requested clip duration in seconds.

Allowed values: 5, 6, 8

Default: 5

aspect_ratiostringNo

Requested output aspect ratio.

Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4

Default: 16:9

image_urlstring (URI)No

Starting image for image-to-video generation.

callback_urlstring (URI)No

HTTPS endpoint that receives the terminal task event. Polling remains available when omitted.

last_frame_urlstring (URI)No

Optional ending-frame image used with image_url.

generate_audiobooleanNo

Generate synchronized audio when supported by the selected mode.

Allowed values: true, false

Default: true

Request example

cURL
curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1",
  "prompt": "A cinematic product reveal with a slow camera push and synchronized studio ambience",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'
JavaScript
const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "veo-3.1",
  "prompt": "A cinematic product reveal with a slow camera push and synchronized studio ambience",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
})
});

const task = await response.json();

Accepted task response

Generation is asynchronous. Save the id from the response and poll GET /v1/generations/{id} until it reaches a terminal status.

202 Accepted
{
  "id": "img_01JXYZ...",
  "model": "veo-3.1",
  "status": "processing"
}

API pricing

ConfigurationPrice
720p or 1080p$0.360 / second
4K$0.520 / second

API pricing uses the apiPlatform role and is separate from PixMind Studio credits. The accepted task response is the final pricing snapshot.