Skip to main content
POST
cURL
Gebruik deze endpoint om performance van een referentieclip over te zetten op een character image of character video.

Voordat je deze aanroept

  • Verstuur de vereiste X-Runway-Version header, bijvoorbeeld 2024-11-06
  • Gebruik model: act_two
  • Geef één character-asset en één reference-asset op als toegankelijke HTTPS-URL’s
  • Begin met bodyControl: true en een gematigde expressionIntensity voordat je de stijl afstemt

Outputverhouding

Taakverloop

1

Verstuur de character-performance-aanvraag

Maak de taak aan met je character-asset, reference-asset en motion-instellingen.
2

Sla de geretourneerde task id op

Bewaar de geretourneerde id, want die heb je later nodig voor polling.
3

Poll de taakstatus

Ga door met Een Runway-taak ophalen totdat de taak een terminale status bereikt en provider-metadata de voltooide output bevat.

Inputrollen

  • character is het onderwerp dat je wilt animeren
  • reference is de bronclip die gezichtsperformance of lichaamsbeweging levert
  • bodyControl bepaalt of motion transfer naast expression transfer ook lichaamsbeweging omvat
  • contentModeration past provider-moderatiedrempels toe op de aanvraag

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

X-Runway-Version
string
vereist

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

Body

application/json
character
object
vereist

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

reference
object
vereist

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

bodyControl
boolean
standaard:true
vereist

Enable body control.

expressionIntensity
integer
standaard:1
vereist

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

seed
integer
standaard:1
vereist

Random seed for reproducible results.

model
string
standaard:act_two
vereist

The model variant to use. Must be act_two.

ratio
string
standaard:1280:720
vereist

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
vereist

Respons

200 - application/json

Task accepted.

id
string
vereist