Seedance 2.0 Reference API: Programmatisk multimodal video

Programmatisk åtkomst till multi-modal AI-video förändrar vad som är möjligt. Enstaka klipp är bra för marknadsföring och innehållsskapande, men automatiserade arbetsflöden - katalogvideogenerering, personalisering per användare, batchinnehållsoperationer - kräver API-åtkomst.

Seedance 2.0 Reference API exponerar full multi-modal kapacitet: upp till 9 bilder, 3 videor och 3 ljudklipp per begäran, programmatiskt, till samma prissättning per sekund som webbgränssnittet.

När du bör använda API:et

Webggränssnittet är bra för manuellt, ett-i-taget kreativt arbete. API:et är för allt annat.

API passar när du behöver:

• Batchgenerering över hundratals tillgångar
• Integrering med befintliga innehålls- eller produktpipelines
• Personaliserad video per användare i en applikation
• Automatiserad A/B-testning av reklamkreativvarianter
• Schemalagd innehållsgenerering för daglig publicering
• Katalogarbetsflöden kopplade till databasposter

Håll dig till webggränssnittet när:

• Du itererar kreativt och behöver se/justera varje utdata
• Volymen är låg (färre än 10-20 klipp per session)
• Du utforskar verktyget för första gången

Slutpunkten

Referens-till-video-slutpunkten är:

bytedance/seedance-2.0/reference-to-video

Det här är den enda slutpunkten du behöver för multi-modal Reference-lägesgenerering. En enda begäran hanterar text, upp till 9 bilder, upp till 3 videor och upp till 3 ljudklipp. Modellen fusionerar alla indata och returnerar en genererad video.

För text-till-video eller enkel-bild-arbetsflöden, använd standard Seedance 2.0 API slutpunkterna istället.

Begärandes struktur

En typisk Referens-till-video-begäran innehåller:

• prompt: Textbeskrivning av subjekt och åtgärd (obligatorisk)
• reference_images: Array med upp till 9 bild-URL:er eller filreferenser
• reference_videos: Array med upp till 3 video-URL:er (valfritt)
• reference_audio: Array med upp till 3 ljud-URL:er (valfritt)
• duration: Utdataduration i sekunder, 4-15 (obligatorisk)
• aspect_ratio: En av 16:9, 9:16, 1:1 (obligatorisk)

Indatafiler kan tillhandahållas som URL:er (allmänt tillgängliga) eller laddas upp direkt beroende på ditt integrationsmönster.

Prissättning genom API:et

API-prissättning matchar webbgränssnittsens prissättning exakt:

Det finns ingen API-åtkomstavgift och ingen extra avgift för referensuppladdningar. Du betalar bara för genererade utdatasekunder.

Credits fungerar på samma sätt över API och webben. Fylla på via prissida och samma kreditpoolen används av båda gränssnitten. För storskalig API-användning är Max $100-nivån (12 000 credits) den mest ekonomiska startpunkten.

Börja bygga med API:et. Få API-åtkomst med 50 gratis credits vid registrering. Börja gratis.

Exempel på användningsfall

Katalogvideoautomation

För e-handelsplattformar med hundratals eller tusentals SKU:er, låter API:et dig generera en kort produktvideo för varje produkt baserad på befintlig produktimageri.

Arbetsflöde:

1. Fråga din produktdatabas
2. För varje produkt, hämta 5-7 produktbilder
3. Kombinera med ett varumärkesomfattande referensbundle (2-3 bilder)
4. Anropa API:et med promptmall för produktavslöjande
5. Lagra den returnerade video-URL:en i din produktpost
6. Betjäna på produktdetaljsidor

Ekonomi: 500-SKU-katalog vid 5-sekunds-videor = 500 × 303 credits = 151 500 credits = ~$1 515. För en katalogomfattande videoutrullning är det anmärkningsvärt värdefullt.

Personaliserad videogenerering

För appar som levererar personaliserad video per användare - gratulationskort, celebrationsinnehål, onboarding-intros - låter API:et dig generera on-demand-videor med användarspecifika referenser.

Arbetsflöde:

1. Användaren laddar upp 3-5 personliga foton (med samtycke)
2. Din app kombinerar dem med ett stil-referensbundle
3. API-anrop genererar en personaliserad videokurva
4. Leverera till användaren genom din app

Detta skalas till tiotusentals användare utan innehållsteamets overhead.

Annonskreativ variantgenerering

Marknadsföringsteam som kör betald social behöver konstanta kreativa varianter. API:et låter dig generera A/B-testvarianter programmatiskt.

Arbetsflöde:

1. Definiera ett varumärkesreferensbundle (6-8 bilder)
2. Skriv promptmallar för olika annonsvinkelar
3. Loop genom varianter, anrop API:et för varje
4. Leverera genererade klipp till din annonsplattform
5. Spåra prestanda och generera vinnare i stor skala

Du kan producera 50 annosvarianter i en automatiserad körning för ~$150 i API-kostnader, jämfört med traditionell produktion på tusentals per variant.

