<!-- Canonical URL: https://ask.atlascloud.ai/pl/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Szybki start API Seedance 2.5: Wygeneruj swoje pierwsze wideo z Atlas Cloud

> Wdróż działającą integrację wideo Seedance dziś na Atlas Cloud za pomocą jednego klucza API i dwóch wywołań REST, a następnie zamień na Seedance 2.5 przy uruchomieniu, zmieniając jeden ciąg modelu.

Przeczytałeś ogłoszenie [Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud), naszkicowałeś funkcję produktu wokół 30-sekundowych generowanych klipów i teraz chcesz napisać kod. I wtedy uderzasz w ścianę, którą uderza każdy programista, gdy ma do czynienia ze świeżo ogłoszonym modelem: strona z możliwościami jest aktywna, ale endpoint, który faktycznie możesz wywołać ze swojej aplikacji, to zupełnie inna kwestia.

Oto szczera wersja sytuacji oraz szybki start, który ją uwzględnia. Atlas Cloud opublikował stronę rodziny [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5, zobowiązując się do dostępu w dniu premiery na tych samych ujednoliconych endpointach, które już obsługują [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) i 1.5. W momencie pisania tego tekstu ta oferta jest oznaczona jako "Coming Soon", a cena Atlas Cloud dla Seedance 2.5 nie została jeszcze opublikowana. Co to oznacza w praktyce? Dobrą wiadomość: integracja, którą zbudujesz dzisiaj na aktywnym tierze Seedance, będzie tą samą integracją, którą uruchomisz przy starcie 2.5. Jedyną rzeczą, która się zmienia, jest ciąg znaków modelu.

Zatem ten szybki start robi dwie rzeczy. Pozwala uzyskać prawdziwy film z prawdziwego endpointu już dziś i strukturyzuje twój kod oraz twoje prompty tak, aby aktualizacja była zmianą w jednej linii.

## Co faktycznie jest dostarczane w Seedance 2.5

Zgodnie z oficjalną stroną Seedance 2.5 firmy ByteDance, jest to model nowej generacji do wspólnego generowania audio-wideo, zbudowany do 30-sekundowego opowiadania historii z precyzyjną kontrolą referencji i potężnym montażem. Konkretne twierdzenia, które warto uwzględnić w projekcie:

* Do 30 sekund w pojedynczej generacji, z opcją przedłużenia dwukrotnie w celu dłuższego, pełniejszego opowiadania historii
* Płynniejszy i bardziej spójny ruch, z bardziej realistycznymi obrazami
* Bardziej precyzyjne rozumienie wideo referencyjnego, uchwycenie intencji, kadrowania i języka filmowego, a nie tylko przenoszenie ruchu
* Bardziej niezawodny montaż w szerszym zakresie edycyjnych zapytań audio i wizualnych
* Sterowanie modelem na białym tle i montaż na zielonym ekranie, plus profesjonalny ruch kamery i blokowanie ruchu aktorów, ukierunkowane na złożone przepływy produkcji

Zwróć uwagę, czego nie ma na tej liście: żadnej tabeli porównawczej, żadnej drabiny rozdzielczości, żadnej liczby zasobów referencyjnych. Wszystko, co widziałeś w tym stylu, to czyjś marketingowy szum, a nie oficjalna specyfikacja producenta. Buduj w oparciu o powyższe twierdzenia.

## Krok 1: uzyskaj klucz z konsoli

Zaloguj się na console.atlascloud.ai i utwórz klucz API. Nie ma depozytu, minimalnego zobowiązania ani listy oczekujących, więc klucz jest natychmiast użyteczny w modelu pay-as-you-go. Jeden klucz obejmuje pełny katalog ponad 300 modeli w zakresie tekstu, obrazu i wideo, na jednym koncie rozliczeniowym – to właśnie jest istotne dla tego szybkiego startu: klucz, który wygenerujesz teraz, to ten sam klucz, który będzie wywoływał Seedance 2.5.

Przechowuj go jako zmienną środowiskową, nigdy w kodzie źródłowym. `ATLASCLOUD_API_KEY` to dobra nazwa.

## Krok 2: prześlij zadanie wideo

Generowanie wideo na Atlas Cloud to dwuetapowe asynchroniczne wywołanie REST, a nie uzupełnianie czatu. Wysyłasz zadanie POST i otrzymujesz identyfikator predykcji, a następnie odpycujesz ten identyfikator, aż renderowanie się zakończy. Każdy klient HTTP będzie odpowiedni, więc nie ma potrzeby instalowania SDK dostawcy ani uczenia się nowego schematu uwierzytelniania: to token Bearer na właśnie wygenerowanym kluczu.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

Odpowiedź ma postać `{"code": 200, "data": {"id": "...", "status": "processing"}}`. Zwróć uwagę, że `model` to zwykłe pole tekstowe. Ten szczegół to cała historia aktualizacji w tym artykule, a Krok 6 do tego wraca.

## Krok 3: odpycuj, aż renderowanie się zakończy

5-sekundowy klip nie jest natychmiastową odpowiedzią, więc traktuj renderowanie jako zadanie z cyklem życia, a nie wywołanie blokujące. Odpycuj endpoint predykcji, aż `status` osiągnie wartość końcową.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # po sukcesie ładunek zawiera adres(y) URL wyniku
```

Warto teraz zbudować dwie rzeczy, a nie później. Ustaw górny limit dla pętli odpytywania, aby zablokowane zadanie nie mogło zawiesić procedury obsługi żądania, i zapisz identyfikator predykcji przed rozpoczęciem odpytywania, aby uszkodzony proces roboczy mógł wznowić działanie zamiast płacić za renderowanie dwukrotnie. Oba nawyki pozostają niezmienione w wersji 2.5.

Jeśli twoja funkcja działa na podstawie obrazu referencyjnego lub referencji obiektu zamiast czystego tekstu, ten sam przepływ ma zastosowanie z innym wariantem modelu, `bytedance/seedance-2.0/image-to-video` lub `bytedance/seedance-2.0/reference-to-video`. Zasoby referencji obiektu są przesyłane raz przez `uploadMedia`, a następnie przekazywane jako `asset://<id>` w polach obrazu, więc powtarzająca się postać lub produkt nie wymaga ponownego przesyłania przy każdym wywołaniu.

## Krok 4: wybierz aktywny tier Seedance i dowiedz się, ile kosztuje sekunda

Atlas Cloud rozlicza wideo za sekundę czasu trwania wyjścia. To arytmetyka, którą możesz wykonać w głowie, zanim napiszesz jakikolwiek kod. Trzy tiers Seedance są dziś aktywne:

| Model | ID modelu | Cena Atlas Cloud | Uwagi |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/s | Flagowy aktywny tier, natychmiastowy klucz, brak listy oczekujących |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/s | Szybszy wariant tej samej rodziny |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/s | Najtańszy aktywny tier Seedance 2.0, również image-to-video i reference-to-video |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/s, lub $0.018/s w wariancie Fast | Natywne zsynchronizowane audio, wielojęzyczny synchronizacja ruchu ust, 4 do 12 sekundowe klipy |

Dla orientacji, inne modele wideo na tym samym kluczu mieszczą się w podobnym przedziale: Grok Imagine Video v1.5 za $0.080/s, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) za $0.100/s, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo za $0.112 standard i $0.095 z rabatem, MiniMax H3 za $0.14/s.

