Seedance 2.0 Reference API: Programmatyczne wideo multimodalne

Programowy dostęp do wielomodalnego AI video zmienia to, co jest możliwe. Jednorazowe klipy świetnie nadają się do marketingu i tworzenia treści, ale zautomatyzowane przepływy pracy - katalogowe generowanie video, personalizacja dla każdego użytkownika, operacje na zbiorczych treściach - wymagają dostępu do API.

Interfejs API Seedance 2.0 Reference ujawnia pełną możliwość wielomodalną: do 9 obrazów, 3 video i 3 klipy audio na żądanie, programowo, w tej samej cenie za sekundę co interfejs internetowy.

Kiedy sięgnąć po API

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

API jest odpowiednie, gdy potrzebujesz:

• Generowania zbiorczego dla setek zasobów
• Integracji z istniejącymi potokami treści lub produktów
• Spersonalizowanego video dla każdego użytkownika w aplikacji
• Zautomatyzowanego testowania A/B wariantów kreatywnych reklam
• Zaplanowanego generowania treści do codziennego publikowania
• Przepływów katalogowania powiązanych z rekordami bazy danych

Trzymaj się interfejsu internetowego, gdy:

• Iterujesz twórczo i musisz zobaczyć/dostosować każde wyjście
• Głośność jest niska (mniej niż 10-20 klipów na sesję)
• Poznajesz narzędzie po raz pierwszy

Endpoint

Endpoint Reference-to-video to:

bytedance/seedance-2.0/reference-to-video

To jest jedynym endpointem, którego potrzebujesz do wielomodalnych generacji trybu Reference. Jedno żądanie obsługuje tekst, do 9 obrazów, do 3 video i do 3 klipów audio. Model łączy wszystkie wejścia i zwraca wygenerowane video.

Dla przepływów tekst-na-video lub z jednym obrazem, zamiast tego użyj endpointów standardowy Seedance 2.0 API.

Struktura żądania

Typowe żądanie Reference-to-video obejmuje:

• prompt: Opis tekstowy przedmiotu i akcji (wymagane)
• reference_images: Tablica do 9 adresów URL obrazów lub odwołań do plików
• reference_videos: Tablica do 3 adresów URL video (opcjonalnie)
• reference_audio: Tablica do 3 adresów URL audio (opcjonalnie)
• duration: Czas trwania wyjścia w sekundach, 4-15 (wymagane)
• aspect_ratio: Jeden z 16:9, 9:16, 1:1 (wymagane)

Pliki wejściowe mogą być dostarczone jako adresy URL (publicznie dostępne) lub przesłane bezpośrednio, w zależności od Twojego wzorca integracji.

Cena w interfejsie API

Cena API dokładnie odpowiada cenie interfejsu internetowego:

Nie ma opłaty za dostęp do API ani dodatkowej opłaty za przesyłanie referencji. Płacisz tylko za sekundy wygenerowanego wyjścia.

Kredyty działają w taki sam sposób w API i interfejsie internetowym. Doładuj za pośrednictwem strona cennika, a ta sama pula kredytów jest używana przez oba interfejsy. W przypadku użytku API o dużej objętości, warstwa Max $100 (12 000 kredytów) to najbardziej ekonomiczny punkt początkowy.

Zacznij budować z API. Uzyskaj dostęp do API za pomocą 50 darmowych kredytów przy rejestracji. Zacznij za darmo.

Przykładowe przypadki użycia

Automatyzacja katalogowego video

W przypadku platform e-commerce z setkami lub tysiącami jednostek SKU, API umożliwia wygenerowanie krótkiego video produktu dla każdego produktu na podstawie istniejącego obrazu produktu.

Przepływ pracy:

1. Zapytaj bazę danych produktów
2. Dla każdego produktu pobierz 5-7 obrazów produktu
3. Połącz z pakietem referencji ogólnobrandowej (2-3 obrazy)
4. Wywołaj API za pomocą szablonu promptu dla ujawnienia produktu
5. Zapisz zwrócony adres URL video w rekordzie produktu
6. Podawaj na stronach szczegółów produktu

Ekonomia: Katalog 500 SKU z 5-sekundowymi video = 500 × 303 kredyty = 151 500 kredytów = ~$1,515. W przypadku ogólnokatalogowego wdrożenia video, to niezwykła wartość.

Spersonalizowane generowanie video

W aplikacjach, które dostarczają spersonalizowane video dla każdego użytkownika - kartki pozdrawiające, treści celebracyjne, intro wdrażające - API umożliwia generowanie video 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 stylu
3. Wywołanie API generuje spersonalizowany klip video
4. Dostarcz użytkownikowi za pośrednictwem aplikacji

To skaluje się do dziesiątek tysięcy użytkowników bez obciążenia zespołu tworzącego treści.

Generowanie wariantów kreatywnych reklam

Zespoły marketingowe prowadzące płatne media społecznościowe potrzebują stałych wariantów kreatywnych. API umożliwia programowe generowanie wariantów testowania A/B.

Przepływ pracy:

1. Zdefiniuj pakiet referencji marki (6-8 obrazów)
2. Napisz szablony promptu dla różnych kątów reklamy
3. Przeglądaj warianty, wywołując API dla każdego
4. Dostarcz wygenerowane klipy do platformy reklamowej
5. Śledź wydajność i generuj zwycięzców na dużą skalę

Możesz wyprodukować 50 wariantów reklam w zautomatyzowanym uruchomieniu za ~$150 w kosztach API, w porównaniu z tradycyjną produkcją za tysiące za wariant.

Obsługa odpowiedzi

Odpowiedzi API typowo obejmują:

• Identyfikator generowania: Śledź status żądania
• Status: pending, processing, complete, failed
• Adres URL wyjścia: Dostępny po ukończeniu statusu
• Metadane: Czas trwania, rozdzielczość, rozmiar pliku

Generacje w trybie Reference trwają 60-180 sekund, więc twoja integracja powinna obsługiwać asynchroniczne odpowiedzi. Sonduj endpoint statusu lub użyj webhooks (jeśli są dostępne na Twoim koncie), aby być powiadomiony o ukończeniu.

Nie blokuj przepływów skierowanych do użytkownika na ukończeniu generowania. Umieść żądanie w kolejce, powiadom użytkownika, gdy będzie gotowe, i dostarcz asynchronicznie.

Limity szybkości i współbieżność

W większości warstw kont obowiązują limity współbieżnego generowania. Zaplanuj zbiorczące przepływy pracy, aby respektować limity - umieść żądania w kolejce i przetwórz je na dozwolonej współbieżności.

W przypadku przepływów produkcji o dużej objętości skontaktuj się z pomocą platformy dotyczącą limitów przedsiębiorczej współbieżności. Większość standardowych kont może obsługiwać umiarkowaną pracę zbiorczą (10-30 współbieżnych generacji) bez problemów.

Uwierzytelnianie i klucze

Dostęp do API używa standardowego uwierzytelniania opartego na kluczach. Wygeneruj klucz API w ustawieniach konta po zarejestrowaniu się. Przechowuj klucze tylko po stronie serwera - nigdy nie ujawniaj ich w kodzie klienta.

Idempotencja i ponowne próby

Generacje API nie są natywnie idempotentne, ponieważ każde wywołanie kosztuje kredyty. Jeśli generowanie nie powiedzie się w trakcie procesu, logika ponowienia powinna sprawdzić status nieudanego generowania przed ponownym żądaniem. Nieudane generowanie zwykle nie zużywa kredytów, ale zawsze zweryfikuj w panelu konta.

W przypadku przepływów produkcji wdrożyć:

• Logikę ponowienia z wykładniczym cofnięciem w przypadku przejściowych awarii
• Sondowanie statusu lub obsługę webhook dla asynchronicznego ukończenia
• Rejestrowanie błędów w celu przechwycenia systematycznych problemów
• Monitorowanie salda kredytów w celu alertu przed wyczerpaniem

Najlepsze praktyki dla przepływów pracy programowych

1. Użyj spójnych pakietów referencji. W pracy katalogowej lub seriowej, hash pakietów referencji, aby identyczne pakiety w żądaniach produkowały bardziej spójny styl.

2. Utrzymuj szablony promptu proste. Prompty programowe powinny być generowane ze strukturalnych danych, nie ręcznie pisane na żądanie. Szablon + pola danych to właściwy wzorzec.

3. Buforuj adresy URL plików referencji. Jeśli używasz referencji opartych na adresach URL, upewnij się, że adresy URL są stabilne i dostępne. Wygasłe adresy URL S3 lub przeniesione pliki zakończą się niepowodzeniem generacji.

4. Obsługuj bezpieczeństwo treści odpowiednio. Platforma ma filtry bezpieczeństwa treści. Zbuduj wdzięczną obsługę dla żądań odrzuconych przez filtry w twojego przepływu pracy.

5. Loguj metadane generowania. Śledź każde generowanie - prompt, zestaw referencji, czas trwania, zużyte kredyty, adres URL wyjścia - w bazie danych aplikacji. To znacznie ułatwia debugowanie i raportowanie.

Przykład zbiorczego przepływu pracy

Pseudokod dla zbiorczego przepływu pracy generowania video produktu:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} product rotates slowly on a clean surface, soft studio lighting, 5 seconds"

    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ępujący soonder obsługuje ukończenie i przechowuje adres URL wyjścia w rekordzie produktu.

Monitorowanie i kontrola kosztów

W przypadku użytku API produkcji ustaw monitorowanie kosztów:

• Dzienne alerty budżetu: Alert gdy dzienne wydatki API przekroczą próg
• Limity na przepływ pracy: Ogranicz zadania zbiorczowe do maksymalnego wydatku kredytów, aby zapobiec ucieczce automatyzacji
• Pulpity użycia: Śledź które przepływy pracy zużywają najwięcej kredytów
• Alerty salda kredytów: Doładuj przed wyczerpaniem

Te zabezpieczenia zapobiegają niespodziankom podczas skalowania automatyzacji.

Parytet cen API a Web UI

Częste pytanie: czy jest rabat za użycie API? Nie - zarówno API jak i web UI obciążają tę samą kwotę $0.3024 za sekundę. API jest wyceniana za pracę, którą wykonuje, nie za interfejs, którego używasz.

Tam gdzie użytkownicy o dużej objętości oszczędzają, to w wyborze warstwy. Intensywni użytkownicy API powinni działać na Maksymalny tier $100 dla najlepszej wartości za dolara.

Rozpoczęcie pracy z API

1. Zarejestruj się na arteza.ai (50 darmowych kredytów)
2. Wygeneruj klucz API w ustawieniach konta
3. Doładuj pakiet kredytów dopasowany do oczekiwanej objętości
4. Zintegruj endpoint w aplikacji
5. Zacznij od małych testowych partii, aby sprawdzić przepływ pracy
6. Skaluj do produkcji po przetestowaniu

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

Dalsze lektury

Aby zapoznać się z pełnym zestawem funkcji Reference, przeczytaj Seedance 2.0 Reference kompletny przewodnik. W przypadku przepływu pracy interfejsu internetowego, zobacz poradnik zgodności stylu. W przypadku standardowych szczegółów API Seedance 2.0, sprawdź Seedance 2.0 API przewodnik.

Programowe wielomodalne video jest tutaj. Zbuduj coś nowego z nim.