runwayml-image-to-video техникалық сипаттамалары
| Спецификация | Егжей-тегжей |
|---|---|
| Model ID | runwayml-image-to-video |
| Provider | Runway |
| Негізгі мүмкіндік | Мәтіндік промпт пен кескінге тәуелді қозғалыс генерациясын пайдаланып бастапқы кескіннен видео жасайды. |
| API тапсырма түрі | Runway-дың image-to-video endpoint-ы арқылы іске қосылатын асинхронды кескіннен видеоға генерация тапсырмасы. |
| Runway API ішіндегі қолдау көрсетілетін базалық модельдер | Runway-дың image-to-video endpoint-ы бірнеше видео модельдерді қабылдайды, соның ішінде gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast және veo3. |
| Қажетті енгізулер | Кіріс кескін және модельге тән генерация параметрлері; қозғалыс пен көрініс мінез-құлқын сипаттау үшін промпт мәтіні жиі қолданылады. |
| Аутентификация | Authorization тақырыбындағы Bearer API кілті. |
| Нұсқалау тақырыбы | Runway-дың API анықтамасы X-Runway-Version тақырыбын талап етеді, image-to-video endpoint-ы үшін құжатталған мәні 2024-11-06. |
| Шығыс форматы | Тапсырмаға негізделген API өңдеу арқылы қайтарылатын генерацияланған видео активі. |
| Әдеттегі кадр жиілігі | Runway құжаттамасында Gen-3 Alpha image-to-video шығыстары үшін 24 fps көрсетілген. |
| Жиі қолданылатын шығыс ажыратымдылығы | Runway Gen-3 Alpha үшін 1280×768, ал Gen-3 Alpha Turbo үшін бағдарға байланысты 1280×768 және 768×1280 құжаттайды. |
| Кескін кірісі бойынша ұсыныстар | Runway анықтамалық кескіндер үшін 640×640 px-тан кіші немесе 4K-дан үлкен кескіндерді пайдаланудан аулақ болуды ұсынады. |
| CometAPI-да пайдалану үлгісі | CometAPI арқылы платформадағы модель идентификаторы runwayml-image-to-video арқылы қолжетімді. |
runwayml-image-to-video деген не?
runwayml-image-to-video — Runway-дың кескіннен видеоға генерация мүмкіндігіне қол жеткізу үшін CometAPI-де қолданылатын модель идентификаторы. Практикада бұл санаттағы модель бастапқы нүкте ретінде статикалық кескінді алып, оны видеоға түрлендіреді; әдетте қозғалысты, камераның мінез-құлқын, атмосфераны немесе көріністің эволюциясын сипаттайтын промпт мәтінімен басқарылатын болады.
Runway image-to-video мүмкіндігін өзінің кеңірек видео генерация стегінің бөлігі ретінде ұстанымдайды. Gen-3 Alpha құжаттамасында image-to-video — берілген кескінді анимациялаудың тәсілі ретінде сипатталады; промпт көбіне кадрда бұрыннан көрініп тұрғанның бәрін қайта сипаттаудан гөрі қозғалысқа бағытталады.
API тұрғысынан Runway image-to-video генерациясын тапсырма құру endpoint-ы ретінде ұсынады, яғни сұраулар алдымен жұмысты бастайды, содан кейін өңдеу аяқталғаннан кейін соңғы видео нәтижені алу үшін күйді тексеру немесе шығару қадамдарын қажет етеді.
runwayml-image-to-video негізгі мүмкіндіктері
- Кескінге тәуелді видео генерациясы: Статикалық кескіннен бастап, тек мәтіннен видео жасаудан гөрі қозғалысқа негізделген видео шығарады.
- Промпт арқылы қозғалысты басқару: Берілген кадрды үйлесімді анимациялау үшін промпттар қозғалысты, камера қозғалысын және көрініс өзгерістерін сипаттағанда ең жақсы нәтиже береді.
- Асинхронды тапсырма жұмыс ағыны: Ұзаққа созылатын медиа жұмыстарына кезек және мониторинг жасауға ыңғайлы, бастау сұрауынан кейін нәтижені алу арқылы жұмыс істейді.
- Бірнеше базалық модель опциялары: Runway-дың image-to-video API endpoint-ы бірнеше артқы жақтағы видео модельдерді қолдайды, бұл әзірлеушілерге сапа, жылдамдық және құн профилі бойынша икемділік береді.
- Өндірістік стильдегі API аутентификациясы: Басқарылатын интеграциялар үшін стандартты Bearer-токен аутентификациясы және нақты API нұсқа тақырыптары қолданылады.
- Тік және көлденең шығыстарды қолдау: Қолдау көрсетілетін модель отбасыларында горизонталь және вертикаль режимдер үшін шығыс өлшемдері құжатталған.
- Анықтамалық кескіндермен жұмыс үйлесімділігі: API кескін анықтамаларына негізделген және генерация сапасын сақтау үшін Runway кіріс өлшемі бойынша ұсыныстар береді.
- Кеңейтілетін шығармашылық пайплайнға үйлесімділік: Runway платформасы кілткадрлар, кеңейту және басқа режимдер сияқты байланысты видео-генерациялық жұмыс ағындарын қамтиды, ал image-to-video кең шығармашылық пайплайнның бір кезеңі ретінде пайдалы.
runwayml-image-to-video қызметіне қалай қол жеткізу және біріктіру
Қадам 1: API кілтіне тіркеліңіз
Бастау үшін CometAPI қызметіне тіркеліп, тақтадан API кілтіңізді жасаңыз. API кілтін алғаннан кейін оны қауіпсіз сақтаңыз және барлық сұраулар үшін Authorization тақырыбында пайдаланыңыз.
Қадам 2: runwayml-image-to-video API-не сұраулар жіберіңіз
CometAPI арқылы Runway-дың ресми API пішімін пайдаланыңыз. Endpoint: POST /runwayml/v1/image_to_video. 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."
}'
Қадам 3: Нәтижелерді алу және тексеру
API тапсырма идентификаторы бар тапсырма объектісін қайтарады. Генерация күйін тексеру үшін GET /runwayml/v1/tasks/{task_id} арқылы сұрау жіберіңіз, содан кейін аяқталған тапсырма жауапынан шығыс URL мекенжайын алыңыз.