Który z nich wybrać do budowy zależy od tego, co twoja funkcja 2.5 będzie docelowo robić. Jeśli audio jest kluczowe dla wyniku, Seedance 1.5 Pro to tier, który już ma natywne zsynchronizowane audio i wielojęzyczną synchronizację ruchu ust, więc twój potok uczy się obsługiwać ścieżkę audio od pierwszego dnia. Jeśli iterujesz nad strukturą promptów i chcesz najniższego kosztu na eksperyment, Seedance 2.0 Mini za $0.056/s jest oczywistym piaskownicą. Jeśli chcesz czegoś najbliższego produkcyjnemu renderowi obecnej generacji, Seedance 2.0 za $0.112/s jest prostym wyborem, z wariantem Fast za $0.09/s, jeśli przepustowość ma większe znaczenie niż ostatni przyrost jakości.

## Krok 5: sprawdź aktualną cenę w Playground przed wydaniem pieniędzy

Przed pierwszym płatnym wywołaniem otwórz model w Atlas Cloud Playground. Każdy model pokazuje swoją aktualną cenę za model obok przycisku Uruchom. To ma większe znaczenie, niż się wydaje: promocyjne rabaty pojawiają się i znikają, a liczba obok przycisku Uruchom to ta, która faktycznie zostanie rozliczona. Uruchom jedną generację w Playground, potwierdź, że wynik jest tym, czego potrzebuje twoja funkcja, a następnie przenieś ustawienia do kodu.

