Seedance 2.0 Reference API: programmatisk multimodal video

Programmatisk åtkomst till multimodal AI-video förändrar vad som är möjligt. Enstaka klipp är utmärkta för marknadsföring och innehållsskapande, men automatiserade arbetsflöden - kataloggenerering av video, personanpassning per användare och batchbaserade innehållsoperationer - kräver API-åtkomst.

Seedance 2.0 Reference API exponerar den fullständiga multimodala kapaciteten: upp till 9 bilder, 3 videor och 3 ljudklipp per förfrågan, programmatiskt, till samma pris per sekund som webbgränssnittet.

Sammanfattning

• Endpoint: bytedance/seedance-2.0/reference-to-video
• Indata: textprompt + upp till 9 bilder + 3 videor + 3 ljudklipp
• Pris: $0.3024/sek av utdata, samma som webbgränssnittet
• Utdata: 720p-video, 4-15 sekunder, inbyggd ljudsynkronisering
• Genereringstid: 60-180 sekunder per förfrågan
• Perfekt för katalogautomation, batcharbetsflöden och programmatiskt innehåll
• Prova API:et gratis med 10 krediter

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

Webbgränssnittet är utmärkt för manuellt, kreativt arbete ett klipp i taget. API:et är till för allt annat.

API:et passar när du behöver:

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

Använd webbgränssnittet när:

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

Endpointen

Reference-to-video-endpointen är:

bytedance/seedance-2.0/reference-to-video

Det här är den enda endpoint du behöver för multimodala Reference-lägesgenerationer. En enda förfrågan hanterar text, upp till 9 bilder, upp till 3 videor och upp till 3 ljudklipp. Modellen sammanfogar alla indata och returnerar en genererad video.

För text-till-video eller arbetsflöden med en enda bild använder du standard Seedance 2.0 API-endpointerna i stället.

Förfrågningsstruktur

En typisk Reference-to-video-förfrågan innehåller:

• prompt: Textbeskrivning av motiv och handling (obligatorisk)
• reference_images: Array med upp till 9 bild-URL:er eller filreferenser
• reference_videos: Array med upp till 3 video-URL:er (valfri)
• reference_audio: Array med upp till 3 ljud-URL:er (valfri)
• duration: Utdatalängd i sekunder, 4-15 (obligatorisk)
• aspect_ratio: En av 16:9, 9:16, 1:1 (obligatorisk)

Indatafiler kan anges som URL:er (offentligt tillgängliga) eller laddas upp direkt beroende på ditt integrationsmönster.

Prissättning via API:et

API-prissättningen matchar webbgränssnittets prissättning exakt:

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

Krediter fungerar på samma sätt via API:et och webbgränssnittet. Fyll på via prissidan och samma kreditpool används av båda gränssnitten. För hög API-volym ger Studio-planen till $120 (1 800 krediter per månad) det bästa priset per kredit, och eventuella påfyllningskrediter du lägger till löper aldrig ut.

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

Exempelanvändningsfall

Automatisering av kataloggenerering

För e-handelsplattformar med hundratals eller tusentals artikelnummer låter API:et dig generera en kort produktvideo för varje produkt baserat på befintliga produktbilder.

Arbetsflöde:

1. Hämta data från din produktdatabas
2. Hämta 5-7 produktbilder för varje produkt
3. Kombinera med ett varumärkesövergripande referenspaket (2-3 bilder)
4. Anropa API:et med en promptmall för produktvisning
5. Spara den returnerade video-URL:en i din produktpost
6. Visa på produktdetaljsidor

Ekonomi: 500-artiklars katalog med 5-sekunders videor = 500 × 303 krediter = 151 500 krediter = ~$1 515. För en katalogomfattande videoutrullning är det ett remarkabelt värde.

Personanpassad videogenerering

För appar som levererar personanpassad video per användare - gratulationskort, festinnehåll, onboarding-introduktioner - låter API:et dig generera videor på begäran med användarspecifika referenser.

Arbetsflöde:

1. Användaren laddar upp 3-5 personliga foton (med samtycke)
2. Din app kombinerar dem med ett stilreferenspaket
3. API-anropet genererar ett personanpassat videoklipp
4. Leverera till användaren via din app

Det skalas till tiotusentals användare utan att kräva ett innehållsteam.

Generering av annonsvarianter

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

Arbetsflöde:

1. Definiera ett varumärkesreferenspaket (6-8 bilder)
2. Skriv promptmallar för olika annonsinfallsvinklar
3. Loopa igenom varianter och anropa API:et för var och en
4. Leverera genererade klipp till din annonsplattform
5. Följ upp prestanda och generera vinnande varianter i stor skala

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

Svarshantering

API-svar innehåller vanligtvis:

• Generations-ID: Spåra förfrågans status
• Status: pending, processing, complete, failed
• Utdata-URL: Tillgänglig när statusen är complete
• Metadata: Längd, upplösning, filstorlek

