Video's genereren

Maak video's met Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse en MiniMax op basis van een prompt, een eerste frame (en eventueel een laatste), van referentieafbeeldingen, video's en audio. Video's maken duurt een paar minuten, dus je start de generatie en vraagt later de status op.

Starten, status opvragen, downloaden

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

Elk videomodel werkt hetzelfde: wijzig model en de aanvraag blijft verder gelijk. De modelgidsen leggen uit waar elk model het best in is: Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu en PixVerse.

Parameters

Beginnen met afbeeldingen

Eerste en laatste frame

Animeer een stilstaand beeld: de video begint precies met first_frame. Voeg last_frame toe om op die afbeelding te eindigen, zodat je beide uiteinden van de opname bepaalt. MiniMax starts in plaats daarvan op basis van referentieafbeeldingen.

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

Referentieafbeeldingen

Geef maximaal 10 afbeeldingen op (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu en PixVerse take none) en verwijs er in de prompt op volgorde naar (@Image1, @Image2…): de mensen, producten en plekken erop verschijnen in de video.

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

Referentievideo's en -audio

Geef video's op om iemands uiterlijk en bewegingen, een camerabeweging of een scène over te nemen, en audio voor een stem, melodie of geluidseffecten. Verwijs er in de prompt op volgorde naar, net als bij afbeeldingen: @Video1, @Audio1. Je kunt ze combineren met referentieafbeeldingen, maar niet met een eerste frame.

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

Het model leest elke seconde van een referentievideo, dus die seconden worden ook in rekening gebracht, tegen een deel van de prijs per seconde: een video van 5 s met een referentie van 10 s kost 5 seconden plus 10 referentieseconden. Referentieaudio kost niets extra. Elk video-object toont de in rekening gebrachte referentieseconden (reference_seconds).

Een video bewerken en verlengen

Stel reference_mode in op edit om een referentievideo te wijzigen (een persoon of object vervangen, iets toevoegen of verwijderen, de muziek veranderen), of op extend om die aan het einde of begin te verlengen. Beschrijf in de prompt wat er moet gebeuren: “Vervang de auto in @Video1 door die in @Image1”, “Laat @Video1 doorgaan terwijl de danser het podium verlaat”.

• Een bewerking behoudt de beeldverhouding en lengte van de video, dus laat aspect_ratio en seconds weg. De prijs wordt berekend op basis van de langste referentievideo, die 4 tot 30 seconden moet duren.
• Een verlenging behoudt de beeldverhouding van de video; seconds bepaalt hoelang de nieuwe video duurt.
• Zonder reference_mode beslist het model op basis van de prompt. Een prompt die als een bewerking klinkt, kan mislukken als seconds of aspect_ratio is ingesteld (mislukte video's zijn gratis).

Regels voor afbeeldingen

• PNG, JPEG of WebP, als openbare https-link of data-URL, tot 10 MB.
• 300 tot 6000 pixels per zijde, en niet breder of hoger dan 5:2. Data-URL's die hier niet aan voldoen, worden direct geweigerd met een bericht dat uitlegt waarom. Links worden gelezen zodra de video start: als een link geen bruikbare afbeelding oplevert, mislukt de video met invalid_image, zonder kosten.
• Frames of referenties, niet beide in één request.
• Requests zijn JSON: je geeft afbeeldingen mee als links of data-URL's, niet als multipart-uploads.

Het video-object

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

Andere endpoints

Betalen voor video

Een video kost de prijs per seconde (afhankelijk van de resolutie) maal de lengte; Kling en PixVerse cost minder per seconde zonder geluid; de seconden van referentievideo's tellen mee tegen een deel van dat tarief. Als je een video start, wordt dat bedrag gereserveerd op je saldo; het wordt afgeschreven zodra de video klaar is en vrijgegeven als de video mislukt. Een mislukte video is gratis.