API Seedance 2.5: przewodnik dewelopera po endpointach, uwierzytelnianiu i generowaniu wideo

API Seedance 2.5: przewodnik dewelopera po endpointach, uwierzytelnianiu i generowaniu wideo

Seedance 2.5 to długometrażowy, multimodalny model wideo, co oznacza, że sterujące nim API jest asynchroniczne, a nie pojedynczym żądanie-odpowiedź. Wysyłasz zadanie generacji, odpytujesz o ukończenie i pobierasz wynik. Gdy zrozumiesz ten wzorzec, a także endpoint, nagłówek uwierzytelniający i pola ładunku odpowiedzialne za czas trwania, rozdzielczość i odniesienia, reszta jest prosta.

Ten przewodnik przeprowadza Cię przez pełną umowę API Seedance 2.5: endpoint, uwierzytelnianie, treść żądania, asynchroniczne odpytywanie oraz działające przykłady curl i Python. Jest on skierowany do ścieżki platformy API PixMind, która odzwierciedla umowę ByteDance dla tego modelu. Dodatkowo znajdziesz tu porównanie wzorców API Seedance 2.0 i Kling, end-to-end studium przypadku produkcyjnego pipeline'u, zasoby dla deweloperów thirds party oraz rozszerzone FAQ obejmujące limity zapytań, współbieżność, webhooki i sprawdzanie kredytów. Wszystkie szczegóły endpointów i uwierzytelniania zostały zweryfikowane względem działającego backendu na dzień 2026-07-31.

Przegląd modelu Seedance 2.5

Najważniejsze wnioski

• Endpoint: POST /api-platform/v1/generations do utworzenia zadania; GET /api-platform/v1/task/{task_id} do odpytywania o wynik.
• Uwierzytelnianie: Authorization: Bearer <API_KEY> (lub nagłówek X-API-Key); utwórz klucz z zakresem wideo w panelu PixMind.
• Ładunek: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• To działanie asynchroniczne: wywołanie tworzące zwraca taskId; odpytuj, aż status przyjmie wartość ready, a następnie odczytaj videoUrl.
• Spójność między dostawcami: Seedance 2.5, Seedance 2.0 i Kling korzystają z tego samego wzorca wyślij-i-odpytuj. Różnią się ścieżką endpointu, budżetem odniesień i nazwami pól.
• Wzorzec produkcyjny: dodaj Idempotency-Key przy tworzeniu, odpytuj z ograniczonymi ponowieniami i backoffem, weryfikuj kredyty przed wysłaniem i fallbackuj na tańszą ścieżkę do iteracji.
• Dostęp do API wkrótce (Coming Soon) na PixMind; ścieżka jest udokumentowana i gotowa, podłączenie do backendu jest finalizowane.

Wymagania wstępne: uzyskaj klucz API

Wywołania Seedance 2.5 są uwierzytelniane kluczem API przypisanym do Twojego konta. Utwórz go w panelu platformy API PixMind i bezpiecznie przechowuj, traktując go jak każdy inny sekret. W kodzie wczytuj klucz ze zmiennej środowiskowej, a nie zatwierdzaj go w systemie kontroli wersji:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Utwórz klucz API

Na PixMind uprawnienia klucza są ograniczane per obciążenie (obraz / wideo). Przed wywołaniem Seedance 2.5 upewnij się, że Twój klucz ma włączone uprawnienie wideo.

Uwaga dla deweloperów: Rotuj klucze per środowisko (dev / staging / prod) i ograniczaj każdy klucz do minimalnego niezbędnego obciążenia. Klucz środowiska staging z zakresem wyłącznie wideo nie może przeniknąć do pipeline'u obrazów, co ogranicza zasięg skutków kompromitacji klucza. Wystawiaj ponownie klucze według stałego harmonogramu i loguj znacznik czasu ostatniego użycia, aby uśpione klucze można było łatwo znaleźć i unieważnić.

Zobacz: walkthrough workflow Seedance 2.5

Najszybsza droga do zrozumienia upgrade'u do 2.5 przed napisaniem kodu to obejrzanie oficjalnego materiału demo i analiz społeczności. Te dwa walkthroughi obejmują 30-sekundową generację natywną, wyjście 4K, edycję na poziomie obszarów oraz workflow z 50 odniesieniami, które udostępnia API:

Wersja alternatywna noscript: Demo Seedance 2.5 na YouTube — obejmuje 30-sekundowe klipy natywne, edycję na poziomie obszarów i 50 multimodalnych odniesień.

W celu głębszej, redakcyjnej dyskusji tego, co upgrade'y workflow oznaczają dla produkcyjnego pipeline'u, warto obejrzeć analizę „Seedance 2.5 Changes Everything" obok oficjalnego rolla:

Wersja alternatywna noscript: Seedance 2.5 Changes Everything na YouTube.

Umowa API Seedance 2.5

Endpoint

Utworzenie zadania generacji:

POST /api-platform/v1/generations

Odpytywanie o ukończenie:

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

Endpoint tworzący to ujednolicony punkt wejścia generacji: odczytuje pole model i odpowiednio dysponuje żądanie. Wyślij model: "seedance-2.5", a ścieżka obsłuży pipeline wideo.

Uwierzytelnianie

Wyślij klucz API jako token Bearer (kompatybilny z OpenAI-SDK):

Authorization: Bearer $PIXMIND_API_KEY

Middleware uwierzytelniający akceptuje również nagłówek X-API-Key, jeśli wolisz tę formę. Oba warianty są obsługiwane; wybierz jeden i stosuj konsekwentnie w całym kodzie klienta, aby logi i ponowienia były łatwiejsze do prześledzenia.

Treść żądania

O odniesieniach: Seedance 2.5 przyjmuje do 50 wejść multimodalnych w jednym żądaniu, obrazy, wideo, tekst i audio łącznie. Każdemu odniesieniu przypisz jedną jednoznaczną rolę (tożsamość, kształt, ruch, paleta, rytm) i usuwaj zasoby, które konkurują o tę samą właściwość.

Porównanie API Seedance 2.5 z Seedance 2.0 i Kling

Większość obecnych API generacji wideo dzieli ten sam asynchroniczny kształt: jeden POST do utworzenia zadania, jeden GET do odpytywania aż do zakończenia. Różnią się ścieżką endpointu, konwencją uwierzytelniania, budżetem odniesień i nazwami pól w ładunku. Poniższa tabela mapuje te różnice dla trzech API, które deweloperzy najczęściej porównują planując integrację.

Obserwacja z pierwszej ręki: Wspólny asynchroniczny kształt oznacza, że kod klienta jest wielokrotnie użyteczny między dostawcami. Obuduj pętlę tworzenia-i-odpytywania w jedną funkcję generate_video(model, payload) i podmieniaj tylko identyfikator modelu, a będziesz mógł wykonywać testy A/B Seedance 2.5, Seedance 2.0 Fast i Kling z tego samego środowiska. To najtańszy sposób na wybór odpowiedniej ścieżki dla każdego ujęcia bez przebudowy kodu integracji.

Praktyczny wniosek: jeśli Twój zespół zbudował już klienta odpytującego dla Seedance 2.0, przyjęcie 2.5 to zmiana ciągu modelu plus nowe pola odniesień i czasu trwania. Nie musisz przebudowywać integracji.

Porównanie modeli Seedance 2.5 i Kling

Krok 1: Utwórz zadanie generacji

Oto minimalne żądanie utworzenia: 5-sekundowy klip 720p w proporcji 16:9 z promptem tekstowym. Nagłówek Idempotency-Key jest opcjonalny, ale zalecany przy każdym produkcyjnym zgłoszeniu:

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"
  }'

Prawidłowa odpowiedź zwraca identyfikator zadania. Nie dostajesz tu wideo, lecz uchwyt do odpytywania:

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

Jeśli zobaczysz code: 400 z komunikatem „模型不存在或未配置", ścieżka backendu dla seedance-2.5 nie została jeszcze włączona na tym endpoincie. Jest to stan Coming Soon na PixMind, podczas gdy połączenie jest finalizowane.

Krok 2: Odpytuj zadanie aż będzie gotowe

Generacja wideo jest asynchroniczna. Odpytuj endpoint zadania z taskId uzyskanym w kroku 1:

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

