Seedance 2.0 Reference API: programowe generowanie wideo multimodalnego

Programowy dostęp do multimodalnego AI wideo zmienia to, co jest możliwe. Pojedyncze klipy świetnie sprawdzają się w marketingu i tworzeniu treści, ale zautomatyzowane przepływy pracy, takie jak generowanie wideo dla katalogów, personalizacja dla każdego użytkownika czy masowe operacje na treściach, wymagają dostępu przez API.

API Seedance 2.0 Reference udostępnia pełne możliwości multimodalne: do 9 obrazów, 3 filmów i 3 klipów audio w jednym zapytaniu, programowo, przy tym samym cenniku za sekundę co interfejs webowy.

Kiedy sięgnąć po API

Interfejs webowy świetnie sprawdza się przy ręcznej, jednostkowej pracy twórczej. API jest do wszystkiego innego.

API sprawdza się, gdy potrzebujesz:

• Masowego generowania dla setek zasobów
• Integracji z istniejącymi pipeline'ami treści lub produktów
• Spersonalizowanego wideo dla każdego użytkownika w aplikacji
• Zautomatyzowanego testowania A/B wariantów kreacji reklamowych
• Zaplanowanego generowania treści do codziennej publikacji
• Przepływów pracy w katalogach powiązanych z rekordami bazy danych

Zostań przy interfejsie webowym, gdy:

• Pracujesz twórczo i musisz widzieć oraz poprawiać każdy wynik
• Wolumen jest niski (mniej niż 10-20 klipów na sesję)
• Odkrywasz narzędzie po raz pierwszy

Endpoint

Endpoint Reference-to-video to:

bytedance/seedance-2.0/reference-to-video

To jedyny endpoint, którego potrzebujesz do generowania w trybie Reference multimodalnym. Jedno zapytanie obsługuje tekst, do 9 obrazów, do 3 filmów i do 3 klipów audio. Model łączy wszystkie dane wejściowe i zwraca wygenerowane wideo.

Do przepływów pracy tekstowych lub z pojedynczym obrazem użyj zamiast tego endpointów standardowe API Seedance 2.0.

Struktura zapytania

Typowe zapytanie Reference-to-video zawiera:

• prompt: Tekstowy opis tematu i akcji (wymagany)
• reference_images: Tablica do 9 adresów URL obrazów lub odwołań do plików
• reference_videos: Tablica do 3 adresów URL filmów (opcjonalna)
• reference_audio: Tablica do 3 adresów URL audio (opcjonalna)
• duration: Czas trwania wyjściowego wideo w sekundach, 4-15 (wymagany)
• aspect_ratio: Jedna z wartości 16:9, 9:16, 1:1 (wymagana)

Pliki wejściowe można podawać jako adresy URL (publicznie dostępne) lub przesyłać bezpośrednio, w zależności od wzorca integracji.

Ceny przez API

Ceny przez API są identyczne jak w interfejsie webowym:

Nie ma opłaty za dostęp do API ani dodatkowych kosztów za przesyłanie materiałów referencyjnych. Płacisz wyłącznie za wygenerowane sekundy wideo.

Kredyty działają tak samo przez API i interfejs webowy. Doładuj je przez strona cennika, a obie metody korzystają z tej samej puli kredytów. Przy intensywnym korzystaniu z API plan Studio za $120 (1800 kredytów miesięcznie) oferuje najlepszą stawkę za kredyt, a każde doładowanie, które dodasz, nigdy nie wygasa.

Zacznij budować z API. Uzyskaj dostęp do API z 10 darmowymi kredytami przy rejestracji. Zacznij za darmo.

Przykładowe zastosowania

Automatyzacja wideo dla katalogów

Dla platform e-commerce z setkami lub tysiącami SKU API pozwala generować krótkie wideo produktowe dla każdego produktu na podstawie istniejących zdjęć produktowych.

Przepływ pracy:

1. Pobierz dane z bazy produktów
2. Dla każdego produktu pobierz 5-7 zdjęć produktowych
3. Połącz z pakietem referencyjnym całej marki (2-3 obrazy)
4. Wywołaj API z szablonem promptu dla prezentacji produktu
5. Zapisz zwrócony adres URL wideo w rekordzie produktu
6. Wyświetl na stronach szczegółów produktu

