Seedance 2.0 Reference API: Programmatisk Multi-Modal Video

Programmatisk adgang til multi-modal AI-video ændrer hvad der er muligt. Enkelte klip er fantastiske til marketing og indholdsproduktion, men automatiserede arbejdsprocesser - katalogvideogenerering, personalisering pr. bruger, batch-indholdsoperationer - kræver API-adgang.

Seedance 2.0 Reference API udsætter fuld multi-modal kapacitet: op til 9 billeder, 3 videoer og 3 lydklip pr. anmodning, programmatisk, til samme prissætning pr. sekund som webgrænsefladen.

Hvornår skal man bruge API'et

Web UI er fantastisk til manuel, én-ad-gangen kreativ arbejde. API'et er til alt det andet.

API passer når du har brug for:

• Batch-generering på tværs af hundredvis af assets
• Integration med eksisterende indhold- eller produktpipelines
• Personaliseret video pr. bruger i en applikation
• Automatiseret A/B-test af annoncekreativvarianter
• Planlagt indholdsproduktion til daglig publicering
• Katalogiseringsarbejdsprocesser knyttet til databaseposter

Bliv ved web UI når:

• Du itererer kreativt og skal se/finjustere hver output
• Volumen er lav (færre end 10-20 klip pr. session)
• Du udforsker værktøjet for første gang

Endpointet

Reference-til-video endpointet er:

bytedance/seedance-2.0/reference-to-video

Dette er det eneste endpoint du behøver til multi-modal Reference-tilstandsgenerering. En enkelt anmodning håndterer tekst, op til 9 billeder, op til 3 videoer og op til 3 lydklip. Modellen fusionerer alle inputs og returnerer en genereret video.

For tekst-til-video eller arbejdsprocesser med enkelt billede, brug i stedet standard Seedance 2.0 API endpoints.

Anmodningsstruktur

En typisk Reference-til-video anmodning omfatter:

• prompt: Tekstbeskrivelse af emne og handling (påkrævet)
• reference_images: Array med op til 9 billed-URL'er eller filenreferences
• 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 leveres som URL'er (offentligt tilgængelige) eller uploades direkte afhængigt af dit integrationsmønster.

Prissætning gennem API'et

API-prissætning matcher web UI-prissætningen nøjagtigt:

Der er ingen API-adgangsgebyr og ingen ekstra gebyr for referenceuploads. Du betaler kun for genererede outputsekunder.

Credits fungerer på samme måde på tværs af API og web UI. Topop via prisside og samme creditpool bruges af begge grænseflader. For høj-volumen API-brug er Max $100-niveauet (12.000 credits) det mest økonomiske udgangspunkt.

Start med at bygge med API'et. Få API-adgang med 50 gratis credits ved tilmelding. Start gratis.

Eksempler på use cases

Katalogvideautomatisering

For e-handelplatforme med hundredvis eller tusindvis af SKU'er, lader API'et dig generere en kort produktvideo for hvert produkt baseret på eksisterende produktbilleder.

Arbejdsproces:

1. Forespørg din produktdatabase
2. Hent 5-7 produktbilleder for hvert produkt
3. Kombiner med et brand-bredt referenceudsnit (2-3 billeder)
4. Kald API'et med promptskabelon til produktopenbarelse
5. Gem den returnerede video-URL i din produktpost
6. Servér på produktdetaljesider

Økonomi: 500-SKU katalog på 5-sekunders videoer = 500 × 303 credits = 151.500 credits = ca. $1.515. For en katalogdækkende videoudrulning er det bemærkelsesværdig værdi.

Personaliseret videogenerering

For apps der leverer personaliseret video pr. bruger - lykønskningskort, fejringindhold, onboarding-intros - lader API'et dig generere videoer på anmodning med brugerspecifikke references.

Arbejdsproces:

1. Bruger uploader 3-5 personlige fotos (med samtykke)
2. Din app kombinerer dem med en stilreferenceudsnit
3. API-opkald genererer et personaliseret videeklip
4. Lever til brugeren gennem din app

Dette skaleres til titusindvis af brugere uden indholdshold overhead.

Generering af annoncekreativvarianter

Marketinghold der kører betalt sociale medier har brug for konstante kreativvarianter. API'et lader dig generere A/B-testvarianter programmatisk.

Arbejdsproces:

1. Definer et brand-referenceudsnit (6-8 billeder)
2. Skriv promptskabeloner for forskellige announcevinkler
3. Løb gennem varianter, kald API'et for hver
4. Lever genererede klip til din annonceplatform
5. Spor ydeevne og generer vindere i stor skala

