Seedance 2.0 reference-API: Programmatisk multimodal video

Programmatisk adgang til multi-modal AI-video ændrer, hvad der er muligt. Enkeltstående klip er fremragende til marketing og indholdsproduktion, men automatiserede arbejdsgange, som katalogvideogenerering, brugerspecifik personalisering og batch-indholdsoperationer, kræver API-adgang.

Seedance 2.0 Reference API eksponerer den fulde multi-modale kapabilitet: op til 9 billeder, 3 videoer og 3 lydklip pr. forespørgsel, programmatisk, til samme pris pr. sekund som webgrænsefladen.

Hvornår du bør bruge API'en

Webgrænsefladen er fremragende til manuel, kreativ arbejde ét ad gangen. API'en er til alt andet.

API'en passer, når du har brug for:

• Batch-generering på tværs af hundredvis af aktiver
• Integration med eksisterende indhold eller produktpipelines
• Brugerspecifik personaliseret video i en applikation
• Automatiseret A/B-test af reklamekrativvarianter
• Planlagt indholdsgenerering til daglig publicering
• Katalogiseringsarbejdsgange knyttet til databaseposter

Bliv ved webgrænsefladen, når:

• Du itererer kreativt og skal se og justere hvert output
• Volumenet er lavt (færre end 10-20 klip pr. session)
• Du udforsker værktøjet for første gang

Endpointet

Reference-to-video-endpointet er:

bytedance/seedance-2.0/reference-to-video

Dette er det eneste endpoint, du har brug for til multi-modal Reference-tilstandsgenerering. En enkelt forespørgsel håndterer tekst, op til 9 billeder, op til 3 videoer og op til 3 lydklip. Modellen fusionerer alle input og returnerer en genereret video.

Til tekst-til-video- eller enkeltbillede-arbejdsgange bør du i stedet bruge standard Seedance 2.0 API-endpointene.

Forespørgselsstruktur

En typisk Reference-to-video-forespørgsel indeholder:

• prompt: Tekstbeskrivelse af subjekt og handling (påkrævet)
• reference_images: Array med op til 9 billed-URL'er eller filreferencer
• reference_videos: Array med op til 3 video-URL'er (valgfrit)
• reference_audio: Array med op til 3 lyd-URL'er (valgfrit)
• duration: Outputvarighed i sekunder, 4-15 (påkrævet)
• aspect_ratio: En af 16:9, 9:16, 1:1 (påkrævet)

Inputfiler kan angives som URL'er (offentligt tilgængelige) eller uploades direkte afhængigt af dit integrationsmønster.

Priser via API'en

API-priser svarer præcis til webgrænsefladepriserne:

Der er ingen API-adgangsgebyr og ingen ekstra afgift for referenceupload. Du betaler kun for genererede outputsekunder.

Credits fungerer på samme måde på tværs af API og webgrænseflade. Køb mere via prisside, og den samme kreditpulje bruges af begge grænseflader. Til API-brug i høj volumen giver $120-Studio-planen (1.800 credits om måneden) den bedste pris pr. credit, og eventuelle ekstra credits du køber udløber aldrig.

Begynd at bygge med API'en. Få API-adgang med 10 gratis credits ved tilmelding. Start gratis.

Eksempler på anvendelsestilfælde

Automatisering af katalogvideo

For e-handelsplatforme med hundredvis eller tusindvis af varenumre giver API'en dig mulighed for at generere en kort produktvideo for hvert produkt baseret på eksisterende produktbilleder.

Arbejdsgang:

1. Forespørg din produktdatabase
2. Hent 5-7 produktbilleder for hvert produkt
3. Kombiner med en brandovergrebet referencepakke (2-3 billeder)
4. Kald API'en med en promptskabelon til produktafsløring
5. Gem den returnerede video-URL i din produktpost
6. Vis på produktdetailsider

Økonomi: Et katalog med 500 varenumre ved 5-sekunders videoer = 500 × 303 credits = 151.500 credits = ~$1.515. For en katalogsomfattende videoudrulning er det bemærkelsesværdig værdi.

Personaliseret videogenerering

Til apps der leverer brugerspecifik personaliseret video, som lykønskningskort, fejringsindhold og onboarding-introduktioner, giver API'en dig mulighed for at generere videoer on-demand med brugerspecifikke referencer.

Arbejdsgang:

1. Brugeren uploader 3-5 personlige fotos (med samtykke)
2. Din app kombinerer dem med en stilreferencepakke
3. API-kaldet genererer et personaliseret videoklip
4. Lever det til brugeren via din app

Dette skalerer til titusindvis af brugere uden overhead fra et indholdsteam.

Generering af reklamevarianter

Marketingteams, der kører betalt sociale medier, har konstant brug for kreative varianter. API'en giver dig mulighed for at generere A/B-testvarianter programmatisk.

Arbejdsgang:

1. Definer en brandreferencepakke (6-8 billeder)
2. Skriv promptskabeloner til forskellige reklamevinkler
3. Løb igennem varianter og kald API'en for hver
4. Lever de genererede klip til din annonceplatform
5. Spor performance og generer vindere i stor skala

Du kan producere 50 reklamevarianter i et automatiseret kørsel for ~$150 i API-omkostninger, sammenlignet med traditionel produktion til tusindvis pr. variant.

