Bridge by Wekoya / Docs / Media

Video

Updated

Filmed-looking clips with sound, from a description and optionally a first frame, by Google's Veo, and talking videos of a person from a picture and a voice recording, by Creatify's Aurora, on POST /v1/videos/generations. A video takes from about ten seconds to a few minutes, so you get an id at once and ask for it with GET /v1/videos/generations/<id> until status is succeeded or failed; or listen for the video.succeeded and video.failed webhooks.

# Start a video: answered at once with an id
curl https://wekoya-api.wekoya.tech/v1/videos/generations \
  -H "Authorization: Bearer $WEKOYA_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model": "veo-3.1-fast", "prompt": "A chef plating jollof rice in a busy Lagos kitchen, close-up",
        "duration_seconds": 8, "aspect_ratio": "9:16" }'

{ "id": "video_8f1c…", "object": "video.generation", "status": "queued", "held": { "amount": 4212, "currency": "NGN" }, … }

# Ask until it is done (every 10 seconds is plenty; most take 20 s to 2 min)
curl https://wekoya-api.wekoya.tech/v1/videos/generations/video_8f1c… -H "Authorization: Bearer $WEKOYA_API_KEY"

{ "id": "video_8f1c…", "status": "succeeded", "duration_seconds": 8, "aspect_ratio": "9:16", "resolution": "720p",
  "video": { "url": "https://wekoya-api.wekoya.tech/files/videos/8f1c….mp4?token=…",
             "mime_type": "video/mp4", "expires_at": "2026-10-18T15:02:11.000Z" },
  "wekoya": { "cost": 4212, "currency": "NGN" } }

Talking videos (Aurora)

With model: "creatify-aurora", send image, a picture of the person or character, and audio, the recording they speak (MP3 or WAV, up to 60 seconds), each as base64, a data URL or an https address. The video is as long as the recording, takes the picture's shape, and moves the face, eyes and body with the voice. resolution: 720p (the default) or 480p. Leave out prompt, duration_seconds and aspect_ratio. Make the recording with POST /v1/audio/speech to turn a script into a talking video.

# A talking video: a picture of the person, and the recording they speak
curl https://wekoya-api.wekoya.tech/v1/videos/generations \
  -H "Authorization: Bearer $WEKOYA_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model": "creatify-aurora", "resolution": "720p",
        "image": "https://example.com/presenter.jpg",
        "audio": "https://example.com/welcome.mp3" }'

{ "id": "video_3a9d…", "object": "video.generation", "model": "creatify-aurora", "status": "queued",
  "duration_seconds": 12, "held": { "amount": 7076.16, "currency": "NGN" }, … }

The video

video.url plays in a <video> tag or a browser with no key, and seeking works. It stops working at expires_at, two days after the video was made: Bridge keeps no copy, so download it and store it yourself if you need it longer. With your key, GET /v1/videos/generations/<id>/content returns the same file. GET /v1/videos/generations lists your recent videos. Up to 10 at once per account.

What it costs

Per second of video, by model and resolution (Aurora: per second of the recording, rounded up, at least 3 seconds): see Models & pricing, or GET /v1/models?type=video. The price for the seconds you ask for is held when the video starts and charged when it is made. A video that fails or is blocked by the safety rules costs nothing (error.code says which: content_policy, generation_failed or timed_out). Guest keys need the videos use.