Seedance 2.0 reference-API: programmatische multimodale video

Programmatische toegang tot multimodale AI-video verandert wat mogelijk is. Losse clips zijn prima voor marketing en contentcreatie, maar geautomatiseerde workflows zoals catalogusvideogeneratie, gepersonaliseerde video per gebruiker en batch-contentverwerking vereisen API-toegang.

De Seedance 2.0 Reference API biedt de volledige multimodale mogelijkheden: tot 9 afbeeldingen, 3 video's en 3 audiofragmenten per aanvraag, programmatisch, tegen dezelfde prijs per seconde als de webinterface.

Wanneer gebruik je de API

De webinterface is ideaal voor handmatig, creatief werk. De API is voor al het andere.

De API is geschikt als je nodig hebt:

• Batchgeneratie over honderden assets
• Integratie met bestaande content- of productpipelines
• Gepersonaliseerde video per gebruiker in een applicatie
• Geautomatiseerde A/B-tests van advertentievarianten
• Geplande contentgeneratie voor dagelijkse publicatie
• Catalogusworkflows gekoppeld aan databaserecords

Blijf bij de webinterface als:

• Je creatief aan het itereren bent en elk resultaat wilt zien en aanpassen
• Het volume laag is (minder dan 10-20 clips per sessie)
• Je de tool voor het eerst verkent

Het endpoint

Het Reference-to-video-endpoint is:

bytedance/seedance-2.0/reference-to-video

Dit is het enige endpoint dat je nodig hebt voor multimodale Reference-modegeneraties. Één aanvraag verwerkt tekst, tot 9 afbeeldingen, tot 3 video's en tot 3 audiofragmenten. Het model combineert alle invoer en geeft een gegenereerde video terug.

Gebruik voor tekst-naar-video- of enkele-afbeeldingworkflows de standaard Seedance 2.0 API-endpoints.

Aanvraagstructuur

Een typische Reference-to-video-aanvraag bevat:

• prompt: Tekstbeschrijving van onderwerp en actie (verplicht)
• reference_images: Array van maximaal 9 afbeeldings-URL's of bestandsreferenties
• reference_videos: Array van maximaal 3 video-URL's (optioneel)
• reference_audio: Array van maximaal 3 audio-URL's (optioneel)
• duration: Uitvoerduur in seconden, 4-15 (verplicht)
• aspect_ratio: Een van 16:9, 9:16, 1:1 (verplicht)

Invoerbestanden kunnen worden opgegeven als URL's (openbaar toegankelijk) of direct worden geüpload, afhankelijk van je integratiemethode.

Prijzen via de API

De API-prijzen komen exact overeen met de prijzen van de webinterface:

Er zijn geen API-toegangskosten en geen extra kosten voor referentie-uploads. Je betaalt alleen voor gegenereerde uitvoerseconden.

Credits werken op dezelfde manier via de API en de webinterface. Vul ze bij via de prijzenpagina, en dezelfde creditpool wordt door beide interfaces gebruikt. Voor intensief API-gebruik biedt het Studio-plan van $120 (1.800 credits per maand) de beste prijs per credit, en aanvullende credits die je koopt verlopen nooit.

Begin met bouwen via de API. Ontvang API-toegang met 10 gratis credits bij aanmelding. Gratis beginnen.

Voorbeelden van toepassingen

Catalogusvideo-automatisering

Voor e-commerceplatforms met honderden of duizenden SKU's kun je via de API voor elk product een korte productvideo genereren op basis van bestaande productafbeeldingen.

Workflow:

1. Vraag je productdatabase op
2. Haal voor elk product 5-7 productafbeeldingen op
3. Combineer ze met een merkbrede referentiebundel (2-3 afbeeldingen)
4. Roep de API aan met een promptsjabloon voor productpresentatie
5. Sla de teruggegeven video-URL op in je productrecord
6. Toon op productdetailpagina's

Economie: Een catalogus van 500 SKU's met video's van 5 seconden = 500 × 303 credits = 151.500 credits = ~$1.515. Voor een catalogusbrede video-uitrol is dat een opmerkelijke prijs-kwaliteitverhouding.

Gepersonaliseerde videogeneratie

Voor apps die per gebruiker gepersonaliseerde video leveren, zoals wenskaarten, feestcontent of onboarding-intro's, kun je via de API on-demand video's genereren met gebruikersspecifieke referenties.

Workflow:

1. De gebruiker uploadt 3-5 persoonlijke foto's (met toestemming)
2. Je app combineert ze met een stijlreferentiebundel
3. Een API-aanroep genereert een gepersonaliseerd videofragment
4. Lever het via je app aan de gebruiker

Dit schaalt naar tienduizenden gebruikers zonder extra overhead voor een contentteam.

Generatie van advertentievarianten

Marketingteams die betaalde sociale advertenties inzetten, hebben voortdurend creatieve varianten nodig. Met de API kun je A/B-testvarianten programmatisch genereren.

Workflow:

1. Stel een merkrferentiebundel samen (6-8 afbeeldingen)
2. Schrijf promptsjablonen voor verschillende advertentiehoeken
3. Loop door de varianten en roep de API aan voor elke variant
4. Lever de gegenereerde clips aan je advertentieplatform
5. Volg de prestaties en genereer winnaars op schaal

Je kunt 50 advertentievarianten produceren in een geautomatiseerde run voor ~$150 aan API-kosten, tegenover traditionele productie van duizenden dollars per variant.

Responsverwerkring

API-reacties bevatten doorgaans:

• Generatie-ID: Volg de status van de aanvraag
• Status: pending, processing, complete, failed
• Uitvoer-URL: Beschikbaar zodra de status 'complete' is
• Metadata: Duur, resolutie, bestandsgrootte

