Skip to main content
POST
cURL
Gunakan endpoint ini untuk mentransfer performa dari klip referensi ke gambar karakter atau video karakter.

Sebelum memanggilnya

  • Kirim header X-Runway-Version yang wajib, misalnya 2024-11-06
  • Gunakan model: act_two
  • Sediakan satu aset character dan satu aset reference sebagai URL HTTPS yang dapat diakses
  • Mulai dengan bodyControl: true dan expressionIntensity sedang sebelum menyesuaikan gaya

Rasio output

Alur tugas

1

Kirim permintaan character-performance

Buat tugas dengan aset karakter, aset referensi, dan pengaturan gerakan Anda.
2

Simpan task id yang dikembalikan

Simpan id yang dikembalikan, karena Anda membutuhkannya untuk polling nanti.
3

Poll status tugas

Lanjutkan dengan Dapatkan tugas Runway sampai tugas mencapai status terminal dan metadata provider menyertakan output akhir.

Peran input

  • character adalah subjek yang ingin Anda animasikan
  • reference adalah klip sumber yang menyediakan performa wajah atau gerakan tubuh
  • bodyControl menentukan apakah transfer gerakan mencakup pergerakan tubuh selain transfer ekspresi
  • contentModeration menerapkan ambang moderasi provider pada permintaan

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version
string
wajib

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

Body

application/json
character
object
wajib

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

reference
object
wajib

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

bodyControl
boolean
default:true
wajib

Enable body control.

expressionIntensity
integer
default:1
wajib

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

seed
integer
default:1
wajib

Random seed for reproducible results.

model
string
default:act_two
wajib

The model variant to use. Must be act_two.

ratio
string
default:1280:720
wajib

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
wajib

Respons

200 - application/json

Task accepted.

id
string
wajib