Generationer i Reference-läge tar 60-180 sekunder, så din integration bör hantera asynkrona svar. Polla statusendpointen eller använd webhooks (om det finns tillgängligt i ditt konto) för att få notiser när genereringen är klar.

Blockera inte användarflöden i väntan på att genereringen ska slutföras. Köa förfrågan, meddela användaren när den är klar och leverera asynkront.

Hastighetsbegränsningar och samtidighet

För de flesta kontonivåer gäller begränsningar för samtidiga generationer. Planera dina batcharbetsflöden så att de respekterar gränserna - köa förfrågningar och behandla dem med tillåten samtidighet.

För produktionsarbetsflöden med hög volym kontaktar du plattformssupporten angående företagsanpassade samtidighetsgränser. De flesta standardkonton klarar måttliga batchjobb (10-30 samtidiga generationer) utan problem.

Autentisering och nycklar

API-åtkomst använder standardbaserad nyckelautentisering. Generera din API-nyckel i kontoinställningarna efter registrering. Håll nycklar enbart på serversidan - exponera dem aldrig i klientkod.

Idempotens och återförsök

API-generationer är inte nativt idempotenta eftersom varje anrop kostar krediter. Om en generering misslyckas mitt i processen bör återförsökslogiken kontrollera den misslyckade genereringens status innan den begärs igen. En misslyckad generering förbrukar vanligtvis inga krediter, men verifiera alltid i din kontopanel.

För produktionsarbetsflöden, implementera:

• Återförsökslogik med exponentiell backoff vid tillfälliga fel
• Statuspolling eller webhook-hantering för asynkron slutföring
• Felloggning för att fånga systematiska problem
• Övervakning av kreditbalansen för att varna innan du tar slut

Bästa praxis för programmatiska arbetsflöden

1. Använd konsekventa referenspaket. För katalog- eller seriearbete hashar du dina referenspaket så att identiska paket över förfrågningar ger ett mer konsekvent stiluttryck.

2. Håll promptmallar enkla. Programmatiska prompter bör genereras från strukturerade data, inte skrivas manuellt per anrop. Mall plus datafält är rätt mönster.

3. Cacha referensfil-URL:er. Om du använder URL-baserade referenser ser du till att URL:erna är stabila och tillgängliga. Utgångna S3-URL:er eller flyttade filer kommer att orsaka misslyckade generationer.

4. Hantera innehållssäkerhet på rätt sätt. Plattformen har innehållssäkerhetsfilter. Bygg in smidig hantering av filteravvisade förfrågningar i ditt arbetsflöde.

5. Logga generationsmetadata. Spåra varje generering - prompt, referensuppsättning, längd, förbrukade krediter, utdata-URL - i din applikationsdatabas. Det gör felsökning och rapportering mycket enklare.

Exempel på batcharbetsflöde

Pseudokod för ett batcharbetsflöde för produktvideogenerering:

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öljande pollare hanterar slutföringen och sparar utdata-URL:en mot produktposten.

Övervakning och kostnadskontroll

För produktions-API-användning sätter du upp kostnadsövervakning:

• Dagliga budgetvarningar: Varna när dagliga API-utgifter överstiger ett tröskelvärde
• Caps per arbetsflöde: Begränsa batchjobb till en maximal kreditförbrukning för att förhindra okontrollerad automation
• Användningspaneler: Spåra vilka arbetsflöden som förbrukar flest krediter
• Kreditbalansvarningar: Fyll på innan du tar slut

Dessa skyddsräcken förhindrar obehagliga överraskningar när du skalar upp automationen.

Prisparitet: API kontra webbgränssnitt

En vanlig fråga: finns det rabatt för API-användning? Nej - både API och webbgränssnitt debiterar samma $0.3024 per sekund. API:et är prissatt för det arbete det utför, inte för vilket gränssnitt du använder.

Där högvolymskunder sparar är i valet av plan. Tunga API-användare bör köra på $120 Studio-plan för det bästa värdet per dollar.

Kom igång med API:et

1. Registrera dig på arteza.ai (10 gratis krediter)
2. Generera din API-nyckel i kontoinställningarna
3. Fyll på ett kreditpaket som matchar förväntad volym
4. Integrera endpointen i din applikation
5. Börja med små testbatcher för att validera ditt arbetsflöde
6. Skala till produktion när testningen är klar

Första API-anropet kan vara live inom en timme efter registrering för de flesta integrationer.

Vidare läsning

För hela Reference-funktionsuppsättningen, läs Komplett guide för Seedance 2.0 Reference. För webbgränssnittsarbetsflödet, se handledning för stilkonsistens. För standard Seedance 2.0 API-detaljer, kolla API-guide för Seedance 2.0.

Programmatisk multimodal video är här. Bygg något nytt med den.