← Back to catalog

Veo Reference

Live
videogenmotion

Veo video generation guided by reference images (up to 3).

Endpoint

POSThttps://brahmand-api.bulletshorts.co/v1/video/veo-reference

Authenticate with the X-API-Key request header.

Pricing

52 credits / sec1 credit = ₹1. Billed on success: per second of output.
Price varies by resolution — pass resolution in your request. Credit cost per second:
resolutioncredits / secvs base
480p370.7×
720p521×
1080p831.6×
4k1302.5×

List price. Volume / bulk customers get a discounted rate — contact us for account pricing.

Parameters

NameTypeRequiredDescriptionDefault / options
promptstringrequiredText prompt describing the desired output.
reference_image_urlsstring[]requiredUp to 3 reference images.
durationnumberoptionalClip length in seconds (1-8).
default: 8
aspect_ratiostringoptionalOutput aspect ratio.
default: 16:9
negative_promptstringoptionalThings to avoid in the output.
seednumberoptionalRNG seed (0-4294967295) to bias toward deterministic video.
enhance_promptbooleanoptionalLet Veo LLM-rewrite the prompt.
person_generationstringoptionalAllow people in output: dont_allow | allow_adult | allow_all.
default: allow_all
generate_audiobooleanoptionalGenerate audio for the video (Veo 3 family only; ignored on veo-2).

Request

curl
curl -X POST https://brahmand-api.bulletshorts.co/v1/video/veo-reference \
  -H "X-API-Key: $TRINETRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"the character walks through a forest","reference_image_urls":["https://example.com/char.jpg"],"duration":8}'
request body (JSON)
{
  "prompt": "the character walks through a forest",
  "reference_image_urls": [
    "https://example.com/char.jpg"
  ],
  "duration": 8
}

Response

Submitting a job returns 202 Accepted with a job id. Poll GET /v1/jobs/{id} until the job reaches a terminal state, or register a webhook to be notified.

202 Accepted
{
  "job_id": "job_veoreference_a1b2c3",
  "status": "queued"
}
GET /v1/jobs/{id} → succeeded
{
  "id": "job_veoreference_a1b2c3",
  "model": "veo-reference",
  "status": "succeeded",
  "output": {
    "outputs": [
      {
        "url": "https://cdn.trinetra.ai/out/veo-reference/a1b2c3.mp4",
        "type": "video"
      }
    ]
  },
  "credits_charged": 10
}

Webhook: set a webhook_url on your API key to receive a POST with the terminal job document instead of polling.