الانتقال إلى المحتوى الرئيسي
POST
/
runway
/
pro
/
generate
Create a reverse-format Runway generate task
curl --request POST \
  --url https://api.cometapi.com/runway/pro/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "http://baidu.com",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "model": "gen4",
  "prompt": "Smile, Eat Burger"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
استخدم نقطة النهاية هذه عندما تريد مسار generate بالتنسيق العكسي من Runway مع صورة مرجعية واحدة أو أكثر.

​
قبل استدعائها

  • أرسل ترويسة X-Runway-Version المطلوبة، على سبيل المثال 2024-11-06
  • استخدم model: gen4
  • وفّر image المصدر وPrompt الذي يصف الحركة أو التحويل
  • اجعل الطلب الأول بسيطًا قبل إضافة ضبط النمط ومتجهات الحركة بشكل تدريجي

​
سير عمل المهمة

1

إنشاء المهمة بالتنسيق العكسي

أرسل Prompt والصورة والنسبة والخيارات، ثم احفظ معرّف المهمة المُعاد.
2

الاستعلام عن المهمة

تابع باستخدام Feed Get Task. إذا أعادت أول عملية استعلام task_not_exist، فانتظر بضع ثوانٍ ثم أعد المحاولة.
3

الاحتفاظ بالنتيجة

عند اكتمال المهمة، خزّن الأصل النهائي في مسار الوسائط الخاص بك إذا كنت بحاجة إلى احتفاظ طويل الأمد.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

​
X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

الجسم

application/json
​
callback_url
string
افتراضي:https://example.com/webhook
مطلوب

Webhook URL that receives a POST request with the result when the task completes.

​
ratio
string
افتراضي:1280:720
مطلوب

Aspect ratio of the generated video, e.g. 1280:720.

​
prompt
string
افتراضي:A paper boat gently rocks on calm water.
مطلوب

Text prompt describing the desired video content or motion.

​
model
string
افتراضي:gen4
مطلوب

Model version to use, e.g. gen4.

​
image
string
افتراضي:https://db.xiaohuhd.com/1.jpeg
مطلوب

URL of the source image to animate.

​
style
string

Artistic style for the generated video, e.g. cinematic.

​
options
object

Advanced generation options.

​
last_image
string

URL of the end-frame image. When provided, the video transitions toward this frame.

الاستجابة

200 - application/json

OK

​
code
integer
مطلوب

HTTP status code or business status code, 200 usually indicates success

​
msg
string
مطلوب

Text description of the status code

​
data
object
مطلوب

Specific response data content

​
exec_time
number
مطلوب

Time spent processing this request