الانتقال إلى المحتوى الرئيسي
POST
/
runwayml
/
v1
/
character_performance
Create a Runway character-performance task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/character_performance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "character": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "reference": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'
{
  "id": "<string>"
}
استخدم نقطة النهاية هذه لنقل الأداء من مقطع مرجعي إلى صورة شخصية أو فيديو شخصية.

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

  • أرسل ترويسة X-Runway-Version المطلوبة، على سبيل المثال 2024-11-06
  • استخدم model: act_two
  • وفّر أصل character واحدًا وأصل reference واحدًا على شكل عناوين URL من نوع HTTPS يمكن الوصول إليها
  • ابدأ باستخدام bodyControl: true وقيمة expressionIntensity متوسطة قبل ضبط النمط

​
تدفق المهمة

1

إرسال طلب أداء الشخصية

أنشئ المهمة باستخدام أصل الشخصية، والأصل المرجعي، وإعدادات الحركة.
2

تخزين معرّف المهمة المُعاد

احتفِظ بالقيمة id المُعادة، لأنك ستحتاج إليها لاحقًا عند الاستطلاع.
3

استطلاع حالة المهمة

تابع باستخدام الحصول على تفاصيل المهمة حتى يصل الغلاف إلى حالة نهائية وتتضمن بيانات المزوّد الوصفية الناتج المكتمل.

​
أدوار الإدخال

  • character هو العنصر الذي تريد تحريكه
  • reference هو المقطع المصدر الذي يوفّر أداء الوجه أو حركة الجسم
  • يحدّد bodyControl ما إذا كان نقل الحركة يتضمن حركة الجسم بالإضافة إلى نقل التعابير
  • يطبّق contentModeration حدود الإشراف الخاصة بالمزوّد على الطلب

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

​
X-Runway-Version
string
مطلوب

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

الجسم

application/json
​
character
object
مطلوب

The character to control. You can either provide a video or an image.

​
reference
object
مطلوب

Reference performance clip. Provide type (video) and uri (HTTPS URL).

​
bodyControl
boolean
افتراضي:true
مطلوب

Enable body control.

​
expressionIntensity
integer
افتراضي:1
مطلوب

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

​
seed
integer
افتراضي:1
مطلوب

Random seed for reproducible results.

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

The model variant to use. Must be act_two.

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

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

​
contentModeration
object
مطلوب

الاستجابة

200 - application/json

Task accepted.

​
id
string
مطلوب