Svarshantering

API-svar innehåller vanligtvis:

• Generation ID: Spåra begärsstatus
• Status: pending, processing, complete, failed
• Output URL: Tillgänglig när status är complete
• Metadata: Duration, resolution, filstorlek

Referenslägesgenerering tar 60-180 sekunder, så din integration bör hantera asynkrona svar. Avsök statusslutpunkten eller använd webhooks (om tillgängliga i ditt konto) för att bli meddelad om slutförande.

Blockera inte användarfasaden på genereringslutförandet. Köa begäran, meddela användaren när det är klart och leverera asynkront.

Hastighetsgränser och samtidighet

För de flesta kontonivaer gäller gränser för samtida generering. Planera dina batcharbetsflöden för att respektera gränserna - kö begäranden och bearbeta dem med tillåten samtidighet.

För arbetsflöden med högt volymbehov kontaktar du plattformssupport om gränser för företagskoncurrency. De flesta standardkonton kan hantera måttlig batcharbete (10-30 samtida generering) utan problem.

Autentisering och nycklar

API-åtkomst använder standardnyckelbaserad autentisering. Generera din API-nyckel i dina kontoinställningar efter registrering. Behåll nycklar endast på serversidan - exponera dem aldrig i klientkod.

Idempotence och återförsök

API-generering är inte naturligt idempotent eftersom varje anrop kostar credits. Om en generering misslyckas mitt i processen bör logiken för återförsök kontrollera den misslyckade genereringens status innan du begär igen. En misslyckad generering förbrukar vanligtvis inte credits, men verifiera alltid på din kontokontrollpanel.

För produktionsarbetsflöden implementerar du:

• Logik för återförsök med exponentiell backoff vid övergående fel
• Statusavsökning eller webhook-hantering för asynkront slutförande
• Felloggning för att fånga systematiska problem
• Övervakning av kreditbalans för att varna innan du går slut

Bästa praxis för programmatiska arbetsflöden

1. Använd konsekventa referensbundles. För katalog- eller seriearbete, hash dina referensbundles så identiska bundles över begäranden producerar mer konsekvent stil.

2. Håll promptmallar enkla. Programmatiska prompts bör genereras från strukturerade data, inte handskrivna per anrop. Mall + datafält är rätt mönster.

3. Cache-referensfilens URL:er. Om du använder URL-baserade referenser, se till att URL:erna är stabila och tillgängliga. Utgångna S3-URL:er eller flyttade filer kommer att misslyckas generering.

4. Hantera innehållssäkerhet korrekt. Plattformen har innehållssäkerhetssäkerhet. Bygg elegant hantering för filter-avvisade begäranden i ditt arbetsflöde.

5. Logga genereringsmetadata. Spåra varje generering - prompt, referensuppsättning, duration, förbrukade credits, utdata-URL - i din applikationsdatabas. Detta gör felsökning och rapportering mycket enklare.

Exempel på batcharbetsflöde

Pseudokod för ett batchproduktvideoarbetsflöde:

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)

En uppföljningsavsökare hanterar slutförande och lagrar utdata-URL:en mot produktposten.

Övervaknings- och kostnadskontroll

För produktions-API-användning ställer du in kostnadsövervakning:

• Dagliga budgetvarningar: Varna när daglig API-utgift överskrider en tröskel
• Per-arbetsflödesmässiga gränser: Begränsa batchjobb till en maximalt kreditåtgift för att förhindra skenande automatisering
• Användningsinstrumentpaneler: Spåra vilka arbetsflöden som förbrukar mest credits
• Aviseringar om kreditbalans: Fylla på innan du går slut

Dessa skyddsnät förhindrar överraskningar när du skalar automationen.

API vs Web UI Prissättningsparitet

En vanlig fråga: finns det rabatt för API-användning? Nej - API och webben laddar båda samma $0.3024 per sekund. API:et är prissatt för det arbete det gör, inte gränssnittet du använder.

Där användare med högt volymbehov sparar är i deras nivåval. Tunga API-användare bör köra på Max $100 tier för bästa värde per dollar.

Komma igång med API:et

1. Registrera dig på arteza.ai (50 gratis credits)
2. Generera din API-nyckel i kontoinställningar
3. Fylla på ett kreditpaket som motsvarar din förväntade volym
4. Integrera slutpunkten i din applikation
5. Börja med små testbatchar för att validera ditt arbetsflöde
6. Skala till produktion när den är testad

Första API-anropet kan vara live inom en timme från registrering för de flesta integreringar.

Nästa läsningar

För den fullständiga Reference-funktionsuppsättningen, läs Seedance 2.0 Reference fullständig guide. För webggränssnittsarbetsflödet, se stilkonsistent handledning. För standarddetaljer om Seedance 2.0 API, kontrollera Seedance 2.0 API-guide.

Programmatisk multi-modal video är här. Bygg något nytt med det.