Seedance 2.0 Reference API: Programmatische Multi-Modale Video

Programmatische toegang tot multi-modale AI-video verandert wat mogelijk is. Eenmalige clips zijn geweldig voor marketing en content creation, maar geautomatiseerde workflows - catalogusvideogenerering, personalisatie per gebruiker, batchcontentbewerkingen - vereisen API-toegang.

De Seedance 2.0 Reference API stelt de volledige multi-modale mogelijkheid bloot: tot 9 afbeeldingen, 3 video's en 3 audioclips per verzoek, programmatisch, tegen dezelfde per-seconde-prijsstelling als de webinterface.

Wanneer de API gebruiken

Web UI is geweldig voor handmatig, eenmalig creatief werk. De API is voor al het andere.

API past wanneer je nodig hebt:

• Batchgenerering over honderden assets
• Integratie met bestaande content- of productpipelines
• Gepersonaliseerde video per gebruiker in een applicatie
• Geautomatiseerde A/B-testen van advertentiecreatiefvarianten
• Geplande contentgenerering voor dagelijkse publicatie
• Catalogusworkflows gekoppeld aan databaserecords

Blijf bij de web UI wanneer:

• Je creatief aan het itereren bent en elke output wilt zien/aanpassen
• Het volume laag is (minder dan 10-20 clips per sessie)
• Je het gereedschap voor het eerst verkent

Het eindpunt

Het Reference-to-video eindpunt is:

bytedance/seedance-2.0/reference-to-video

Dit is het enige eindpunt dat je nodig hebt voor multi-modale Reference-modus generaties. Een enkel verzoek verwerkt tekst, tot 9 afbeeldingen, tot 3 video's en tot 3 audioclips. Het model voegt alle inputs samen en retourneert een gegenereerde video.

Gebruik voor tekst-naar-video of single-image workflows de standaard Seedance 2.0 API eindpunten in plaats daarvan.

Verzoekstructuur

Een typisch Reference-to-video verzoek omvat:

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

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

Prijsstelling via de API

API-prijsstelling komt exact overeen met web UI-prijsstelling:

Er is geen API-toegangsvergoeding en geen extra kosten voor referentie-uploads. Je betaalt alleen voor gegenereerde outputseconden.

Credits werken op dezelfde manier via API en web UI. Aanvullen via de prijzenpagina en dezelfde creditpool wordt gebruikt door beide interfaces. Voor API-gebruik met hoog volume is de Max tier van $100 (12.000 credits) het meest economisch.

Begin met het bouwen met de API. Krijg API-toegang met 50 gratis credits bij aanmelding. Gratis starten.

Voorbeelden van gebruikssituaties

Automatisering van catalogusvideo

Voor e-commerceplatformen met honderden of duizenden SKU's stelt de API je in staat om voor elk product een korte productvideo te genereren op basis van bestaande productafbeeldingen.

Workflow:

1. Query je productdatabase
2. Voor elk product, haal 5-7 productafbeeldingen op
3. Combineer met een merkbrede referentiebundel (2-3 afbeeldingen)
4. Roep de API aan met promptsjabloon voor productopenbaring
5. Bewaar de geretourneerde video-URL in je productrecord
6. Serveer op productdetailpagina's

Economie: 500-SKU-catalogus met 5-seconde video's = 500 × 303 credits = 151.500 credits = ~$1.515. Voor een catalogusbrede video-rollout is dat opmerkelijke waarde.

Gepersonaliseerde videogenerering

Voor apps die gepersonaliseerde video per gebruiker leveren - wenskaarten, vieringscontent, onboarding-intro's - stelt de API je in staat om on-demand video's met gebruikersspecifieke referenties te genereren.

Workflow:

1. Gebruiker uploadt 3-5 persoonlijke foto's (met toestemming)
2. Je app combineert ze met een stijlreferentiebundel
3. API-aanroep genereert een gepersonaliseerde videoclip
4. Lever aan de gebruiker via je app

Dit schaalt naar tienduizenden gebruikers zonder overhead van contentteams.

Generering van advertentiecreatiefvarianten

Marketingteams die betaalde social uitvoeren, hebben voortdurend creatieve varianten nodig. De API stelt je in staat om A/B-testvarianten programmatisch te genereren.

Workflow:

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

Je kunt 50 advertentiivarianten in een geautomatiseerde uitvoering produceren voor ongeveer $150 in API-kosten, versus traditionele productie aan duizenden per variant.

