مرجع API
أدلة التكامل
الأخطاء
الأسعار والفوترة
التنسيق الرسمي
إنشاء فيديو من فيديو
استخدم CometAPI Runway POST /runwayml/v1/video_to_video لبدء مهام إنشاء فيديو من فيديو، وتعيين X-Runway-Version، وتحويل المقاطع المصدر.
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/video_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
"promptText": "string",
"seed": 4294967295,
"model": "gen4_aleph",
"references": [
{
"type": "image",
"uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
}
],
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{}استخدم نقطة النهاية هذه لتحويل مقطع مصدر موجود باستخدام سير عمل الفيديو إلى فيديو من Runway. تبدأ هذه العملية مهمة غير متزامنة بدلًا من إرجاع الناتج النهائي فورًا.
قبل استدعائها
- جهّز فيديو مصدرًا يطابق متطلبات الإدخال الخاصة بالمزوّد
- أدرج ترويسة
X-Runway-Versionالمطلوبة لمجموعة الميزات التي تريدها - ابدأ بـ Prompt قصير واحد يصف التغيير، وليس لوحة قصص كاملة
تدفق المهمة
الاستعلام عن تفاصيل المهمة
استخدم Runway to Get Task Details حتى تصل المهمة إلى حالة نهائية.
ملاحظة حول غلاف CometAPI
يحافظ CometAPI على نموذج المهام غير المتزامنة وسلوك الطلبات المعتمد على الإصدارات في Runway، لكنه يوحّد المصادقة ومعالجة base URL مع بقية المنصة.التفويضات
Bearer token authentication. Use your CometAPI key.
الترويسات
Runway API version header, for example 2024-11-06.
الجسم
application/json
HTTPS URL of the source video, or a base64 data URI containing the video.
Text prompt describing the desired output. Maximum 1000 characters.
Random seed for reproducible results. Range: 0–4294967295.
Model variant to use.
Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).
Show child attributes
Show child attributes
Aspect ratio of the output video, e.g. 1280:720.
Show child attributes
Show child attributes
الاستجابة
200 - application/json
success
The response is of type object.
⌘I
Generate a video from a video
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/video_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
"promptText": "string",
"seed": 4294967295,
"model": "gen4_aleph",
"references": [
{
"type": "image",
"uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
}
],
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{}