API Seedance 2.5: jak go wywołać, parametry, limity i koszty w kredytach

Krótka odpowiedź: Seedance 2.5 wywołasz przez API Yovid jednym kluczem. Wyślij POST https://yovid.ai/v1/videos/generations z "model": "seedance-2.5" i promptem, a następnie odpytuj GET /v1/tasks/{task_id}, aż status zmieni się na completed, i odczytaj output.video_url. Klipy trwają od 4 do 30 sekund, a jedno żądanie może zawierać do 30 obrazów, 10 filmów i 10 plików audio jako referencje. Rozliczenie odbywa się w tych samych kredytach Yovid co na stronie, a kredyty są pobierane tylko wtedy, gdy zadanie się powiedzie.

Spis treści

1. Skąd pochodzi dostęp do API Seedance 2.5
2. Szybki start w czterech krokach
3. Parametry żądania
4. Jak API wybiera tryb generowania
5. Limity referencji i mediów
6. Ile kosztuje żądanie
7. Błędy, ponowienia i limity zapytań
8. Kompletny przykład w Pythonie
9. Najczęstsze pytania

Skąd pochodzi dostęp do API Seedance 2.5

Seedance 2.5 to model ByteDance Seed. Oficjalna ścieżka ByteDance dla deweloperów prowadzi przez jego platformy chmurowe: wpis z 31 lipca 2026 zapowiadał dostęp przez BytePlus ModelArk, według doniesień prasowych Volcano Engine otworzył dostęp do API w Chinach 7 sierpnia, a strona Seedance 2.5 od ByteDance odsyła do playgroundu BytePlus.

Yovid to niezależna platforma, niepowiązana z ByteDance, która oferuje Seedance 2.5 przez własne API:

• Jeden klucz, jeden rachunek. Ten sam klucz i te same kredyty obejmują Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro i 1.0 Pro Fast.
• Stałe publiczne identyfikatory. Wysyłasz seedance-2.5; Yovid trzyma nazwy modeli dostawców wewnętrznie, więc mogą się zmieniać bez psucia Twojego kodu.
• To samo konto co na stronie. Klipy generowane przez API korzystają z planu i kredytów, które już masz.

Pełna dokumentacja jest w dokumentacji API Yovid (po angielsku); ten poradnik skupia się na tym, co dotyczy Seedance 2.5.

Szybki start w czterech krokach

1. Utwórz klucz API

Otwórz Ustawienia → Klucze API, nazwij klucz i utwórz go. Pełny sekret jest pokazywany tylko raz, więc zapisz go w menedżerze sekretów i wczytuj na serwerze jako YOVID_API_KEY. Nigdy nie umieszczaj go w kodzie przeglądarki ani aplikacji mobilnej.

2. Utwórz zadanie

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Odpytuj zadanie

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Odpytuj co 5–10 sekund, dopóki status to pending lub processing, stopniowo wydłużając odstępy. Gdy zmieni się na completed, adres filmu znajdziesz w output.video_url; jeśli zmieni się na failed, przestań odpytywać i odczytaj error.

4. Sprawdź kredyty

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available to kredyty, z których może skorzystać nowe zadanie; reserved to kredyty zablokowane dla zadań, które jeszcze trwają.

Parametry żądania

Przed utworzeniem zadania API sprawdza każdą wartość pod kątem modelu i Twojego planu, a jeśli coś jest niedozwolone, zwraca 403 lub 422 z problematycznym polem w param. Jeśli zaczynasz od klatki, wynik przyjmuje proporcje tego obrazu.

Jak API wybiera tryb generowania

Nigdy nie wysyłasz trybu dostawcy. Yovid wybiera go na podstawie dołączonych mediów:

W trybie referencji odwołuj się do plików w prompcie według ich kolejności w każdej tablicy: @image1, @image2, @video1, @audio1. Żądanie z referencjami wygląda tak:

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

Referencje audio to funkcja API: kompozytor na stronie przyjmuje obrazy i filmy, a API dodaje do 10 plików audio na głos, ścieżkę lub rytm.

Limity referencji i mediów

Ze strony modele i dane wejściowe (po angielsku) w dokumentacji API:

