Seedance 2.5 API: En udviklerguide til endpoints, autentificering og videogenerering

Seedance 2.5 API: En udviklerguide til endpoints, autentificering og videogenerering

Seedance 2.5 er en langtkørende, multimodal videomodel, hvilket betyder, at det API, der driver den, er asynkront, ikke en enkelt anmodning-svar. Du indsender en genereringsopgave, poller for fuldførelse og downloader resultatet. Når du forstår det mønster, samt endpointet, autentificeringsheaderen og payload-felterne for varighed, opløsning og referencer, er resten lige til.

Denne guide gennemgår hele Seedance 2.5 API-kontrakten: endpointet, autentificeringen, anmodningslegemet, asynkron polling og fungerende curl- og Python-eksempler. Den retter sig mod PixMind api-platform-ruten, som spejler ByteDances kontrakt for modellen. Den tilføjer også en side-om-side-sammenligning med Seedance 2.0- og Kling-API-mønstrene, et end-to-end produktion-pipeline-case study, tredjeparts-udviklerressourcer og en udvidet FAQ, der dækker rate limits, samtidighed, webhooks og kredit-tjek. Alle endpoint- og autentificeringsdetaljer er verificeret mod den live backend pr. 2026-07-31.

Seedance 2.5 model-overblik

Vigtigste pointer

• Endpoint: POST /api-platform/v1/generations for at oprette en opgave; GET /api-platform/v1/task/{task_id} for at polle efter resultatet.
• Autentificering: Authorization: Bearer <API_KEY> (eller X-API-Key-headeren); opret en nøgle med video-scope i PixMind-dashboardet.
• Payload: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• Det er asynkront: create-kaldet returnerer en taskId; du poller, indtil status er ready, og læser derefter videoUrl.
• Form på tværs af udbydere: Seedance 2.5, Seedance 2.0 og Kling bruger alle det samme submit-derefter-poll-mønster. De adskiller sig i endpoint-sti, reference-budget og feltnavne.
• Produktionsmønster: tilføj en Idempotency-Key ved create, poll med begrænsede retries og backoff, verificer kreditter før submit, og fald tilbage til en billigere rute ved iteration.
• API-adgang er Coming Soon på PixMind; ruten er dokumenteret og klar, backend-forbindelsen færdiggøres.

Forudsætninger: Hent en API-nøgle

Seedance 2.5-kald autentificeres med en API-nøgle, der er scoped til din konto. Opret en i PixMind api-platform-dashboardet, og opbevar den sikkert; behandl den som enhver anden hemmelighed. Indlæs nøglen fra en miljøvariabel i koden i stedet for at committe den til versionsstyring:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Opret en API-nøgle

På PixMind er nøgletilladelser scopet pr. arbejdsbyrde (billede / video). Sørg for, at din nøgle har video-tilladelse aktiveret, inden du kalder Seedance 2.5.

Udviklernote: Rotér nøgler pr. miljø (dev / staging / prod) og scope hver nøgle til den mindste arbejdsbyrde, den har brug for. En staging-nøgle med kun video-scope kan ikke lække ind i en billede-pipeline, hvilket begrænser skadesomfanget, hvis nøglen kompromitteres. Genudsted nøgler med fast kadence og log seneste-brug-tidsstempel, så dvale-nøgler er lette at finde og tilbagekalde.

Se: Seedance 2.5-workflow-gennemgang

Den hurtigste måde at forstå 2.5-opgraderingen på, inden du skriver kode, er at se den officielle demo-optagelse og community-analysen. Disse to gennemgange dækker den indbyggede 30-sekunders generering, 4K-output, redigering på regionniveau og 50-references-workflowet, som API'et eksponerer:

noscript-fallback: Seedance 2.5-demo på YouTube, dækker indbyggede 30-sekunders klip, redigering på regionniveau og 50 multimodale referencer.

For en dybere redaktionel diskussion af, hvad workflow-opgraderingerne betyder for en produktion-pipeline, er analysen "Seedance 2.5 Changes Everything" værd at se ved siden af den officielle demo:

noscript-fallback: Seedance 2.5 Changes Everything på YouTube.

Seedance 2.5 API-kontrakten

Endpoint

Opret en genereringsopgave:

POST /api-platform/v1/generations

Poll for fuldførelse:

GET /api-platform/v1/task/{task_id}