Ekonomia: Katalog 500 SKU przy 5-sekundowych filmach = 500 × 303 kredyty = 151 500 kredytów = ~$1515. Jak na wdrożenie wideo dla całego katalogu, to wyjątkowa wartość.

Personalizowane generowanie wideo

Dla aplikacji dostarczających spersonalizowane wideo dla każdego użytkownika, takie jak kartki okolicznościowe, treści na uroczystości czy intro onboardingowe, API pozwala generować wideo na żądanie z referencjami specyficznymi dla użytkownika.

Przepływ pracy:

1. Użytkownik przesyła 3-5 osobistych zdjęć (za zgodą)
2. Twoja aplikacja łączy je z pakietem referencji stylowych
3. Wywołanie API generuje spersonalizowany klip wideo
4. Dostarcz go użytkownikowi przez swoją aplikację

Rozwiązanie skaluje się do dziesiątek tysięcy użytkowników bez konieczności angażowania zespołu contentowego.

Generowanie wariantów kreacji reklamowych

Zespoły marketingowe prowadzące płatne kampanie w mediach społecznościowych stale potrzebują nowych wariantów kreacji. API pozwala programowo generować warianty do testów A/B.

Przepływ pracy:

1. Zdefiniuj pakiet referencji marki (6-8 obrazów)
2. Napisz szablony promptów dla różnych kątów reklamowych
3. Przeiteruj przez warianty, wywołując API dla każdego
4. Dostarcz wygenerowane klipy do swojej platformy reklamowej
5. Śledź wyniki i generuj zwycięskie warianty na skalę

W jednym automatycznym przebiegu możesz wyprodukować 50 wariantów reklamowych za ~$150 kosztów API, zamiast tradycyjnej produkcji kosztującej tysiące dolarów za wariant.

Obsługa odpowiedzi

Odpowiedzi API zazwyczaj zawierają:

• ID generowania: Śledź status zapytania
• Status: pending, processing, complete, failed
• URL wyjściowy: Dostępny po osiągnięciu statusu complete
• Metadane: Czas trwania, rozdzielczość, rozmiar pliku

Generowania w trybie Reference zajmują 60-180 sekund, więc twoja integracja powinna obsługiwać odpowiedzi asynchroniczne. Odpytuj endpoint statusu lub korzystaj z webhooków (jeśli są dostępne na twoim koncie), aby otrzymywać powiadomienia o zakończeniu.

Nie blokuj przepływów widocznych dla użytkownika na zakończeniu generowania. Umieść zapytanie w kolejce, powiadom użytkownika, gdy będzie gotowe, i dostarczaj asynchronicznie.

Limity zapytań i współbieżność

Dla większości poziomów kont obowiązują limity współbieżnych generowań. Planuj masowe przepływy pracy tak, aby respektować te limity, kolejkując zapytania i przetwarzając je przy dozwolonej współbieżności.

W przypadku produkcyjnych przepływów o dużym wolumenie skontaktuj się z pomocą techniczną platformy w sprawie korporacyjnych limitów współbieżności. Większość standardowych kont bez problemu obsługuje umiarkowaną pracę wsadową (10-30 równoczesnych generowań).

Uwierzytelnianie i klucze

Dostęp do API korzysta ze standardowego uwierzytelniania opartego na kluczach. Wygeneruj swój klucz API w ustawieniach konta po rejestracji. Przechowuj klucze wyłącznie po stronie serwera, nigdy nie udostępniaj ich w kodzie klienta.

Idempotentność i ponawianie zapytań

Generowania przez API nie są natywnie idempotentne, ponieważ każde wywołanie kosztuje kredyty. Jeśli generowanie nie powiedzie się w trakcie procesu, logika ponawiania powinna sprawdzić status nieudanego generowania przed ponownym złożeniem zapytania. Nieudane generowanie zazwyczaj nie zużywa kredytów, ale zawsze weryfikuj to w panelu konta.

W przepływach produkcyjnych wdróż:

