Swap one or more face images onto a driving motion-template video (DreamActor M2.0).
Authenticate with the X-API-Key request header.
resolution — pass resolution in your request. Credit cost per second:| resolution | credits / sec | vs base |
|---|---|---|
| 480p | 7 | 0.7× |
| 720p | 10 | 1× |
List price. Volume / bulk customers get a discounted rate — contact us for account pricing.
| Name | Type | Required | Description | Default / options |
|---|---|---|---|---|
| image_url | string | required | Face image to map onto the motion template. (Use image_urls for multiple faces.) | — |
| image_urls | string[] | optional | One or more face images (alternative to image_url). | — |
| video_url | string | required | Motion-template video (the driving performance). | — |
| prompt | string | optional | Optional text guidance. | — |
| duration | number | optional | Output length in seconds (1-30). | default: 5 |
| resolution | string | optional | Output resolution. | default: 720p480p720p |
curl -X POST https://brahmand-api.bulletshorts.co/v1/video/dreamactor-m2 \
-H "X-API-Key: $TRINETRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url":"https://example.com/face.jpg","video_url":"https://example.com/motion-template.mp4","prompt":"Professional dance performance","duration":8,"resolution":"720p"}'{
"image_url": "https://example.com/face.jpg",
"video_url": "https://example.com/motion-template.mp4",
"prompt": "Professional dance performance",
"duration": 8,
"resolution": "720p"
}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.
{
"job_id": "job_dreamactorm2_a1b2c3",
"status": "queued"
}{
"id": "job_dreamactorm2_a1b2c3",
"model": "dreamactor-m2",
"status": "succeeded",
"output": {
"outputs": [
{
"url": "https://cdn.trinetra.ai/out/dreamactor-m2/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.