Model rozliczania za sekundę czasu wyjścia sprawia również, że rozmowa o budżecie jest trywialna. 10-sekundowy klip na Seedance 2.0 Mini to 10 × $0.056. Nie ma kalkulatora, szacowania tokenów ani kroku uzgadniania po fakcie.

Warto to porównać z tym, jak kanały pierwszej strony ByteDance rozliczają Seedance. Na Volcano Engine Ark w Chinach i BytePlus ModelArk międzynarodowo, rozliczanie jest oparte na tokenach: szacowane zużycie tokenów to (czas trwania wideo wejściowego + czas trwania wideo wyjściowego) × szerokość wyjścia × wysokość wyjścia × liczba klatek na sekundę wyjścia / 1024, pomnożone przez cenę jednostkową tokena, przy czym rzeczywiste użycie jest autorytatywne na podstawie pola `usage.completion_tokens` w odpowiedzi API. Dla serii Seedance 2.0 i Seedance 2.5, gdy dane wejściowe obejmują wideo, stosowane jest minimalne zużycie tokenów, a próg zależy od rozdzielczości, proporcji obrazu i czasu trwania wyjścia. ByteDance publikuje kalkulator cen oraz tabelę minimalnych tokenów właśnie z tego powodu.

Oba modele są uzasadnione. Ale jeśli budżetujesz 30-sekundowe renderowanie, rozliczanie za sekundę czasu wyjścia to arytmetyka umysłowa, a tokeny z progami wymagają arkusza kalkulacyjnego.

## Krok 6: napisz opis ujęcia tak, jakby to już była wersja 2.5

To jest część szybkiego startu, która przenosi się idealnie, ponieważ umiejętność tworzenia promptów nie jest wersjonowana. Dwa z twierdzeń o możliwościach 2.5 powinny zmienić sposób, w jaki piszesz już dziś.

**Precyzyjna kontrola referencji.** Twierdzenie ByteDance jest takie, że 2.5 odczytuje wideo referencyjne pod kątem jego intencji, kadrowania i języka filmowego, wykraczając poza przenoszenie ruchu. Implikacja dla promptów jest taka, że twój zasób referencyjny przestaje być szablonem ruchu, a staje się briefem reżyserskim. Więc przestań pisać prompty, które opisują tylko obiekt, i zacznij nazywać gramatykę, którą chcesz przenieść: odczucie obiektywu, kadrowanie, tempo cięcia, czy kamera prowadzi, czy podąża za obiektem. Napisz "handheld, subject-following medium shot, slight lag on turns" zamiast "person walking, cinematic".

**Trzydzieści sekund w pojedynczej generacji.** 5-sekundowy klip to jedno ujęcie. Trzydzieści sekund to scena ze strukturą, a 2.5 obsługuje dwukrotne przedłużenie na wierzchu. Więc pisz opisy ujęć ze strukturą beatów, a nie pojedynczym statycznym opisem: beat wprowadzający, zmiana (zakręt, wejście, odkrycie) i rozwiązanie. Nazywaj ruch kamery i blokowanie ruchu aktorów wprost, ponieważ są to dokładnie te elementy sterowania, na które celuje 2.5. Gdzie stoi obiekt, gdzie się porusza, co robi kamera, gdy się porusza.

Oba nawyki opłacają się na aktywnych tierach już teraz. Oba są dokładnie tymi nawykami, które nagradza 2.5.

## Krok 7: zaplanuj zamianę

Strukturyzuj swój kod tak, aby identyfikator modelu był konfiguracją, a nie literałem. Jedna stała, odczytywana ze środowiska lub konfiguracji:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Następnie przekaż `SEEDANCE_MODEL` tam, gdzie Krok 2 miał na sztywno wpisany ciąg znaków. Ponieważ `model` to pojedyncze pole JSON w treści `generateVideo`, aktualizacja przy starcie 2.5 to naprawdę jedna zmienna środowiskowa. Nie metafora małej zmiany, dosłownie jedna wartość.

