Skip to main content
POST
cURL
Bruk act_two til å overføre opptredenen fra en referansevideo til et karakterbilde eller en video. Forespørselen returnerer en oppgave-id for å hente det ferdige resultatet.

Forbered ressursene

  • Autentiser med CometAPI API-nøkkelen din.
  • Angi model til act_two.
  • Oppgi character.type som image eller video, med ressursen i character.uri. Sørg for at et gjenkjennelig ansikt er synlig og innenfor rammen.
  • Oppgi reference.type som video, med et opptredensklipp på 3 til 30 sekunder i reference.uri.
  • Erstatt eksempel-URL-ene for medier med tilgjengelige HTTPS-URL-er. Mediefeltene godtar også Base64-data-URI-er med en kodet størrelse på opptil 5 MB.

Konfigurer opptredenen

Bare model, character og reference er påkrevd. bodyControl: false behandles som utelatelse, så det eksplisitt ikke deaktiverer kroppskontroll. En seed eller expressionIntensity med verdien 0 behandles også som utelatelse. Utelat valgfrie felt i stedet for å sende null. Valgfrie verdier for ratio er 1280:720, 720:1280, 960:960, 1104:832, 832:1104, eller 1584:672.

Hent resultatet

Lagre den returnerte id og bruk Hent en Runway-oppgave for å hente oppgavestatusen. Når status er SUCCEEDED, leser du resultat-URL-ene fra output. Hvis oppgaven mislykkes, undersøker du failure og failureCode når de finnes.

Autorisasjoner

Authorization
string
header
påkrevd

Your CometAPI API key.

Kropp

application/json

Act-Two character-performance request.

model
enum<string>
påkrevd

Model ID for this request.

Tilgjengelige alternativer:
act_two
character
object
påkrevd

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
påkrevd

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

Nødvendig område: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Nødvendig område: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Tilgjengelige alternativer:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Svar

The task was created. Save its id for task retrieval.

id
string
påkrevd

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Sist endret 18. september 2026