# Jak przenieść aplikację wideo z Sora API do Seedance lub Wan? > Migruj z Sora do Seedance lub Wan, oddzielając stabilny wewnętrzny kontrakt zadania wideo od payloadu dostawcy. Mapuj prompt, wejścia, długość, rozmiar, dźwięk i status przez adapter, zapisuj każdy zewnętrzny identyfikator i porównuj zaakceptowane wyniki na stałym zestawie regresyjnym przed zmianą ruchu. # Jak przenieść aplikację wideo z Sora API do Seedance lub Wan? Najbezpieczniejsza migracja zmienia adapter dostawcy, a nie cały produkt. Zachowaj wewnętrzny kontrakt zadania dla promptu, mediów, długości, orientacji, audio i dostarczania, a na brzegu przetłumacz go na żądanie Sora, Seedance lub Wan. Nie zastępuj `sora-2` inną nazwą i nie wysyłaj tego samego payloadu. API mają wspólny wzorzec asynchroniczny, ale różne endpointy, formaty, wartości, pola mediów i statusy. ## Zinwentaryzuj zachowania Sora używane przez aplikację Aktualna [dokumentacja Videos API](https://platform.openai.com/docs/api-reference/videos) OpenAI opisuje `POST /v1/videos`, pobieranie statusu oraz pola `prompt`, `input_reference`, `model`, `seconds` i `size`. Aplikacja może też zależeć od remixów, pobierania, obiektów SDK i błędów OpenAI. Przed zmianą zapisz faktyczne zależności: | Zależność | Pytanie | |---|---| | Model | Czy kod jest związany z `sora-2` lub `sora-2-pro`? | | Wejście | Tekst, jedna referencja czy istniejące wideo? | | Długość | Jakie wartości występują w produkcji? | | Rozmiar | Czy UI zapisuje piksele, proporcje czy presety? | | Audio | Czy produkt obiecuje wygenerowany dźwięk? | | Status | Jak statusy dostawcy mapują się lokalnie? | | Wynik | Czy jest streamowany, pobierany, kopiowany czy linkowany? | | Błąd | Co jest ponawiane, pokazywane lub eskalowane? | Inwentaryzacja pokaże, czy zmieniasz tylko model, czy również workflow. ## Zdefiniuj neutralne zadanie wideo Utwórz obiekt opisujący intencję produktu bez założenia, że każdy dostawca ma te same kontrolki. ```json { "job_id": "vid_01J...", "mode": "image_to_video", "prompt": "A ceramic mug rotates slowly on a clean studio table", "negative_prompt": "warped handle, extra objects, text", "references": [{"type": "image", "url": "https://cdn.example/mug.png"}], "duration_seconds": 5, "aspect_ratio": "9:16", "resolution_tier": "standard", "audio": "off", "seed": 42, "metadata": {"tenant": "shop_17", "purpose": "product_ad"} } ``` Oznacz możliwości jako wymagane, preferowane lub opcjonalne. Ciche usunięcie wymaganej referencji jest błędem produktu. Pole seed można pominąć dla niewspieranej trasy, ale decyzję należy zapisać. ## Mapuj intencję, nie nazwy pól Sora używa wymiarów przez `size`. Seedance może udostępniać `ratio`, `resolution`, `duration`, tablice referencji i audio. Wan zależnie od modelu używa `size` lub `ratio` i może mieć rozszerzanie promptu, typ ujęcia, referencje lub edycję. | Intencja | Przykład Sora | Mapowanie Seedance lub Wan | |---|---|---| | Model | `sora-2` | Dokładny aktywny identyfikator Atlas | | Wysłanie | `POST /v1/videos` | `POST /api/v1/model/generateVideo` | | Prompt | `prompt` | Zwykle `prompt` | | Referencja | `input_reference` | Trasowe `image` lub `reference_images` | | Długość | `seconds` | Trasowe `duration` i dozwolony zakres | | Kształt klatki | `size` | `ratio`, `size` albo rozdzielczość z proporcją | | Audio | Zachowanie modelu | Trasowe `generate_audio` lub wejście audio | | Klucz wyniku | ID wideo | Prediction ID z odpowiedzi | | Status | Endpoint statusu wideo | `GET /api/v1/model/prediction/{id}` | To lista kontrolna, nie schemat. Dokładne wartości skopiuj z wybranej aktywnej strony modelu. ## Wybierz trasę Seedance świadomie Seedance jest rodziną, nie jednym wymiennym endpointem. Atlas Cloud opisuje przepływy tekstowe, obrazowe i referencyjne. [Seedance 2.0 Fast reference-to-video](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/reference-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan) przyjmuje referencje i ma trasowe ustawienia długości, rozdzielczości, proporcji, bitrate oraz audio. Rozważ Seedance dla: * krótkich klipów audiowizualnych; * sterowania podmiotem, stylem lub sceną przez referencje; * formatów społecznościowych i reklamowych; * wyboru między szybką iteracją a wyższą jakością. Nie zakładaj wspólnych wejść dla wszystkich wariantów. Wybierz trasę według trybu i zweryfikuj zadanie jej schematem. ## Wybierz trasę Wan świadomie Wan oferuje wiele generacji i ścieżek edycji. [Strony Wan w Atlas Cloud](https://www.atlascloud.ai/models/wan-3.0?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan) obejmują nowszy Wan 3.0 i wcześniejsze wydania, a pojedyncze endpointy definiują text-to-video, image-to-video, referencję lub video-edit. Rozważ Wan dla: * szerokiego wyboru generowania i edycji; * rozszerzania promptu lub kontroli ujęcia na wspieranych trasach; * workflow referencyjnych lub z wideo źródłowym; * drugiej rodziny modeli dla jakości lub dostępności. Pierwsza migracja powinna używać jednego dokładnego endpointu. Ogólny adapter `wan` szybko staje się zbiorem ukrytych warunków. ## Implementuj jawne adaptery Walidację trzymaj przy adapterze. Ten uproszczony szkic pokazuje granicę bez wymyślania pól trasowych. ```python def to_atlas_payload(job, route): payload = { "model": route.model_id, "prompt": job["prompt"], } if job.get("duration_seconds") is not None: payload[route.duration_field] = route.map_duration(job["duration_seconds"]) if job.get("aspect_ratio"): route.apply_frame_shape(payload, job["aspect_ratio"], job.get("resolution_tier")) if job.get("references"): route.apply_references(payload, job["references"]) if job.get("audio") != "unspecified": route.apply_audio(payload, job["audio"]) route.validate(payload) return payload ``` Konfiguracja ma odrzucać niewspierane wymagania, a nie potajemnie skracać 12 sekund do 5, zmieniać poziom na pion lub ignorować referencję. Zapisuj zadanie wewnętrzne i rzeczywisty payload, aby móc odtworzyć regresję jakości lub rozliczenia. ## Zachowaj bezpieczeństwo zadań asynchronicznych Atlas Cloud zwraca prediction ID i opisuje cykl w [przewodniku Predictions](https://www.atlascloud.ai/docs/en/predictions?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan). Używaj trwałych statusów lokalnych zamiast rozprowadzać statusy dostawców po aplikacji. | Stan lokalny | Znaczenie | |---|---| | `ready` | Zweryfikowane, ale niewysłane | | `submitted` | Zapisano ID zewnętrzne | | `processing` | Dostawca przetwarza | | `succeeded` | Pobrano metadane wyniku | | `failed` | Dostawca zwrócił błąd końcowy | | `rejected` | Wynik ukończony, ale nie przeszedł jakości | Utwórz klucz idempotencji przed wysłaniem. Zapisz dostawcę, trasę, hash payloadu i zewnętrzny identyfikator w jednym trwałym rekordzie. Po utracie połączenia worker musi sprawdzić rekord przed nowym płatnym zadaniem. Polluj z rosnącym odstępem i jitterem. Częstsze zapytania nie przyspieszają wideo. ## Zbuduj zestaw regresyjny migracji Użyj 20 do 50 prawdziwych zadań, w tym trudnych przypadków. Zachowaj te same materiały i intencję produktu między dostawcami. Oceniaj: * zgodność z promptem; * spójność podmiotu i produktu; * stabilność ruchu; * ciągłość czasową; * wierność referencji; * zgodność obrazu z audio; * dopasowanie kadru i rozdzielczości; * edytowalność pierwszej i ostatniej klatki; * rozkład czasu wykonania; * koszt zaakceptowanego wyniku. Nie porównuj jednego pokazowego klipu. Losowość może nadmiernie poprawić lub pogorszyć ocenę. Powtarzaj próby tam, gdzie produkt realnie je dopuszcza. ## Wdrażaj z odwracalnym planem ruchu Przechodź etapami. 1. Odtwórz niesensytywne prompty offline. 2. Uruchom zadania shadow niewidoczne dla użytkowników. 3. Wyślij mały udział canary do jednej nowej trasy. 4. Porównaj błędy, czas, akceptację i koszt. 5. Zwiększaj udział tylko przy zachowanych progach. 6. Zachowaj adapter Sora, dopóki rollback nie będzie zbędny. Zdecyduj, czy użytkownik widzi nazwę dostawcy. Jeśli modele znacznie się różnią, wybór może być uczciwy. Jeśli produkt sprzedaje funkcję, routuj tylko między modelami spełniającymi ten sam kontrakt. ## Podsumowanie Migruj z Sora do Seedance lub Wan, zachowując neutralne zadanie i wymieniając adapter. Jawnie mapuj możliwości, wybierz jeden prawdziwy endpoint Atlas, zapisuj każdy prediction ID, odrzucaj niewspierane wymagania i porównuj koszt zaakceptowanego wyniku stałym zestawem. Seedance i Wan nie są zamiennikami polegającymi na zmianie nazwy modelu. Stają się bezpieczne, gdy schematy dostawcy są szczegółem implementacji, a migracja pozostaje odwracalna. ## FAQ ### Czy mogę zmienić tylko nazwę modelu Sora i zachować to samo body? Nie. Sora, Seedance i Wan mają różne identyfikatory modeli, endpointy, pola, wartości i wejścia medialne. Zachowaj wewnętrzny schemat zadania i napisz adapter dla każdej trasy. ### Co jest największym wspólnym elementem architektury tych API? Generowanie wideo jest asynchroniczne. Aplikacja wysyła zadanie, zapisuje identyfikator zewnętrzny, później sprawdza status i pobiera wynik dopiero po ukończeniu. ### Które pola trzeba mapować jawnie? Mapuj identyfikator modelu, prompt, media referencyjne, długość, proporcje lub rozmiar, rozdzielczość, audio, seed, zachowanie bezpieczeństwa i status dostawcy. Nie ignoruj po cichu nieobsługiwanych pól. ### Wybrać Seedance czy Wan? Przetestuj oba na prawdziwych zadaniach aplikacji. Seedance dobrze sprawdza się w krótkich materiałach referencyjnych i zadaniach audiowizualnych, a Wan zapewnia wiele tras tekstowych, obrazowych, referencyjnych i edycyjnych. Decyduje jakość zaakceptowanych wyników. ### Jak zapobiec podwójnym płatnym zadaniom podczas migracji? Utwórz wewnętrzny klucz idempotencji, zapisz identyfikator dostawcy od razu po wysłaniu i sprawdzaj istniejące zadanie przed ponowieniem. Niepewność sieci nie powinna uruchamiać ślepego ponownego wysłania. ### Jaką część ruchu przenieść najpierw? Zacznij od offline'owych promptów regresyjnych, potem użyj niewielkiego udziału shadow lub canary. Zwiększaj go tylko, jeśli akceptacja, błędy, czas ukończenia i koszty pozostają w granicach.