Pole status przechodzi przez pending, następnie processing, a potem ready. Odpytuj co 3 do 5 sekund. Gdy zadanie jest gotowe, odpowiedź zawiera ostateczny URL wideo:

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

Stanami nieodwracalnego błędu są failed, error, canceled i cancelled. Obsłuż je i kieruj pole description do swoich logów.

Uwaga dla deweloperów: Interwały odpytywania rzędu 3 do 5 sekund są w porządku dla pojedynczego zadania, ale przy skali szybko się mnożą. Dla kolejki 20 zadań preferuj jedną pętlę dyspozytora, która odpytuje każde otwarte zadanie raz na cykl, z wykładniczym backoffem (5 s, 5 s, 10 s, 15 s, z ograniczeniem do 30 s) w miarę starzenia się zadań. Utrzymuje to objętość zapytań na taktownym poziomie bez rozciągania opóźnienia p99 dla całej partii.

Krok 3: Pobierz i użyj wyniku

Gdy status wynosi ready, pobierz videoUrl (i opcjonalnie coverUrl dla klatki posterowej). Plik to standardowy MP4; transkoduj, hostuj lub osadzaj zgodnie z wymaganiami aplikacji.

Na stronę docelową web zazwyczaj kompresuje się go do 8- do 10-sekundowego klipu H.264 z fast-start dla autoodtwarzania, ekstrahuje poster WebP i hostuje oba zasoby we własnym CDN. (PixMind hostuje materiały przypadków Seedance 2.5 na cdn.pixmind.io.) Nie hotlinkuj API-hostowanego videoUrl w produkcji, ponieważ URL API nie ma gwarancji trwałości.

Pełny przykład w Pythonie

Oto kompletny, uruchamialny fragment w Pythonie, który tworzy zadanie, odpytuje aż do gotowości i drukuje URL wideo. Dodaje Idempotency-Key, ograniczoną pętlę ponowień i limit czasu, czyli trzy rzeczy, których potrzebuje produkcyjny klient, a których brakuje w przykładach typu hello-world:

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")

Studium przypadku end-to-end: produkcyjny pipeline wideo 30-sekundowego

To część, którą pomija większość przewodników API: jak prawdziwy zespół składa powyższą umowę w powtarzalny produkcyjny pipeline. Scenariusz: czteroosobowy zespół kreatywny w marce D2C produkujący 30-sekundowe wideo hero na launch produktu, przy stałym budżecie i twardym terminie. Poniższy wzorzec to kształt, który konsekwentnie trafia na rynek w terminie.

Przegląd pipeline'u

Zespół dzieli pracę na cztery etapy: iteracja (tanie testy A/B na Seedance 2.0 Fast), generacja finałowa (jedno uruchomienie Seedance 2.5 przy 1080p / 30 s), recenzja i edycje obszarowe (ukierunkowana regeneracja obszarów przez Seedance 2.5) oraz dostawa (transkodowanie, poster, upload do CDN). Każdy etap korzysta z tego samego kodu klienta; zmienia się tylko identyfikator modelu i ładunek. To rozdzielenie sprawia, że pipeline jest powtarzalny między kampaniami.

Alokacja odniesień

Przed jakimkolwiek wywołaniem API zespół przypisuje każdemu odniesieniu jedną jednoznaczną rolę, ujętą we współdzielonym arkuszu, tak aby prompt i ładunek pozostawały zsynchronizowane. Pięć odniesień z budżetu 50 wejść, każde z jednym zadaniem:

Prompt mapuje każde odniesienie wprost: „zachowaj postać z @Image 1 niezmienioną; dopasuj produkt z @Image 2; użyj @Video 1 wyłącznie dla ruchu kamery; z synchronizuj cięcia z @Audio 1". To mapowanie jest umową między kierunkiem kreatywnym a ładunkiem API. Jeśli odniesienie nie ma przypisanej roli, nie trafia do żądania.

Etap iteracji (kontrola kosztów)