Håndtering af svar

API-svar indeholder typisk:

• Generings-ID: Spor forespørgslens status
• Status: pending, processing, complete, failed
• Output-URL: Tilgængelig, når status er complete
• Metadata: Varighed, opløsning, filstørrelse

Reference-tilstandsgeneringer tager 60-180 sekunder, så din integration bør håndtere asynkrone svar. Poll status-endpointet, eller brug webhooks (hvis tilgængeligt på din konto) for at blive notificeret ved afslutning.

Bloker ikke brugervendte flows på genereringsafslutning. Sæt forespørgslen i kø, giv brugeren besked, når den er klar, og lever asynkront.

Hastighedsbegrænsninger og samtidige anmodninger

For de fleste kontoplaner gælder grænser for samtidige genereringer. Planlæg dine batch-arbejdsgange, så de respekterer grænserne, sæt forespørgsler i kø og behandl dem med den tilladte samtidighed.

For produktionsarbejdsgange med høj volumen bør du kontakte platformssupporten om virksomhedsmæssige samtidige grænser. De fleste standardkonti kan håndtere moderate batch-opgaver (10-30 samtidige genereringer) uden problemer.

Godkendelse og nøgler

API-adgang bruger standard nøglebaseret godkendelse. Generer din API-nøgle i dine kontoindstillinger efter tilmelding. Hold nøgler udelukkende på serversiden, eksponér dem aldrig i klientkode.

Idempotens og genforsøg

API-genereringer er ikke nativt idempotente, fordi hvert kald koster credits. Hvis en generering mislykkes undervejs, bør genforsøgslogikken kontrollere den mislykkede generings status, inden der foretages en ny forespørgsel. En mislykket generering forbruger typisk ikke credits, men kontrollér altid dette i dit kontodashboard.

Til produktionsarbejdsgange bør du implementere:

• Genforsøgslogik med eksponentiel backoff ved forbigående fejl
• Status-polling eller webhook-håndtering til asynkron afslutning
• Fejllogning til at fange systematiske problemer
• Overvågning af creditsaldo for at advare, inden du løber tør

Bedste praksis for programmatiske arbejdsgange

1. Brug konsistente referencepakker. Til katalog- eller seriearbejde skal du hashe dine referencepakker, så identiske pakker på tværs af forespørgsler producerer mere konsistent stil.

2. Hold promptskabeloner enkle. Programmatiske prompts bør genereres fra strukturerede data, ikke skrives i hånden pr. kald. Skabelon plus datafelter er det rette mønster.

3. Cache reference-fil-URL'er. Hvis du bruger URL-baserede referencer, skal du sikre dig, at URL'erne er stabile og tilgængelige. Udløbne S3-URL'er eller flyttede filer vil fejle genereringer.

4. Håndter indholdssikkerhed hensigtsmæssigt. Platformen har indholdssikkerhedsfiltre. Byg elegant håndtering af filtrafviste forespørgsler ind i din arbejdsgang.

5. Log genereringsmetadata. Spor enhver generering, prompt, referencesæt, varighed, forbrugte credits og output-URL, i din applikationsdatabase. Det gør fejlfinding og rapportering meget nemmere.

Eksempel på batch-arbejdsgang

Pseudokode til en batch-produktvideogenereringsarbejdsgang:

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 opfølgende poller håndterer afslutning og gemmer output-URL'en mod produktposten.

Overvågning og omkostningsstyring

Til produktions-API-brug bør du opsætte omkostningsovervågning:

• Daglige budgetadvarsler: Giv besked, når det daglige API-forbrug overstiger en tærskel
• Loft pr. arbejdsgang: Begræns batch-jobs til et maksimalt creditforbrug for at forhindre uhæmmet automatisering
• Anvendelsesdashboards: Spor hvilke arbejdsgange der forbruger flest credits
• Advarsler om creditsaldo: Køb mere, inden du løber tør

Disse sikkerhedsforanstaltninger forhindrer ubehagelige overraskelser, når du skalerer automatiseringen.

Prisparitet: API vs. webgrænseflade

Et almindeligt spørgsmål: er der rabat ved API-brug? Nej, API og webgrænseflade opkræver begge den samme pris på $0.3024 pr. sekund. API'en er prissat efter det arbejde, den udfører, ikke den grænseflade du bruger.

Hvor brugere med høj volumen sparer, er i valg af plan. Tunge API-brugere bør køre på $120 Studio-plan for den bedste værdi pr. dollar.

Kom i gang med API'en

1. Tilmeld dig på arteza.ai (10 gratis credits)
2. Generer din API-nøgle i kontoindstillingerne
3. Køb en creditpakke, der matcher din forventede volumen
4. Integrer endpointet i din applikation
5. Start med små testbatches for at validere din arbejdsgang
6. Skalér til produktion, når det er testet

Det første API-kald kan være live inden for en time efter tilmelding for de fleste integrationer.

Videre læsning

For det fulde Reference-funktionssæt kan du læse Komplet guide til Seedance 2.0 Reference. For webgrænseflade-arbejdsgangen, se stilkonsistent tutorial. For standard Seedance 2.0 API-detaljer, tjek Seedance 2.0 API-guide.

Programmatisk multi-modal video er her. Byg noget nyt med det.