Nigdy nie koduj na sztywno identyfikatora Seedance 2.5 dzisiaj, ponieważ żaden identyfikator modelu Atlas Cloud Seedance 2.5 jeszcze nie istnieje. Pobieraj dokładne identyfikatory aktywnych modeli z katalogu na atlascloud.ai/models, zamiast kopiować je z artykułu, w tym tego, ponieważ z czasem dodawane są nowe warianty. Gdy 2.5 pojawi się zgodnie z zobowiązaniem na dzień premiery, praca po twojej stronie to ta jedna zmienna, plus świeże spojrzenie na cenę obok przycisku Uruchom i ponowne przeczytanie ewentualnych nowych parametrów żądania, ponieważ 30-sekundowy model z obsługą przedłużania może przyjąć pola, których ciało 2.0 nie ma.

Tymczasem, jeśli potrzebujesz Seedance 2.5 już teraz, a nie przy starcie Atlas Cloud, uczciwą odpowiedzią są kanały pierwszej strony ByteDance: Volcano Engine Ark w Chinach i BytePlus ModelArk międzynarodowo. Wśród agregatorów kilka jest w tym samym stanie przedpremierowym lub zobowiązania na dzień premiery.

## FAQ

P: Czy mogę wywołać Seedance 2.5 na Atlas Cloud już teraz?
O: Nie. Strona rodziny Seedance 2.5 na Atlas Cloud jest oznaczona jako "Coming Soon" z zobowiązaniem dostępu w dniu premiery na tych samych ujednoliconych endpointach, które już obsługują Seedance 2.0 i 1.5. Nie opublikowano jeszcze dla niego żadnego identyfikatora modelu ani ceny.

P: Ile kosztuje Seedance na Atlas Cloud dzisiaj?
O: Seedance 2.0 kosztuje $0.112/s, Seedance 2.0 Fast kosztuje $0.09/s, Seedance 2.0 Mini kosztuje $0.056/s, a Seedance 1.5 Pro kosztuje $0.047/s lub $0.018/s w wariancie Fast. Rozliczanie jest za sekundę czasu trwania wyjścia, a aktualna cena jest wyświetlana obok przycisku Uruchom w Playground.

P: Czy potrzebuję specjalnego SDK dla wideo na Atlas Cloud?
O: Nie. Wideo to prosty przepływ REST: `POST /api/v1/model/generateVideo` w celu przesłania zadania, a następnie `GET /api/v1/model/prediction/{id}` w celu odpytywania, oba uwierzytelnione tokenem Bearer na twoim kluczu Atlas Cloud. Każdy klient HTTP działa. Zwróć uwagę, że wideo nie przechodzi przez endpoint czatu zgodny z OpenAI, którego używa katalog tekstowy, więc nie oczekuj, że `chat.completions` wyrenderuje klip. Parametry żądania dla poszczególnych modeli są udokumentowane na atlascloud.ai/docs.

P: Czy wymagany jest depozyt lub minimalne zobowiązanie, aby rozpocząć?
O: Nie. Atlas Cloud jest modelem pay-as-you-go bez depozytu, minimalnego zobowiązania i listy oczekujących, a klucz z console.atlascloud.ai jest natychmiast użyteczny.

P: Na którym aktywnym tierze powinienem prototypować, jeśli celuję w 2.5?
O: Seedance 2.0 Mini za $0.056/s do taniej iteracji promptów, Seedance 1.5 Pro, jeśli twój potok musi obsługiwać natywną zsynchronizowaną ścieżkę audio, oraz Seedance 2.0 za $0.112/s dla najbliższego produkcyjnego renderu obecnej generacji.

## Podsumowanie

Atlas Cloud uruchamia Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini i Seedance 1.5 Pro już dziś na jednym kluczu API z rozliczaniem za sekundę czasu trwania wyjścia, certyfikatem SOC II, zgodnością z HIPAA oraz szyfrowaniem w spoczynku i w tranzycie, i opublikował zobowiązanie na dzień premiery do obsługi Seedance 2.5 na tych samych ujednoliconych endpointach, gdy zostanie wydany.

Aby uzyskać powiązane wskazówki dotyczące implementacji, zobacz [najnowsze API obrazu, wideo i LLM dostępne teraz](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) oraz [szacowanie wydajności, opóźnień i kosztów wnioskowania AI](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).