API docs / Video models

Rap Duo AI API

Two selfies become a 12-second rap duet music video with an original beat and lip-synced verses.

Model id
voor/rap-duo
Provider
Voor
Output
Video
Price
Depends on the options; the same as on voor.ai.

Request

POST https://voor.ai/v1/generations with "model": "voor/rap-duo". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "voor/rap-duo",
  "input": {
    "reference_images": [
      "https://example.com/input.png"
    ],
    "aspect_ratio": "9:16",
    "language": "English",
    "stage": "Orange booth"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
reference_imagesrequiredarray of URLs

Upload two different photos, one person in each. Photo 1 raps first on the left; photo 2 answers on the right.

Up to 2 files · Accepts image/*

aspect_ratiorequiredstring

12-second music video with generated vocals and beat.

Default: 9:16

One of: 9:16, 16:9

languagerequiredstring

Language of both verses.

Default: English

One of: English, Chinese, Spanish, Portuguese, French, Italian

stagerequiredstring

Where the two of you perform.

Default: Orange booth

One of: Orange booth, Luxury lobby, Studio booth, Street cypher