Zanim wyda się środki na 30-sekundowe uruchomienie 2.5, zespół waliduje prompt i odniesienia na Seedance 2.0 Fast przy 5 sekundach i 720p. To to samo wywołanie POST /api-platform/v1/generations z model: "seedance-2.0-fast". Trzy iteracje kosztują ułamek jednego uruchomienia 2.5 i ujawniają konflikty odniesień przed zaangażowaniem budżetu. Dyspozytor loguje taskId, status i czas trwania w sekundach każdej iteracji, aby kierownik kreatywny mógł porównać warianty obok siebie.

Obserwacja z pierwszej ręki: Zespoły, które pomijają ten etap i przechodzą od razu do 30-sekundowej generacji 2.5, zazwyczaj tracą trzy lub cztery pełnopłatne uruchomienia na naprawę konfliktów promptu, które można było wyłapać na Fast. Etap iteracji to część pipeline'u o najwyższym ROI, a zespoły, które terminowo dostarczają, to te, które traktują go jako obowiązkowy.

Generacja finałowa (Seedance 2.5 przy 30 s / 1080p)

Gdy iteracja Fast potwierdzi, że prompt się czyta, zespół przesyła właściwą generację: model: "seedance-2.5", duration: 30, resolution: "1080p", z dołączonymi wszystkimi pięcioma odniesieniami i pełnym promptem zmapowanym na role. Wywołanie tworzące zawiera Idempotency-Key, tak aby ponowienie sieciowe z runnera CI nie uruchomiło drugiego, płatnego zadania. Kierownik kreatywny przegląda log ostatecznego zgłoszenia taskId przed tym, jak dyspozytor może je zatwierdzić, co jest jednominutowym sprawdzeniem zapobiegającym kosztownym literówkom w prompcie.

Odpytywanie, błędy i idempotencja

Jeden dyspozytor odpytuje zadanie co 5 sekund z backoffem do 30 sekund, z limitem 100 prób (ok. 8 minut). Stany nieodwracalne (failed, error) wyzwalają pojedyncze ponowienie z nowym Idempotency-Key tylko wtedy, gdy opis błędu wskazuje na przejściowy problem backendu. Błędy odniesień lub promptu są kierowane do kierownika kreatywnego i poprawiane przed ponownym przesłaniem, a nie ślepo ponawiane. Dyspozytor zapisuje ustrukturyzowany wiersz logu per próba (ID zadania, status, postęp, czas w sekundach), aby koszty i opóźnienia były audytowalne po launchu.

Edycje obszarowe

Przy recenzji klient prosi o wymianę produktu na prawej półce w finałowym ujęciu. Zespół przesyła zadanie edycji na poziomie obszaru, które celuje wyłącznie w ten obszar, zachowując resztę ruchu i tożsamości klipu. To najbardziej wartościowa funkcja 2.5 dla pracy klienckiej: jednodniowy cykl zamienia się w 10-minutową regenerację. Pipeline utrzymuje oryginalne taskId i taskId edycji powiązane w logu projektu, tak aby pochodzenie każdej dostarczonej klatki było śledzialne.

Dostawa

Gotowy videoUrl jest pobierany, transkodowany do H.264 z fast-start pod autoodtwarzanie web, parowany z posterem WebP ekstrahowanym z coverUrl i wgrywany do CDN zespołu. Ostateczne zasoby są publikowane na stronie docelowej i recenzowane klatka po klatce (tożsamość, dłonie, geometria produktu, logotypy, synchronizacja audio) przed publikacją.

Dyscyplina kosztów

Pipeline ogranicza wydatki w trzech miejscach. Po pierwsze, iteracje odbywają się na Fast zamiast na 2.5. Po drugie, weryfikacja kredytów przed każdym przesłaniem do 2.5 przerywa działanie, jeśli saldo portfela jest poniżej progu dla wybranego czasu trwania i rozdzielczości. Po trzecie, twardy budżet zadań per launch w dyspozytorze odmawia przesyłania nowych zadań po jego przekroczeniu. Cennik Seedance 2.5 nie jest opublikowany, dlatego zespół traktuje każdą kwotę za sekundę jako szacunkową i odczytuje aktualne kredyty z generatora na żywo przed każdą kampanią.

Obsługa 50 odniesień multimodalnych

Funkcja wyróżniona, do 50 wejść multimodalnych, pojawia się w ładunku jako tablice publicznych URL-i:

{
  "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
}

