Referensi API
Panduan Integrasi
Kesalahan
Harga & Penagihan
Mengontrol Karakter
Gunakan CometAPI dengan API Runway Control a character untuk memulai tugas performa karakter dari video referensi, menggerakkan ekspresi wajah dan gerakan tubuh.
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>"
}Sebelum Anda memanggilnya
- Kirim header
X-Runway-Versionyang wajib, misalnya2024-11-06 - Gunakan
model: act_two - Sediakan satu aset
characterdan satu asetreferencesebagai URL HTTPS yang dapat diakses - Mulailah dengan
bodyControl: truedanexpressionIntensityyang moderat sebelum menyesuaikan style
Alur tugas
Kirim permintaan character-performance
Simpan task id yang dikembalikan
id yang dikembalikan, karena Anda akan membutuhkannya untuk polling nanti.Poll status tugas
Peran input
characteradalah subjek yang ingin Anda animasikanreferenceadalah klip sumber yang menyediakan performa wajah atau gerakan tubuhbodyControlmenentukan apakah transfer gerakan mencakup gerakan tubuh selain transfer ekspresicontentModerationmenerapkan ambang moderasi provider pada permintaan
Otorisasi
Bearer token authentication. Use your CometAPI key.
Header
Runway version header, for example 2024-11-06.
Body
The character to control. You can either provide a video or an image.
Show child attributes
Show child attributes
Reference performance clip. Provide type (video) and uri (HTTPS URL).
Show child attributes
Show child attributes
Enable body control.
Intensity of the expression transfer. Higher values produce more exaggerated expressions.
Random seed for reproducible results.
The model variant to use. Must be act_two.
Aspect ratio of the output video, e.g. 1280:720.
Show child attributes
Show child attributes
Respons
Task accepted.
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>"
}