Responseafhandeling

API-responses bevatten doorgaans:

• Generation ID: Volg de requeststatus
• Status: pending, processing, complete, failed
• Output URL: Beschikbaar zodra status voltooid is
• Metadata: Duur, resolutie, bestandsgrootte

Reference-modus generaties nemen 60-180 seconden in beslag, dus je integratie moet asynchrone responses verwerken. Poll het statusendpunt of gebruik webhooks (indien beschikbaar in je account) om op voltooiing te worden geïnformeerd.

Blokkeer geen gebruikersgericht stromen op voltooiing van generatie. Zet het verzoek in de wachtrij, stel de gebruiker in kennis wanneer gereed, en lever asynchroon.

Tarieflimieten en gelijktijdigheid

Voor de meeste accounttiersniveaus gelden gelijktijdige generatielimieten. Plan je batchworkflows om de limieten te respecteren - zet verzoeken in de wachtrij en verwerk ze met toegestane gelijktijdigheid.

Voor workflows met hoog volume in productie, neem contact op met platformondersteuning over gelijktijdigheidslimieten voor ondernemingen. De meeste standaardaccounts kunnen gematigde batchwerk (10-30 gelijktijdige generaties) zonder problemen verwerken.

Verificatie en sleutels

API-toegang gebruikt standaardverificatie op basis van sleutel. Genereer je API-sleutel in je accountinstellingen na aanmelding. Houd sleutels uitsluitend aan serverzijde - plaats ze nooit in clientcode.

Idempotentie en pogingen

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

Voor productieworkflows, implementeer:

• Logica opnieuw proberen met exponentiële backoff bij voorbijgaande fouten
• Statuspolling of webhookafhandeling voor asynchrone voltooiing
• Foutregistratie om systematische problemen op te vangen
• Creditbalansmonitoring om waarschuwing te geven voordat je leegraakt

Best practices voor programmatische workflows

1. Gebruik consistente referentiebundels. Voor catalogus- of seriewerk, hash je referentiebundels zodat identieke bundels over verzoeken heen consistentere stijl produceren.

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

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

4. Behandel contentsafety op passende wijze. Het platform heeft contentveiligheidsfilters. Bouw elegante afhandeling voor door filter afgewezen verzoeken in je workflow.

5. Log generatiemetadata. Volg elke generatie - prompt, referentieset, duur, verbruikte credits, output-URL - in je applicatiedatabase. Dit maakt debugging en rapportage veel gemakkelijker.

Voorbeeld Batchworkflow

Pseudocode voor een batchproductvideogeneratiewerkflow:

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 vervolgpolzer verwerkt voltooiing en slaat de output-URL tegen de productrecord op.

Monitoring en kostenbeheersing

Voor productie-API-gebruik, stel kostmonitoring in:

• Dagelijkse budgetwaarschuwingen: Waarschuw wanneer dagelijkse API-uitgaven een drempel overschrijden
• Per-workflow limieten: Beperk batchklussen tot een maximale creditbesteding om wildgroei van automatisering te voorkomen
• Gebruiksdashboards: Volg welke workflows de meeste credits verbruiken
• Creditbalans waarschuwingen: Vul aan voordat je leegraakt

Deze veiligheidsmaatregelen voorkomen verrassingen wanneer je automatisering schaalt.

Prijspariteit API versus Web UI

Een veelgestelde vraag: is er korting voor API-gebruik? Nee, API en web UI berekenen beiden hetzelfde $0.3024 per seconde. De API wordt geprijsd voor het werk dat het doet, niet de interface die je gebruikt.

Waar gebruikers met hoog volume besparen is in hun tierselectie. Gebruikers met hoog API-volume moeten op de Max $100 tier lopen voor de beste waarde per dollar.

Aan de slag met de API

1. Meld je aan op arteza.ai (50 gratis credits)
2. Genereer je API-sleutel in accountinstellingen
3. Vul een creditpakket aan dat overeenkomt met je verwachte volume
4. Integreer het eindpunt in je applicatie
5. Begin met kleine testbatches om je workflow te valideren
6. Schaal naar productie zodra getest

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

Volgende leesproeven

Voor de volledige Referencefunctieset, lees de Seedance 2.0 Reference volledige gids. Voor de web UI-workflow, zie stijlconsistente zelfstudie. Voor standaard Seedance 2.0 API-details, controleer Seedance 2.0 API gids.

Programmatische multi-modale video is hier. Bouw iets nieuws ermee.