Wszystkie media muszą być publicznymi adresami HTTPS. Yovid odrzuca localhost, adresy sieci prywatnych, adresy z osadzonymi danymi logowania i nazwy hostów, których nie da się rozwiązać. Używaj adresów URL zamiast Base64; dostawca ogranicza treść każdego żądania do 64 MB.

Ile kosztuje żądanie

API rozlicza się w tych samych kredytach co strona i według tych samych stawek. Według podstawowych stawek pakietów Seedance 2.5 kosztuje około 3 kredytów za sekundę w 480p i około 6,1 w 720p, więc 10-sekundowy klip w 720p to około 61 kredytów, a 30-sekundowy około 183. Subskrybenci płacą mniej za sekundę.

• Filmy referencyjne są rozliczane według długości klipu referencyjnego plus długości wyniku, po niższej stawce: około 2,1 kredytu za sekundę w 480p i 4,6 w 720p.
• Wyłączenie content_filter mnoży koszt przez 1,1.
• Najpierw rezerwacja, potem pobranie. Kredyty są rezerwowane przy tworzeniu zadania i pobierane tylko po jego ukończeniu; nieudane zadanie je zwraca.
• Dostęp zależny od planu. Seedance 2.5 wymaga płatnego planu lub jednorazowego pakietu kredytów. Darmowe konto otrzyma 403 plan_upgrade_required.

Ukończone zadanie podaje zużycie w credits_used. Plany i pakiety znajdziesz na stronie z cenami, a najtańszy sposób na start w artykule Czy Seedance 2.5 jest za darmo?.

Błędy, ponowienia i limity zapytań

Każdy klucz pozwala na maksymalnie 120 żądań na minutę, a odpytywanie się do nich wlicza. Endpoint tworzenia nie obsługuje jeszcze kluczy idempotencji, więc nie ponawiaj automatycznie POST, jeśli nie wiesz, czy pierwszy się powiódł: możesz utworzyć drugie zadanie i dwukrotnie zarezerwować kredyty. Zapisuj każde otrzymane task_id.

Kompletny przykład w Pythonie

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

Prompt korzysta z beatów z oznaczeniem czasu – to najpewniejszy sposób na wypełnienie 30-sekundowego klipu. Poradnik promptów do Seedance 2.5 zawiera 13 promptów, które możesz wysłać bez zmian, a porównania z Kling 3.0, Veo 3.1 i Seedance 2.0 pomogą wybrać, który identyfikator modelu wywołać.

Najczęstsze pytania

Czy istnieje oficjalne API Seedance 2.5?

ByteDance udostępnia Seedance 2.5 deweloperom przez swoje platformy chmurowe, Volcano Engine i BytePlus. API Yovid to niezależna alternatywa: jeden klucz i jedno saldo kredytów dla Seedance 2.5 i pozostałych modeli Seedance.

Jaki jest identyfikator modelu Seedance 2.5 w Yovid?

seedance-2.5. Inne publiczne identyfikatory to seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro i seedance-1.0-pro-fast.

Jak długi może być film z API Seedance 2.5?

Od 4 do 30 sekund na zadanie, ustawiane parametrem duration.

Jakie rozdzielczości obsługuje API Seedance 2.5?

Dokumentacja API podaje 480p i 720p dla seedance-2.5. Limit wyznacza też Twój plan, a jeśli jakość go przekracza, API zwraca 403 jeszcze przed utworzeniem zadania.

Czy mogę wysłać audio jako referencję?

Tak, do 10 plików MP3 lub WAV w audio_urls, przywoływanych w prompcie jako @audio1, @audio2 i tak dalej. Referencje audio są dostępne tylko przez API.

Czy nieudane zadanie zużywa kredyty?

Nie. Kredyty są rezerwowane przy tworzeniu zadania i pobierane tylko po jego pomyślnym ukończeniu.

Ile żądań mogę wysłać?

Do 120 żądań na minutę na klucz, łącznie z odpytywaniem, plus limit równoczesnych zadań zależny od planu. Odpowiedź 429 oznacza: odczekaj i ponów z backoffem.

Chcesz zacząć? Utwórz klucz w Ustawieniach → Kluczach API i skorzystaj z szybkiego startu API (po angielsku).