مرجع API
أدلة التكامل
الأخطاء
الأسعار والفوترة
التنسيق الرسمي
تحويل الصورة إلى فيديو
استخدم CometAPI لاستدعاء Runway image_to_video وتحويل رابط صورة ثابتة إلى مخرجات فيديو خام، مع دعم X-Runway-Version للتوافق.
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}استخدم نقطة النهاية هذه لتحريك صورة مصدر واحدة وتحويلها إلى فيديو من Runway.
قبل استدعائها
- أرسل ترويسة
X-Runway-Versionالمطلوبة، على سبيل المثال2024-11-06 - استخدم
model: gen3a_turbo - وفّر
promptImageثابتًا عبر HTTPS - ابدأ بالقيمة
duration: 5ونسبة شائعة مثل1280:720
سير العمل
الاستعلام عن حالة المهمة
استخدم الحصول على تفاصيل المهمة. إذا أعاد أول استعلام
task_not_exist، فانتظر بضع ثوانٍ ثم أعد المحاولة.أكد التحقق المباشر بتاريخ 2026-03-13 أنه تم قبول طلب
gen3a_turbo بالحد الأدنى وأعاد id. وبعد تأخير قصير، أعادت كل من تفاصيل المهمة الرسمية وfeed العكسي حالة انتظار مغلّفة نفسها لتلك المهمة.التفويضات
Bearer token authentication. Use your CometAPI key.
الترويسات
Runway version header, for example 2024-11-06.
الجسم
application/json
promptImage
string
افتراضي:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
مطلوب
Source image URL.
Runway image-to-video model ID. Choose a current model from the Models page.
Random seed for reproducible results. Range: 0–999999999.
Text prompt describing the desired motion or scene. Maximum 512 characters.
Whether to add a watermark to the output video.
Video duration in seconds. Accepted values: 5 or 10.
Aspect ratio of the output video.
الخيارات المتاحة:
1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280 الاستجابة
200 - application/json
Task accepted.
⌘I
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}