Du kan producere 50 annoncesvarianter i en automatiseret kørsel for ca. $150 i API-omkostninger, versus traditionel produktion på tusinder pr. variant.

Responsbehandling

API-svar omfatter typisk:

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

Reference-tilstandsgenerering tager 60-180 sekunder, så din integration bør håndtere asynkrone svar. Poll statusendpointet eller brug webhooks (hvis tilgængelig på din konto) til at få besked ved fuldførelse.

Bloker ikke bruger-vendte flows på generingsfuldførelse. Køkald anmodningen, underret brugeren når den er klar, og lever asynkront.

Hastighedsbegrænsninger og concurrency

For de fleste kontoniveauer gælder gleichzeitige generringsbegrænsninger. Planlæg dine batch-arbejdsprocesser til at respektere grænserne - køer anmodninger og behandl dem på den tilladte concurrency.

For høj-volumen produktionsarbejdsprocesser kontakt platformsupport om enterprise concurrency-grænser. De fleste standardkonti kan håndtere moderat batch-arbejde (10-30 simultane generinger) uden problemer.

Godkendelse og nøgler

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

Idempotency og forsøg igen

API-generinger er ikke nativt idempotente fordi hver opkald koster credits. Hvis en generering fejler mid-process, bør retry-logik kontrollere den mislykkede generations status før gentilkald. En mislykkede generering bruger typisk ikke credits, men verificér altid i dit kontodashboard.

For produktionsarbejdsprocesser, implementér:

• Retry-logik med eksponentiel backoff på forbigående fejl
• Statuspoll eller webhook-behandling til asynkron fuldførelse
• Fejllogning til at fange systematiske problemer
• Creditbalancovervågning for at advare før du løber tør

Bedste praksis for programmatiske arbejdsprocesser

1. Brug konsistente referenceudsnit. For katalog- eller seriearbejde, hash dine referenceudsnit så identiske udsnit på tværs af anmodninger producerer mere konsistent stil.

2. Hold promptskabeloner enkle. Programmatiske prompts skal genereres fra strukturerede data, ikke håndskrives pr. opkald. Skabelon + datafelter er det rigtige mønster.

3. Cache reference-fil-URL'er. Hvis du bruger URL-baserede references, sikr at URL'erne er stabile og tilgængelige. Udløbne S3-URL'er eller flyttede filer vil mislykkes generinger.

4. Håndter indholdssikkerhed passende. Platformen har indholdssikkerhedsfiltre. Byg elegant håndtering for filterafviste anmodninger ind i din arbejdsproces.

5. Log generingsmetadata. Spor hver generering - prompt, referencesæt, varighed, credits brugt, output-URL - i din applikationsdatabase. Dette gør fejlfinding og rapportering meget nemmere.

Eksempel på batch-arbejdsproces

Pseudokode til en batch-produktvideogenererings-arbejdsproces:

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 fuldførelse og gemmer output-URL'en mod produktposten.

Overvågning og omkostningskontrol

For produktions-API-brug, opsætning af omkostningsovervågning:

• Daglige budgetadvarsler: Advar når daglig API-forbrug overstiger en tærskel
• Per-arbejdsproces-caps: Begræns batch-job til maksimalt creditforbrug for at forhindre løbsk automatisering
• Brugsdashboards: Spor hvilke arbejdsprocesser forbruger mest credits
• Creditbalanceadvarsler: Topop før du løber tør

Disse sikkerhedsforanstaltninger forhindrer overraskelser når du skalerer automatisering.

API vs Web UI-prisparitet

Et almindeligt spørgsmål: er der rabat for API-brug? Nej - API og web UI opkræver begge det samme $0.3024 pr. sekund. API'et er prissat for det arbejde det udfører, ikke grænsefladen du bruger.

Hvor høj-volumen brugere sparer er i deres niveauvalg. Tunge API-brugere bør køre på Max $100 tier for det bedste per-dollar værdi.

Kom i gang med API'et

1. Tilmeld dig på arteza.ai (50 gratis credits)
2. Generer din API-nøgle i kontoindstillinger
3. Topop et creditudsnit der matcher dit forventet volumen
4. Integrer endpointet i din applikation
5. Start med små testbatches til at validere din arbejdsproces
6. Skala til produktion når den er testet

Første API-opkald kan være live inden for en time efter tilmelding for de fleste integrationer.

Næste læsninger

For det fulde Reference-funktionssæt, læs Seedance 2.0 Reference komplet guide. For web UI-arbejdsprocessen, se stil-konsistent 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.