Specyfikacje techniczne runway-video
| Specyfikacja | Szczegóły |
|---|---|
| ID modelu | runway-video |
| Dostawca | Runway |
| Typ modelu | Generowanie wideo przez AI |
| Główne modalności | Tekst-na-wideo i obraz-na-wideo, w zależności od wybranego bazowego modelu Runway |
| Dane wejściowe | Polecenia tekstowe, obrazy referencyjne oraz w niektórych przypadkach przesłane zasoby multimedialne |
| Wyniki | Generowane klipy wideo |
| Wzorzec API | Asynchroniczny, oparty na zadaniach proces generowania |
| Uwierzytelnianie | Uwierzytelnianie za pomocą klucza API typu Bearer |
| Wymagany nagłówek wersji | X-Runway-Version: 2024-11-06 |
| Bazowy host API | api.dev.runwayml.com |
| Oficjalne SDK | Dostępne są SDK dla Node.js i Pythona |
| Obsługa plików | Obsługuje tymczasowe przesyłanie, które zwraca wartości runwayUri do wykorzystania w żądaniach generowania |
| Model cenowy | Rozliczanie oparte na kredytach; dostępne modele wideo Runway są rozliczane za sekundę wygenerowanego materiału |
| Przykładowe bazowe modele wideo | gen4.5, gen4_turbo, gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo |
Czym jest runway-video?
runway-video to identyfikator platformy CometAPI służący do uzyskiwania dostępu do możliwości generowania wideo Runway za pośrednictwem ujednoliconego API. Na podstawie oficjalnej dokumentacji API Runway, Runway oferuje wiele modeli wideo do generowania klipów na podstawie poleceń tekstowych lub obrazów, z punktami końcowymi opartymi na zadaniach do uruchamiania generacji i późniejszego pobierania wyników.
W praktyce runway-video najlepiej rozumieć jako bramę do przepływów pracy tworzenia wideo zasilanych przez Runway, a nie pojedynczą nazwę samodzielnego modelu bazowego. Aktualny katalog API Runway obejmuje kilka modeli wideo o różnych trybach wejściowych i poziomach cen, takich jak gen4.5 (tekst-lub-obraz-do-wideo), gen4_turbo (obraz-do-wideo) oraz dodatkowe opcje, m.in. gen4_aleph, veo3, veo3.1, veo3.1_fast i gen3a_turbo.
Dzięki temu runway-video nadaje się do zastosowań takich jak kreatywny prototyping, generowanie treści marketingowych, produkcja klipów do mediów społecznościowych, wizualizacja koncepcji oraz doświadczenia produktowe wymagające automatycznej syntezy krótkich form wideo. Ponieważ bazowe API Runway korzysta z asynchronicznych zadań, integracje zazwyczaj najpierw wysyłają żądanie generowania, a następnie odpytywają lub pobierają wynik zadania po zakończeniu przetwarzania.
Najważniejsze funkcje runway-video
- Generowanie wideo z tekstu: Runway obsługuje tworzenie wideo na podstawie poleceń w języku naturalnym w obsługiwanych modelach, co umożliwia generowanie klipów bezpośrednio z opisu tekstowego.
- Przepływy pracy obraz-do-wideo: Kilka modeli wideo Runway przyjmuje dane wejściowe w postaci obrazów, dzięki czemu
runway-videonadaje się do animowania statycznych obrazów lub budowania przepływów generowania wideo opartych na referencjach. - Wiele opcji bazowych modeli: API Runway udostępnia kilka modeli wideo o różnych możliwościach i kosztach, co daje elastyczność w optymalizacji pod kątem jakości, szybkości lub budżetu.
- Asynchroniczne przetwarzanie zadań: Żądania generowania tworzą zadania zamiast natychmiast zwracać finalne media, co dobrze sprawdza się w systemach produkcyjnych wymagających kolejkowania, ponowień prób i sprawdzania statusu.
- Tymczasowe przesyłanie zasobów: Runway udostępnia punkty końcowe do przesyłania, które zwracają referencje
runwayUri, ułatwiając przekazywanie obrazów, wideo lub audio do późniejszych żądań generowania. - Oficjalne wsparcie dla SDK: Runway oferuje SDK dla Node.js i Pythona, co upraszcza uwierzytelnianie, budowanie żądań i pobieranie wyników.
- Wersjonowana integracja API: Żądania wymagają jawnego nagłówka
X-Runway-Version, co pomaga programistom budować integracje w oparciu o znany kontrakt API. - Cennik oparty na kredytach: Runway rozlicza generowanie wideo w kredytach za sekundę, a cena zależy od wybranego bazowego modelu.
Jak uzyskać dostęp i zintegrować runway-video
Krok 1: Zarejestruj się po klucz API
Aby uzyskać dostęp do runway-video, utwórz konto i wygeneruj klucz API w panelu CometAPI. Po zalogowaniu skopiuj klucz API i przechowuj go bezpiecznie w zmiennej środowiskowej lub menedżerze sekretów na potrzeby środowisk produkcyjnych.
Krok 2: Wyślij żądania do API runway-video
Użyj klucza API do uwierzytelniania żądań kierowanych do punktu końcowego CometAPI dla runway-video. Przekaż polecenie i wszelkie obsługiwane parametry wejściowe w treści żądania, a jako model wskaż runway-video.
curl -X POST "https://api.cometapi.com/v1/responses" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "runway-video",
"input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
}'
Krok 3: Pobierz i zweryfikuj wyniki
Po wysłaniu przeanalizuj odpowiedź API pod kątem wygenerowanego wyniku, identyfikatora zadania lub zwróconego ładunku wynikowego dla runway-video. Jeśli generowanie przebiega asynchronicznie, odpytywaj odpowiedni punkt końcowy CometAPI do momentu zakończenia przetwarzania, a następnie zweryfikuj zwrócony adres URL wideo, metadane i zawartość przed użyciem w aplikacji.