• Logikę ponawiania z wykładniczym wycofaniem przy przejściowych błędach
• Odpytywanie statusu lub obsługę webhooków dla asynchronicznego zakończenia
• Logowanie błędów do wykrywania systematycznych problemów
• Monitorowanie salda kredytów z alertem przed wyczerpaniem

Najlepsze praktyki dla programowych przepływów pracy

1. Używaj spójnych pakietów referencyjnych. W przypadku pracy nad katalogiem lub serią hashuj pakiety referencyjne, aby identyczne pakiety w różnych zapytaniach dawały bardziej spójny styl.

2. Utrzymuj szablony promptów prostymi. Programowe prompty powinny być generowane ze strukturyzowanych danych, nie pisane ręcznie dla każdego wywołania. Właściwym wzorcem jest szablon z polami danych.

3. Cachuj adresy URL plików referencyjnych. Jeśli używasz referencji opartych na adresach URL, upewnij się, że są one stabilne i dostępne. Wygasłe adresy URL S3 lub przeniesione pliki spowodują niepowodzenie generowania.

4. Odpowiednio obsługuj bezpieczeństwo treści. Platforma posiada filtry bezpieczeństwa treści. Wbuduj w swój przepływ pracy elegancką obsługę zapytań odrzuconych przez filtry.

5. Loguj metadane generowania. Śledź każde generowanie, takie jak prompt, zestaw referencji, czas trwania, zużyte kredyty i adres URL wyjściowy, w bazie danych swojej aplikacji. Znacznie ułatwi to debugowanie i raportowanie.

Przykładowy masowy przepływ pracy

Pseudokod dla masowego przepływu pracy generowania wideo produktowych:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} produkt obraca się powoli na czystej powierzchni, miękkie oświetlenie studyjne, 5 sekund"

    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)

Następnik do odpytywania obsługuje zakończenie i zapisuje adres URL wyjściowy przy rekordzie produktu.

Monitorowanie i kontrola kosztów

W przypadku produkcyjnego korzystania z API skonfiguruj monitorowanie kosztów:

• Dzienne alerty budżetowe: Alertuj, gdy dzienny wydatek na API przekroczy próg
• Limity na przepływ pracy: Ogranicz zadania wsadowe do maksymalnego wydatku kredytowego, aby zapobiec niekontrolowanej automatyzacji
• Dashboardy użytkowania: Śledź, które przepływy pracy zużywają najwięcej kredytów
• Alerty salda kredytów: Doładuj przed wyczerpaniem

Te zabezpieczenia zapobiegają niespodziankom przy skalowaniu automatyzacji.

Parytety cenowe API i interfejsu webowego

Częste pytanie: czy za korzystanie z API obowiązuje rabat? Nie. Zarówno API, jak i interfejs webowy naliczają tę samą stawkę $0.3024 za sekundę. API jest wyceniane za wykonywaną pracę, a nie za używany interfejs.

Użytkownicy o dużym wolumenie oszczędzają dzięki wyborowi odpowiedniego planu. Intensywni użytkownicy API powinni korzystać z plan Studio za $120, aby uzyskać najlepszą wartość za dolara.

Pierwsze kroki z API

1. Zarejestruj się na arteza.ai (10 darmowych kredytów)
2. Wygeneruj klucz API w ustawieniach konta
3. Doładuj pakiet kredytów odpowiadający oczekiwanemu wolumenowi
4. Zintegruj endpoint w swojej aplikacji
5. Zacznij od małych partii testowych, aby zweryfikować przepływ pracy
6. Skaluj do produkcji po zakończeniu testów

Pierwsze wywołanie API może być aktywne w ciągu godziny od rejestracji w przypadku większości integracji.

Co czytać dalej

Pełny zestaw funkcji Reference znajdziesz w Kompletny przewodnik po Seedance 2.0 Reference. Przepływ pracy w interfejsie webowym opisuje tutorial dotyczący spójności stylu. Szczegóły standardowego API Seedance 2.0 znajdziesz w przewodnik po API Seedance 2.0.

Programowe multimodalne wideo jest już tutaj. Zbuduj coś nowego z jego pomocą.