Riferimento API
Guide all'integrazione
Prezzi e fatturazione
Controllare un personaggio
Usa CometAPI con l’API Runway Control a character per avviare task di performance del personaggio a partire da un video di riferimento, guidando espressioni facciali e movimento del corpo.
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>"
}Prima di chiamarlo
- Invia l’header
X-Runway-Versionrichiesto, ad esempio2024-11-06 - Usa
model: act_two - Fornisci una risorsa
charactere una risorsareferencecome URL HTTPS accessibili - Inizia con
bodyControl: truee un valore moderato diexpressionIntensityprima di regolare lo stile
Flusso del task
Invia la richiesta di character-performance
Memorizza l'id del task restituito
id restituito, perché ti servirà per il polling successivo.Esegui il polling dello stato del task
Ruoli di input
characterè il soggetto che vuoi animarereferenceè la clip sorgente che fornisce la performance facciale o il movimento del corpobodyControldetermina se il trasferimento del movimento include il movimento del corpo oltre al trasferimento delle espressionicontentModerationapplica le soglie di moderazione del provider alla richiesta
Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Intestazioni
Runway version header, for example 2024-11-06.
Corpo
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
Risposta
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>"
}