Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
Sterowanie postacią
Użyj CometAPI z API Runway Control a character, aby uruchamiać zadania animacji postaci na podstawie filmu referencyjnego, sterując mimiką twarzy i ruchem ciała.
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>"
}Zanim go wywołasz
- Wyślij wymagany nagłówek
X-Runway-Version, na przykład2024-11-06 - Użyj
model: act_two - Podaj jeden zasób
characteri jeden zasóbreferencejako dostępne adresy URL HTTPS - Zacznij od
bodyControl: truei umiarkowanegoexpressionIntensity, zanim zaczniesz dostrajać styl
Przepływ zadania
Prześlij żądanie animacji postaci
Zapisz zwrócone id zadania
id, ponieważ będzie potrzebne do późniejszego odpytywania.Sprawdzaj status zadania
Role wejściowe
characterto obiekt, który chcesz animowaćreferenceto klip źródłowy, który dostarcza mimikę twarzy lub ruch ciałabodyControlokreśla, czy transfer ruchu obejmuje ruch ciała oprócz transferu mimikicontentModerationstosuje progi moderacji dostawcy do żądania
Autoryzacje
Bearer token authentication. Use your CometAPI key.
Nagłówki
Runway version header, for example 2024-11-06.
Treść
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
Odpowiedź
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>"
}