Specyfikacje techniczne runwayml-image-to-video
| Specyfikacja | Szczegóły |
|---|---|
| Identyfikator modelu | runwayml-image-to-video |
| Dostawca | Runway |
| Podstawowa funkcjonalność | Generuje wideo z obrazu początkowego, korzystając z promptu tekstowego i generowania ruchu warunkowanego obrazem. |
| Typ zadania API | Asynchroniczne zadanie generowania obrazu na wideo uruchamiane przez punkt końcowy image‑to‑video Runway. |
| Obsługiwane modele bazowe w Runway API | Punkt końcowy image‑to‑video Runway akceptuje wiele modeli wideo, w tym gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast i veo3. |
| Wymagane dane wejściowe | Obraz wejściowy plus parametry generowania specyficzne dla modelu; tekst promptu jest powszechnie używany do opisu pożądanego ruchu i zachowania sceny. |
| Uwierzytelnianie | Klucz API typu Bearer w nagłówku Authorization. |
| Nagłówek wersjonowania | Dokumentacja API Runway wymaga nagłówka X-Runway-Version o wartości 2024-11-06 dla punktu końcowego image‑to‑video. |
| Format wyjściowy | Wygenerowany zasób wideo zwracany poprzez przetwarzanie zadaniowe API. |
| Typowa liczba klatek na sekundę | Dokumentacja Runway podaje 24 fps dla wyjść image‑to‑video Gen‑3 Alpha. |
| Typowa rozdzielczość wyjściowa | Runway dokumentuje 1280×768 dla Gen‑3 Alpha oraz 1280×768 i 768×1280 dla Gen‑3 Alpha Turbo, w zależności od orientacji. |
| Wytyczne dotyczące obrazu wejściowego | Runway zaleca unikanie obrazów referencyjnych mniejszych niż 640×640 px lub większych niż 4K dla obrazów wejściowych. |
| Sposób użycia w CometAPI | Dostęp przez CometAPI z użyciem identyfikatora modelu platformy runwayml-image-to-video. |
Czym jest runwayml-image-to-video?
runwayml-image-to-video to identyfikator modelu CometAPI służący do korzystania z możliwości generowania obrazu na wideo w Runway. W praktyce ta kategoria modeli bierze nieruchomy obraz jako punkt wyjścia i przekształca go w wygenerowane wideo, zwykle prowadzone przez tekst promptu opisujący ruch, zachowanie kamery, atmosferę lub ewolucję sceny.
Runway postrzega image‑to‑video jako część swojego szerszego stosu generowania wideo. W dokumentacji dla Gen‑3 Alpha image‑to‑video jest opisywane jako sposób animowania dostarczonego obrazu, przy czym prompty koncentrują się zwłaszcza na ruchu, zamiast ponownie opisywać wszystko, co już widać w kadrze.
Z perspektywy API Runway udostępnia generowanie image‑to‑video jako punkt końcowy tworzenia zadań, co oznacza, że żądania zwykle najpierw uruchamiają zadanie, a następnie wymagają odpytywania lub kroków pobierania, aby uzyskać końcowy wynik wideo po zakończeniu przetwarzania.
Najważniejsze funkcje runwayml-image-to-video
- Generowanie wideo uwarunkowane obrazem: Rozpoczyna od nieruchomego obrazu i generuje wideo napędzane ruchem, zamiast tworzyć wideo wyłącznie z tekstu.
- Sterowanie ruchem na podstawie promptu: Działa najlepiej, gdy prompty opisują ruch, ruch kamery i zmiany sceny, aby spójnie animować dostarczoną klatkę.
- Asynchroniczny przepływ pracy z zadaniami: Używa żądania rozpoczęcia generowania, po którym następuje pobranie rezultatów, co pasuje do systemów produkcyjnych, które kolejkują i monitorują długotrwałe zadania multimedialne.
- Wiele opcji modeli bazowych: Punkt końcowy image‑to‑video Runway obsługuje kilka modeli wideo backend, zapewniając programistom elastyczność w zakresie jakości, szybkości i kosztów.
- Uwierzytelnianie API klasy produkcyjnej: Używa standardowej autoryzacji tokenem Bearer oraz jawnych nagłówków wersji dla kontrolowanych integracji.
- Obsługa wyjść pionowych i poziomych: Runway dokumentuje rozmiary wyjściowe dla trybów poziomych i pionowych w obsługiwanych rodzinach modeli.
- Zgodność z przepływem pracy z obrazem referencyjnym: API jest zaprojektowane wokół obrazów referencyjnych, a Runway dostarcza rekomendacje dotyczące rozmiaru wejścia, aby utrzymać jakość generowania.
- Dopasowanie do rozszerzalnego potoku kreatywnego: Szersza platforma Runway obejmuje powiązane przepływy generowania wideo, takie jak klatki kluczowe, rozszerzanie i inne tryby generowania, dzięki czemu image‑to‑video jest użyteczne jako etap w większym potoku twórczym.
Jak uzyskać dostęp i zintegrować runwayml-image-to-video
Krok 1: Zarejestruj się, aby uzyskać klucz API
Aby rozpocząć, zarejestruj się w CometAPI i wygeneruj klucz API w panelu. Po uzyskaniu klucza API przechowuj go bezpiecznie i używaj go w nagłówku Authorization dla wszystkich żądań.
Krok 2: Wyślij żądania do API runwayml-image-to-video
Użyj oficjalnego formatu API Runway przez CometAPI. Punkt końcowy to POST /runwayml/v1/image_to_video. Dołącz nagłówek X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Krok 3: Pobierz i zweryfikuj wyniki
API zwraca obiekt zadania z identyfikatorem zadania. Odpytuj GET /runwayml/v1/tasks/{task_id}, aby sprawdzić status generowania, a następnie pobierz adres URL wyniku z odpowiedzi zakończonego zadania.