Wszystkie URL-e odniesień muszą być publicznie osiągalne. Przypisz każdemu jedną rolę i opisz ją w prompcie („use @Video 1 only for body motion"), aby model wiedział, które wejście steruje którą właściwością.

Uwaga dla deweloperów: Pre-waliduj, że każdy URL odniesienia zwraca HTTP 200 z oczekiwanym content-type, przed przesłaniem. Pojedynczy 403 na zasobie chronionym CDN to najczęstsza przyczyna zadań ze stanem failed w produkcji, a marnuje pełny budżet generacji. Dwuwersowy test HEAD w kliencie zapobiega całej tej klasie błędów. Stosuj również stabilne, adresowane treścią URL-e (np. z hashem lub wersją w ścieżce), aby podmiana zasobu w trakcie kampanii nie po cichu nie zmieniła tego, co otrzymuje model.

Obsługa błędów i idempotencja

• 401 „API Key 无效", nieprawidłowy klucz lub klucz bez zakresu wideo. Sprawdź klucz i jego uprawnienia.
• 400 „模型不存在或未配置", ścieżka seedance-2.5 nie jest jeszcze włączona na tym backendzie. Na PixMind to stan Coming Soon.
• 4001 „余额不足", żądanie jest prawidłowe, ale Twój portfel nie ma kredytów; zadanie nie zostaje utworzone.
• 429 limit zapytań, wycofaj się wykładniczo i ponów; endpoint tworzący wymusza limity współbieżności i częstotliwości zapytań per klucz. Jeśli trafiasz na to regularnie, skontaktuj się z pomocą techniczną w celu podniesienia limitów lub rozłóż zgłoszenia w krótkich odstępach.
• 502 / 504 bramka, przejściowe; ponów wywołanie tworzące z tym samym Idempotency-Key, aby backend zdeduplikował i nie uruchomił drugiego, płatnego zadania.
• Limit czasu odpytywania, ogranicz liczbę prób (np. 100 × 5 s, ok. 8 minut) i traktuj przekroczenie limitu jako błąd z jednym ponowieniem.

W produkcji przekazuj nagłówek Idempotency-Key przy każdym wywołaniu tworzącym, aby ponowienie po stronie klienta nie uruchomiło drugiego, płatnego zadania. Używaj UUID per logiczne zadanie (nie per próba HTTP), wygenerowanego raz i przechowanego po Twojej stronie, tak aby to samo logiczne zadanie było deduplikowane między ponowieniami, ponownymi uruchomieniami CI i odtworzeniami kolejki. Wzorzec jest taki: wygeneruj UUID, gdy użytkownik (lub runner zadań) zdecyduje o utworzeniu zadania, utrwal go przed pierwszym wywołaniem HTTP i reużyj dla każdego ponowienia tego samego logicznego zadania.

Zasoby dla deweloperów third-party

Powyższa umowa to ścieżka implementacji na PixMind. W celu głębszego kontekstu o modelu bazowym ByteDance i oficjalnym obliczu API, oto zasoby, po które deweloperzy najczęściej sięgają, weryfikacja 2026-07-31:

• Strona zasobu BytePlus Seedance 2.5, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. Własne ujęcie 2.5 przez ByteDance, zorientowane na generację wideo reklamowego i demo produktów. Przydatne do narracji o możliwościach i przypadków użycia, do których sam ByteDance celuje. Weryfikacja wpisu 2026-07-31.
• Dokumentacja API BytePlus ModelArk, oficjalne oblicze deweloperskie do wywoływania Seedance przez chmurę ByteDance. Sprawdzaj nazwy pól i tryby, gdy musisz potwierdzić, co udostępnia podłączona ścieżka, a następnie odzwierciedlaj te nazwy w kliencie.
• Dokumentacja Volcengine 火山方舟 (Volcano Engine Ark), volcengine.com/docs/82379. Krajowy (Chiny) endpoint tej samej rodziny modeli. Asynchroniczny wzorzec wyślij-i-odpytuj jest taki sam jak w ścieżce PixMind; nazwy pól i przepływ uwierzytelniania nieznacznie się różnią. Weryfikacja wpisu 2026-07-31; potwierdź aktualną ścieżkę przed integracją.
• Poradnik odtwarzania dema MakeFun AI, makefun.ai/seedance-2-5-demo-videos/. Przeprowadza przez odtwarzanie workflow dema BytePlus ModelArk obfitującego w odniesienia. Pomocne, gdy chcesz odtworzyć oficjalny look przed zaprojektowaniem własnego promptu.
• Analizy społeczności, zestawienie Topview/Medium 2.5, relacja FORCE od Pixo i kompletny przewodnik ToSea wszystkie obejmują upgrade'y workflow z perspektywy redakcyjnej. Przydatne jako kontekst, a nie szczegóły endpointów; zawsze potwierdzaj specyfikę techniczną względem działającego API.

Uwaga dla deweloperów: Przewodniki third-party szybko się dezaktualizują. Traktuj każdy z nich jako punkt startowy i potwierdzaj ścieżki endpointów, nazwy pól oraz koszty kredytów względem podłączonej ścieżki w dniu integracji. Szczegóły endpointów i uwierzytelniania w tym przewodniku są zweryfikowane na 2026-07-31, ale model jest wciąż wdrażany, więc ponownie sprawdź przed produkcyjnym launchem.

FAQ API Seedance 2.5

Jaki jest endpoint API Seedance 2.5?

Utwórz zadanie przez POST /api-platform/v1/generations, a następnie odpytuj GET /api-platform/v1/task/{task_id} do momentu, gdy status wyniesie ready. Pole modelu to seedance-2.5.

Jak uwierzytelnić się do API Seedance 2.5?

Wyślij swój klucz API jako Authorization: Bearer <key>. Nagłówek X-API-Key również jest akceptowany. Utwórz klucz z uprawnieniem wideo w panelu PixMind i wczytuj go ze zmiennej środowiskowej, zamiast zanurzać go w kodzie źródłowym.

Czy API Seedance 2.5 jest dostępne na PixMind?

Ścieżka jest udokumentowana i gotowa; dostęp do backendu jest finalizowany, a model ma oznaczenie Coming Soon. Strona /api-platform/models/seedance-2-5 zawiera referencję endpointu i parametrów, a strona /ai-video/seedance-2-5 w międzyczasie hostuje generator webowy.

Ile odniesień mogę wysłać w jednym żądaniu Seedance 2.5?

Do 50 wejść multimodalnych, obrazy, wideo, tekst i audio łącznie, w jednym żądaniu. To wzrost z 9 w Seedance 2.0. Każde odniesienie musi być publicznie osiągalnym URL-em.

Czy API Seedance 2.5 zwraca wideo synchronicznie?

Nie. Generacja wideo jest asynchroniczna. Wywołanie tworzące zwraca taskId; odpytuj endpoint zadania, aż status wyniesie ready, a następnie odczytaj videoUrl. Typowa 30-sekundowa generacja trwa kilka minut, projektuj więc klienta pod odpytywanie, a nie pod blokowanie.

Jakie są limity zapytań i ograniczenia współbieżności?

Endpoint tworzący wymusza per-klucz limity częstotliwości zapytań i współbieżności. Jeśli je przekroczysz, odpowiedź zwraca 429 i powinieneś wycofać się wykładniczo. W przypadku obciążeń batchowych (więcej niż kilku równoległych zadań) rozłóż zgłoszenia w krótkich odstępach i skontaktuj się z pomocą techniczną, aby podnieść limity, jeśli trafiasz na 429 regularnie. Dokładne limity liczbowe są dostosowywane per konto, zweryfikuj je na własnym kluczu przed zaprojektowaniem dużej partii zadań.

Czy API Seedance 2.5 obsługuje webhooki lub wywołania zwrotne?

Zweryfikowana ścieżka PixMind korzysta wyłącznie z odpytywania, a nie z wywołań zwrotnych push. Jeśli Twoja architektura wymaga powiadomień push, uruchom pojedynczy dyspozytor, który odpytuje endpoint zadania i emituje webhook do usług downstream, gdy status osiągnie stan końcowy. Utrzymuje to integrację prostą i unika sprzęgania pipeline'u z URL-em wywołania zwrotnego, który może się zmieniać między środowiskami.

Ile równoległych zadań mogę uruchomić?

Współbieżność jest ograniczona limitami per-klucz i saldem kredytów. Dla pracy 30-sekundowej 1080p spodziewaj się kilku równoległych zadań, a nie kilkunastu. Traktuj aktualny limit jako zweryfikowany-na-Twoim-koncie: prześlij małą partię kalibracyjną, zmierz, ile zadań jednocześnie przechodzi z pending do processing, i względem tej liczby dobierz rozmiar kolejki.

Jaki format wideo zwraca API?

Gotowe zadanie zwraca videoUrl wskazujący standardowy plik MP4, plus coverUrl dla klatki posterowej. Pobierz i transkoduj do formatu wymaganego przez cel dostawy (H.264 z fast-start dla web, kodowania pionowe dla social, ProRes dla mastering montażu). Nie hotlinkuj API-hostowanego videoUrl w produkcji, ponieważ nie ma gwarancji trwałości; skopiuj plik do własnego CDN przy stanie ready.

Jak sprawdzić kredyty przed przesłaniem?

Odczytaj z generatora na żywo aktualny koszt w kredytach przy wybranym czasie trwania i rozdzielczości, a następnie sprawdź saldo portfela. API zwraca 4001 „余额不足", gdy saldo jest zbyt niskie, a wtedy zadanie nie jest tworzone. W przypadku produkcyjnych pipeline'ów dodaj przed przesłaniem test saldu, który przerywa działanie wcześnie, gdy saldo jest poniżej progu per zadanie, aby nie kolejkować pracy, której portfel nie pokryje.

Jak naprawić błąd „模型不存在或未配置"?

Ta odpowiedź 400 oznacza, że ścieżka seedance-2.5 nie jest włączona na trafionym endpoincie backendu. Na PixMind to stan Coming Soon, podczas gdy połączenie backendu jest finalizowane. Potwierdź, że wywołujesz udokumentowaną ścieżkę /api-platform/v1/generations z model: "seedance-2.5" (małe litery, dokładnie). Jeśli oba są poprawne, a błąd utrzymuje się, ścieżka nie jest jeszcze otwarta na Twoim koncie; śledź stronę /api-platform/models/seedance-2-5 pod kątem dostępności.

Jakie rozdzielczości i czasy trwania mogę żądać?

Czas trwania do 30 sekund w jednym ujęciu; rozdzielczości 480p, 720p, 1080p oraz natywne 4K. Przed przesłaniem potwierdź dokładne opcje w generatorze na żywo, ponieważ podłączona ścieżka może udostępniać ich podzbiór.

Czy cennik API Seedance 2.5 jest opublikowany?

Jeszcze nie. Traktuj każdą kwotę za sekundę widzianą gdzie indziej jako szacunkową. Przed przesłaniem odczytaj z generatora na żywo aktualne kredyty przy wybranym czasie trwania i rozdzielczości, a także tak strukturyzuj pipeline, aby mógł wchłonąć aktualizację ceny bez przebudowy integracji.

Zacznij budować z API Seedance 2.5

API Seedance 2.5 to standardowa, asynchroniczna umowa generacji wideo: jedno wywołanie tworzące, jedna pętla odpytywania, jedno pobranie. Gdy masz już klucz z zakresem wideo, powyższe przykłady curl i Python to wszystko, czego potrzebujesz, aby dostarczyć pierwszą integrację. Tabela porównawcza i studium przypadku pipeline'u pokazują, jak przeskalować tę umowę z pojedynczego klipu do powtarzalnego, produkcyjnego workflow, który przetrwa edycje klienta, presję budżetową i terminy.

→ Przeczytaj pełną referencję ścieżki API Seedance 2.5 albo wypróbuj model w generatorze webowym, podczas gdy dostęp do API jest finalizowany.

Porównaj każdą ścieżkę Seedance

Szczegóły endpointów i uwierzytelniania zweryfikowane względem backendu platformy API PixMind na 2026-07-31. Linki do zasobów third-party zweryfikowane 2026-07-31. Pola porównania API Kling są oznaczone jako szacunkowe i powinny zostać potwierdzone względem aktualnej dokumentacji Kling. Cennik Seedance 2.5 jest nieopublikowany i oznaczony jako wyłącznie szacunkowy.