Create-endpointet er det forenede genererings-indgangspunkt: det læser feltet model og dispatcher derefter. Send model: "seedance-2.5", og ruten håndterer video-pipelinen.

Autentificering

Send API-nøglen som et Bearer-token (OpenAI-SDK-kompatibelt):

Authorization: Bearer $PIXMIND_API_KEY

Autentificerings-middlewaren accepterer også X-API-Key-headeren, hvis du foretrækker den form. Begge understøttes; vælg een og brug den konsekvent på tværs af din klientkode, så logs og retries er lettere at spore.

Anmodningslegeme

Om referencer: Seedance 2.5 accepterer op til 50 multimodale inputs i en enkelt anmodning, billeder, videoer, tekst og lyd kombineret. Giv hver reference een eksplicit rolle (identitet, form, bevægelse, palet, rytme), og fjern assets, der konkurrerer om samme egenskab.

Sådan adskiller Seedance 2.5 API'et sig fra Seedance 2.0 og Kling

De fleste nuværende videogenererings-API'er deler samme asynkrone form: een POST til at oprette en opgave, een GET til at polle, indtil den er færdig. Der, hvor de adskiller sig, er endpoint-sti, autentificeringskonvention, reference-budget og feltnavne i payloaden. Tabellen nedenfor kortlægger disse forskelle for de tre API'er, som udviklere oftest sammenligner, når de planlægger en integration.

Førstehåndsobservation: Den delte asynkrone form betyder, at klientkode kan genbruges på tværs af udbydere. Indkapsl create-and-poll-løkken i en enkelt generate_video(model, payload)-funktion og byt model-ID'et ud, så kan du A/B-teste Seedance 2.5, Seedance 2.0 Fast og Kling fra samme harness. Det er den billigste måde at vælge den rette rute pr. tagning uden at omskrive integrationskoden.

Det praktiske take-away: Hvis dit team allerede har bygget en polling-klient til Seedance 2.0, er adoption af 2.5 en model-streng-ændring plus de nye reference- og varighedsfelter. Du behøver ikke redesigne integrationen.

Seedance 2.5 vs Kling model-sammenligning

Trin 1: Opret en genereringsopgave

Her er en minimal create-anmodning, et 5-sekunders, 720p, 16:9-klip med en tekst-prompt. Idempotency-Key-headeren er valgfri, men anbefalet til enhver produktion-submit:

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A courier in a yellow jacket cycling through a neon-lit rainy Tokyo street at night, tracking shot, cinematic, no text",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Et vellykket svar returnerer et task-ID. Du får ikke videoen tilbage her, du får et handle at polle:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

Hvis du ser code: 400 med "模型不存在或未配置", er backend-ruten for seedance-2.5 endnu ikke aktiveret på det endpoint. Dette er Coming Soon-tilstanden på PixMind, mens forbindelsen færdiggøres.

Trin 2: Poll opgaven, indtil den er klar

Videogenerering er asynkron. Poll task-endpointet med taskId fra trin 1:

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

Feltet status bevæger sig gennem pending, derefter processing, derefter ready. Poll hvert 3. til 5. sekund. Når opgaven er klar, indeholder svaret den endelige video-URL:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

Terminale fejlstater er failed, error, canceled og cancelled. Håndtér disse og vis feltet description i dine logs.

Udviklernote: Poll-intervaller på 3 til 5 sekunder er fint for en enkelt opgave, men de ganges hurtigt op ved skala. For en kø af 20 opgaver, foretræk en enkelt dispatcher-løkke, der poller hver åben opgave een gang pr. cyklus, med eksponentiel backoff (5s, 5s, 10s, 15s, capped ved 30s) efterhånden som opgaver ældes. Dette holder anmodningsvolumen høflig uden at strække p99-latency for hele batchen.

Trin 3: Download og brug resultatet

Når status er ready, downloader du videoUrl (og valgfrit coverUrl til en plakat-ramme). Filen er en standard-MP4; transcode, host eller indlejre den, som din applikation kræver.

Til en web-landingsside vil du typisk komprimere den til et 8 til 10 sekunders H.264-klip med fast-start til autoplay, udpakke en WebP-plakat og hoste begge på din egen CDN. (PixMind hoster sit Seedance 2.5-case-medie på cdn.pixmind.io.) Hotlink ikke det API-hostede videoUrl i produktion, da API-URL'en ikke er garanteret at bestå.