Reference-modegeneraties duren 60-180 seconden, dus je integratie moet asynchrone reacties kunnen verwerken. Peil het statusendpoint of gebruik webhooks (indien beschikbaar in je account) om een melding te ontvangen bij voltooiing.

Blokkeer gebruikersgerichte flows niet op het voltooien van de generatie. Zet de aanvraag in de wachtrij, stel de gebruiker op de hoogte zodra het klaar is, en lever asynchroon.

Limieten en gelijktijdigheid

Voor de meeste accountniveaus gelden limieten voor gelijktijdige generaties. Plan je batchworkflows zodat ze de limieten respecteren: zet aanvragen in de wachtrij en verwerk ze met de toegestane gelijktijdigheid.

Voor grootschalige productieWorkflows kun je contact opnemen met platformondersteuning over enterprise-gelijktijdigheidslimieten. De meeste standaardaccounts kunnen een gematigd batchvolume aan (10-30 gelijktijdige generaties) zonder problemen.

Verificatie en sleutels

API-toegang maakt gebruik van standaard sleutelgebaseerde verificatie. Genereer je API-sleutel in je accountinstellingen na het aanmelden. Bewaar sleutels alleen server-side en stel ze nooit bloot in clientcode.

Idempotentie en herhaalpogingen

API-generaties zijn niet van nature idempotent, omdat elke aanroep credits kost. Als een generatie halverwege mislukt, moet de herhaalpogingslogica de status van de mislukte generatie controleren voordat er opnieuw wordt aangevraagd. Een mislukte generatie verbruikt doorgaans geen credits, maar controleer dit altijd in je accountdashboard.

Implementeer voor productieWorkflows:

• Herhaalpogingslogica met exponentiële vertraging bij tijdelijke fouten
• Statuspeilingen of webhookverwerking voor asynchrone voltooiing
• Foutregistratie om systematische problemen op te sporen
• Bewaking van het creditsaldo om te waarschuwen voordat je door je credits heen bent

Aanbevolen werkwijzen voor programmatische workflows

1. Gebruik consistente referentiebundels. Gebruik voor catalogus- of serieswerk een hash van je referentiebundels, zodat identieke bundels over aanvragen heen een consistentere stijl opleveren.

2. Houd promptsjablonen eenvoudig. Programmatische prompts moeten worden gegenereerd vanuit gestructureerde gegevens, niet handmatig per aanroep worden geschreven. Sjabloon plus gegevensvelden is het juiste patroon.

3. Cache referentiebestands-URL's. Als je URL-gebaseerde referenties gebruikt, zorg er dan voor dat de URL's stabiel en toegankelijk zijn. Verlopen S3-URL's of verplaatste bestanden laten generaties mislukken.

4. Ga op de juiste manier om met contentveiligheid. Het platform heeft contentveiligheidsfilters. Bouw een goede afhandeling in je workflow in voor aanvragen die door het filter worden afgewezen.

5. Registreer generatiemetadata. Houd elke generatie bij: prompt, referentieset, duur, verbruikte credits, uitvoer-URL. Sla dit op in je applicatiedatabase. Dit maakt debuggen en rapporteren veel eenvoudiger.

Voorbeeld van een batchworkflow

Pseudocode voor een batchworkflow voor productvideogeneratie:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} product rotates slowly on a clean surface, soft studio lighting, 5 seconds"

    response = seedance_api.generate(
        endpoint="bytedance/seedance-2.0/reference-to-video",
        prompt=prompt,
        reference_images=references,
        duration=5,
        aspect_ratio="16:9"
    )

    generation_id = response.id
    queue_poll_task(generation_id, product.id)

Een opvolgende poller verwerkt de voltooiing en slaat de uitvoer-URL op bij het productrecord.

Bewaking en kostenbeheer

Stel voor productie-API-gebruik kostenbewaking in:

• Dagelijkse budgetwaarschuwingen: Waarschuw wanneer de dagelijkse API-uitgaven een drempel overschrijden
• Caps per workflow: Beperk batchjobs tot een maximale credituitgave om ongecontroleerde automatisering te voorkomen
• Gebruiksdashboards: Volg welke workflows de meeste credits verbruiken
• Creditsaldowaarschuwingen: Vul aan voordat je door je credits heen bent

Deze vangrails voorkomen verrassingen wanneer je automatisering opschaalt.

Prijspariteit: API versus webinterface

Een veelgestelde vraag: is er korting voor API-gebruik? Nee. Zowel de API als de webinterface rekenen hetzelfde bedrag van $0.3024 per seconde. De API wordt geprijsd op basis van het geleverde werk, niet de interface die je gebruikt.

Grote volumes gebruikers besparen via hun abonnementskeuze. Intensieve API-gebruikers kunnen het beste draaien op het $120 Studio-abonnement voor de beste waarde per dollar.

Aan de slag met de API

1. Meld je aan via arteza.ai (10 gratis credits)
2. Genereer je API-sleutel in de accountinstellingen
3. Koop een creditpakket dat past bij je verwachte volume
4. Integreer het endpoint in je applicatie
5. Begin met kleine testbatches om je workflow te valideren
6. Schaal op naar productie zodra alles getest is

De eerste API-aanroep kan binnen een uur na aanmelding live zijn voor de meeste integraties.

Verder lezen

Lees voor de volledige Reference-functieset de Volledige gids voor Seedance 2.0 Reference. Voor de webinterfaceworkflow, zie de tutorial voor consistente stijl. Voor standaard Seedance 2.0 API-details, raadpleeg de Seedance 2.0 API-gids.

Programmatische multimodale video is er. Bouw er iets nieuws mee.