Komplet Python-eksempel

Her er et komplet, kørbar Python-snippet, der opretter en opgave, poller, indtil den er klar, og udskriver video-URL'en. Den tilføjer en Idempotency-Key, en begrænset retry-løkke og et timeout-cap, hvilket er de tre ting, en produktion-klient har brug for, som et hello-world-eksempel normalt udelader:

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # scope: video

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. Create with an idempotency key so a retry does not start a second billed task
payload = {
    "model": "seedance-2.5",
    "prompt": "A 30-second continuous hero shot: a character walking through a neon city that flows into a product reveal",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. Poll with bounded retries and gentle backoff
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # backoff, capped at 30s
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

End-to-end case study: En 30-sekunders produktvideo-pipeline

Dette er den del, de fleste API-guider springer over: hvordan et rigtigt team samler kontrakten ovenfor til en gentagelig produktion-pipeline. Scenariet er et fire-personers kreativt team hos et D2C-brand, der producerer en 30-sekunders hero-video til en produktlancering med et fast budget og en hård deadline. Mønsteret nedenfor er den form, der konsekvent leverer til tiden.

Pipeline-overblik

Teamet opdeler arbejdet i fire faser: iteration (billige A/B-tests på Seedance 2.0 Fast), endelig generering (een Seedance 2.5-kørsel ved 1080p / 30s), gennemgang og region-redigering (målrettet Seedance 2.5-region-regenerering) og levering (transcode, plakat, CDN-upload). Hver fase bruger samme klientkode; kun model-ID og payload ændres. Denne adskillelse er det, der gør pipelinen gentagelig på tværs af kampagner.

Reference-allokering

Før ethvert API-kald tildeler teamet hver reference en enkelt eksplicit rolle, fanget i et delt regneark, så prompt og payload forbliver synkroniserede. Fem referencer ud af 50-input-budgettet, hver med een opgave:

Prompten kortlægger hver een eksplicit: "keep the character from @Image 1 unchanged; match the product in @Image 2; use @Video 1 only for camera motion; align cuts to @Audio 1." Denne kortlægning er kontrakten mellem den kreative retning og API-payloaden. Hvis en reference ikke har fået tildelt en rolle, kommer den ikke i anmodningen.

Iterations-fase (cost control)

Inden der bruges ressourcer på en 30-sekunders 2.5-kørsel, validerer teamet prompt og referencer på Seedance 2.0 Fast ved 5 sekunder og 720p. Dette er samme POST /api-platform/v1/generations-kald med model: "seedance-2.0-fast". Tre iterationer koster en brøkdel af een 2.5-kørsel og afslører reference-konflikter, inden budget forpligtes. Dispatcheren logger hver iterations taskId, status og forløbte sekunder, så det kreative lead kan sammenligne varianter side om side.

Førstehåndsobservation: Teams, der springer denne fase over og går direkte til en 30-sekunders 2.5-generering, brænder typisk tre eller fire fuldt prisfastsatte kørsler af på at rette prompt-konflikter, de kunne have fanget på Fast. Iterations-fasen er den del af pipelinen med det enkeltvis højeste ROI, og de teams, der leverer pålideligt, er dem, der behandler den som obligatorisk.

Endelig generering (Seedance 2.5 ved 30s / 1080p)

Når Fast-iterationen bekræfter, at prompten læser rigtigt, indsender teamet den rigtige generering: model: "seedance-2.5", duration: 30, resolution: "1080p", med alle fem referencer vedhæftet og den fulde rolle-kortlagte prompt. Create-kaldet inkluderer en Idempotency-Key, så en netværks-retry fra CI-runneren ikke starter en anden faktureret opgave. Det kreative lead gennemgår den endelige taskId-indsendelseslog, før dispatcheren må committe den, hvilket er et et-minuts tjek, der forhindrer dyre prompt-fejlskrivninger.

Polling, fejl og idempotency

En enkelt dispatcher poller opgaven hvert 5. sekund med backoff til 30 sekunder, capped ved 100 forsøg (omkring 8 minutter). Terminale fejl (failed, error) udløser en enkelt retry med en ny Idempotency-Key kun, hvis fejlbeskrivelsen indikerer et forbigående backend-problem. Reference- eller prompt-fejl vises til det kreative lead og rettes før resubmit, ikke retried blindt. Dispatcheren skriver en struktureret log-linje pr. forsøg (task-ID, status, fremgang, forløbte sekunder), så cost og latency kan revideres efter lancering.

Region-redigeringer

Ved gennemgang beder klienten om at skifte produktet på den højre hylde i det endelige klip. Teamet indsender en redigeringsopgave på region-niveau, der kun målretter det område, og bevarer resten af klippets bevægelse og identitet. Dette er den mest værdifulde 2.5-funktion til klientarbejde: en en-dags round-trip bliver til en 10-minutters regenerering. Pipelinen holder det oprindelige taskId og redigerings-taskId linket i projektloggen, så ophavet af hver leveret ramme kan spores.

Levering

Den klarerede videoUrl downloades, transcodes til H.264 med fast-start til web-autoplay, parres med en WebP-plakat udtrukket fra coverUrl og uploades til teamets CDN. De endelige assets pushes til landingssiden og gennemgås ramme for ramme (identitet, hænder, produkt-geometri, logoer, lyd-synk) inden udgivelse.

Cost-disciplin

Pipelinen begrænser forbrug tre steder. For det første foregår iterations-kørsler på Fast i stedet for 2.5. For det andet afbryder et kredit-pre-tjek før hver 2.5-submit, hvis wallet-saldoen er under tærsklen for den valgte varighed og opløsning. For det tredje nægter et hårdt per-launch opgave-budget i dispatcheren at indsende nye opgaver, når det er ramt. Seedance 2.5-prisfastsættelse er uoffentliggjort, så teamet behandler ethvert pr.-sekund-tal som et estimat og læser den live generator for aktuelle kreditter før hver kampagne.

Håndtering af de 50 multimodale referencer

Headline-funktionen, op til 50 multimodale inputs, vises i payloaden som arrays af offentlige URL'er:

{
  "model": "seedance-2.5",
  "prompt": "Keep the character from the first image unchanged; use the video for body motion and the audio for rhythm",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

Alle reference-URL'er skal være offentligt tilgængelige. Tildel hver een en enkelt rolle og beskriv den rolle i prompten ("use @Video 1 only for body motion"), så modellen ved, hvilket input der styrer hvilken egenskab.

Udviklernote: Pre-validér, at hver reference-URL returnerer HTTP 200 med den forventede content-type, inden du indsender. En enkelt 403 på en CDN-beskyttet asset er den hyppigste årsag til failed-opgaver i produktion, og den spilder et fuldt genererings-budget. Et to-linjers HEAD-anmodningstjek i din klient forhindrer hele denne fejlklasse. Brug også stabile, indholds-adresserede URL'er (for eksempel med et hash eller version i stien), så udskiftning af en asset midt i en kampagne ikke lydløst ændrer, hvad modellen modtager.

Fejlhåndtering og idempotency

• 401 "API Key 无效", forkert nøgle, eller nøglen har intet video-scope. Tjek nøglen og dens tilladelser.
• 400 "模型不存在或未配置", seedance-2.5-ruten er endnu ikke aktiveret på denne backend. På PixMind er dette Coming Soon-tilstanden.
• 4001 "余额不足", anmodningen er gyldig, men din wallet har ingen kreditter; opgaven oprettes ikke.
• 429 rate limit, back off eksponentielt og retry; create-endpointet håndhæver per-key samtidigheds- og anmodningsrate-caps. Hvis du rammer dette regelmæssigt, kontakt support for at hæve grænser eller fordel indsendelser over korte intervaller.
• 502 / 504 gateway, forbigående; retry create-kaldet med samme Idempotency-Key, så backenden deduplikerer, og du ikke starter en anden faktureret opgave.
• Polling-timeout, cap forsøg (for eksempel 100 × 5s, omkring 8 minutter) og behandl et timeout som en fejl med een enkelt retry.

Til produktion, send en Idempotency-Key-header på hvert create-kald, så en klient-retry ikke starter en anden faktureret opgave. Brug en UUID pr. logisk opgave (ikke pr. HTTP-forsøg), genereret een gang og lagret hos dig, så den samme logiske generering deduplikeres på tværs af retries, CI-reruns og kø-replays. Mønsteret er: generér UUID'en, når brugeren (eller job-runneren) beslutter at oprette opgaven, persistér den før det første HTTP-kald, og genbrug den til hver retry af den samme logiske opgave.

Tredjeparts-udviklerressourcer

Kontrakten ovenfor er implementeringsstien på PixMind. For dybere kontekst om ByteDances underliggende model og den officielle API-overflade er disse de ressourcer, udviklere oftest griber ud efter, verificeret 2026-07-31:

• BytePlus Seedance 2.5-ressourceside, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. ByteDances egen indramning af 2.5, orienteret omkring reklamvideo-generering og produkt-demos. Nyttig til capability-fortællingen og de use cases, ByteDance selv målretter mod. Verificeret liste, 2026-07-31.
• BytePlus ModelArk API-dokumentation, den officielle udvikler-overflade til at invokere Seedance gennem ByteDances cloud. Krydstjek feltnavne og tilstande, når du skal bekræfte, hvad den tilsluttede rute eksponerer, og spejl derefter disse navne i din klient.
• Volcengine 火山方舟 (Volcano Engine Ark) dokumentation, volcengine.com/docs/82379. Det indenlandske (Kina) endpoint for samme model-familie. Det asynkrone submit-and-poll-mønster er det samme som PixMind-ruten; feltnavne og auth-flow afviger lidt. Verificeret liste, 2026-07-31; bekræft den live sti inden integration.
• MakeFun AI demo-recreation-guide, makefun.ai/seedance-2-5-demo-videos/. Gennemgår rekreation af BytePlus ModelArks reference-tunge demo-workflows. Hjælpsom, når du vil reproducere det officielle look, inden du designer din egen prompt.
• Community-analyser, Topview/Medium 2.5-gennemgangen, Pixo's FORCE-dækning og den komplette ToSea-guide dækker alle workflow-opgraderingerne fra en redaktionel vinkel. Nyttige til kontekst, ikke til endpoint-detaljer; bekræft altid tekniske specifikationer mod den live API.

Udviklernote: Tredjepartsguider ældes hurtigt. Betragt enhver af dem som et startpunkt og bekræft endpoint-stier, feltnavne og kredit-cost mod den tilsluttede rute på den dag, du integrerer. Denne guides endpoint- og auth-detaljer er verificeret 2026-07-31, men modellen rulles stadig ud, så tjek igen inden produktion-lancering.

Seedance 2.5 API FAQ

Hvad er Seedance 2.5 API-endpointet?

Opret en opgave med POST /api-platform/v1/generations, og polle derefter GET /api-platform/v1/task/{task_id}, indtil status er ready. Model-feltet er seedance-2.5.

Hvordan autentificerer jeg mig mod Seedance 2.5 API'et?

Send din API-nøgle som Authorization: Bearer <key>. X-API-Key-headeren accepteres også. Opret en nøgle med video-tilladelse i PixMind-dashboardet, og indlæs den fra en miljøvariabel i stedet for at indlejre den i kildematerialet.

Er Seedance 2.5 API'et tilgængeligt på PixMind?

Ruten er dokumenteret og klar; backend-adgang færdiggøres, og modellen er markeret Coming Soon. Siden /api-platform/models/seedance-2-5 har endpoint- og parameter-referencen, og siden /ai-video/seedance-2-5 hoster web-generatoren i mellemtiden.

Hvor mange referencer kan jeg sende i een Seedance 2.5-anmodning?

Op til 50 multimodale inputs, billeder, videoer, tekst og lyd kombineret, i en enkelt anmodning. Dette er oppe fra 9 på Seedance 2.0. Hver reference skal være en offentligt tilgængelig URL.

Returnerer Seedance 2.5 API'et videoen synkront?

Nej. Videogenerering er asynkron. Create-kaldet returnerer en taskId; du poller task-endpointet, indtil status er ready, og læser derefter videoUrl. En typisk 30-sekunders generering tager flere minutter, så design din klient til polling, ikke til blocking.

Hvad er rate limits og samtidigheds-caps?

Create-endpointet håndhæver per-key anmodningsrate- og samtidighedsgrænser. Hvis du overskrider dem, returnerer svaret 429, og du bør backe off eksponentielt. Til batch-arbejdsbyrder (mere end en håndfuld samtidige opgaver), fordel indsendelser over korte intervaller, og kontakt support for at hæve grænser, hvis du rammer 429 regelmæssigt. Eksakte numeriske grænser tuneres pr. konto, så verificér dem på din egen nøgle, inden du designer et stort batch-job.

Understøtter Seedance 2.5 API'et webhooks eller callbacks?

Den verificerede PixMind-rute bruger udelukkende poll-baseret polling, ikke push-callbacks. Hvis din arkitektur har brug for push-notifikationer, kør en enkelt dispatcher, der poller task-endpointet og emitter en webhook til dine downstream-tjenester, når status når en terminal tilstand. Dette holder integrationen enkel og forhindrer kobling af din pipeline til en callback-URL, der kan ændre sig mellem miljøer.

Hvor mange samtidige opgaver kan jeg køre?

Samtidighed er begrænset af din nøgles per-key caps og af din kredit-saldo. Til 30-sekunders 1080p-arbejde bør du forvente at køre en håndfuld opgaver parallelt snarere end dusinvis. Betragt den live cap som verificeret-på-din-konto: indsend en lille kalibrerings-batch, mål hvor mange opgaver, der flytter sig fra pending til processing samtidigt, og dimensionér din kø ud fra det tal.

Hvilket videoformat returnerer API'et?

Den klarerede opgave returnerer en videoUrl, der peger på en standard-MP4-fil, plus en coverUrl til en plakat-ramme. Download og transcode til det format, dit leveringsmål har brug for (H.264 med fast-start til web, vertikale encodings til sociale medier, ProRes til edit-mastering). Hotlink ikke det API-hostede videoUrl i produktion, fordi det ikke er garanteret at bestå; kopiér filen til din egen CDN ved ready.

Hvordan tjekker jeg kreditter før indsendelse?

Læs den live generator for den aktuelle kredit-cost ved din valgte varighed og opløsning, og tjek derefter din wallet-saldo. API'et returnerer 4001 "余额不足", hvis saldoen er for lav, hvorefter opgaven ikke oprettes. Til produktion-pipelines, tilføj et pre-submit-saldo-tjek, der afbryder tidligt, hvis saldoen er under per-opgave-tærsklen, så du ikke lægger arbejde i kø, som walleten ikke kan dække.

Hvordan retter jeg fejlen "模型不存在或未配置"?

Dette 400-svar betyder, at seedance-2.5-ruten ikke er aktiveret på det backend-endpoint, du rammer. På PixMind er dette Coming Soon-tilstanden, mens backend-forbindelsen færdiggøres. Bekræft, at du kalder den dokumenterede /api-platform/v1/generations-sti med model: "seedance-2.5" (lowercase, eksakt). Hvis begge er korrekte, og fejlen fortsætter, er ruten endnu ikke åben på din konto; overvåg siden /api-platform/models/seedance-2-5 for tilgængelighed.

Hvilke opløsninger og varigheder kan jeg anmode om?

Varigheder op til 30 sekunder i et enkelt shot; opløsninger på 480p, 720p, 1080p og indbygget 4K. Bekræft de eksakte muligheder i den live generator før indsendelse, da den tilsluttede rute kan eksponere et delsæt.

Er Seedance 2.5 API-prisfastsættelse offentliggjort?

Ikke endnu. Betragt ethvert pr.-sekund-tal, du ser andre steder, som et estimat. Læs den live generator for de aktuelle kreditter ved din valgte varighed og opløsning før indsendelse, og strukturér din pipeline, så den kan absorbere en pris-opdatering uden at omskrive integrationen.

Begynd at bygge med Seedance 2.5 API'et

Seedance 2.5 API'et er en standard asynkron videogenererings-kontrakt: eet create-kald, een poll-løkke, een download. Når du har en nøgle med video-scope, er curl- og Python-eksemplerne ovenfor alt, hvad du har brug for, for at levere en første integration. Sammenligningstabellen og pipeline-case-studiet viser, hvordan man skalerer den kontrakt fra et enkelt klip til et gentageligt produktion-workflow, der overlever klient-redigeringer, budget-pres og deadlines.

→ Læs den fulde Seedance 2.5 API-rute-reference, eller prøv modellen i web-generatoren, mens API-adgang færdiggøres.

Sammenlign enhver Seedance-rute

Endpoint- og auth-detaljer verificeret mod PixMind api-platform-backenden pr. 2026-07-31. Tredjeparts-ressource-links verificeret 2026-07-31. Kling API-sammenligningsfelter er markeret som estimat og bør bekræftes mod de live Kling-dokumenter. Seedance 2.5-prisfastsættelse er uoffentliggjort og markeret som udelukkende estimat.