Dokumentasi Rivya AI
Halaman API model

Integrasi API Kling 2.6 motion-control

Gunakan Kling 2.6 motion-control melalui Rivya Public API v1 dengan ID model kling-2-6-motion-control, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanVideo
ID model API

kling-2-6-motion-control

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

per_output_second · 720p=11 · 1080p=18 · ⌈total⌉

Keupayaan

Video

Bil

METERED

Had prompt

2500 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

KunciJenisWajibLalaiPenerangan
modelstringYakling-2-6-motion-controlGunakan ID model API kling-2-6-motion-control.
promptstringYa-Maksimum 2500 aksara untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_idstringTidak-ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

KunciJenisWajibLalaiJulatPilihanPenerangan
modeselectTidak720p-720p, 1080pResolusi output
character_orientationselectTidakvideo-video, imageMengawal sama ada orientasi watak patut kekal lebih dekat kepada video gerakan atau imej rujukan.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej rujukan + video gerakan: Muat naik tepat 1 imej watak dan 1 klip gerakan. Kedua-duanya patut menunjukkan kepala, bahu dan torso dengan jelas.

Fail maksimum

2

Jenis fail diterima

image, video

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kindSaiz maksimumJenis MIME
image10 MBimage/jpeg, image/png
video95 MBvideo/mp4, video/quicktime

Permintaan minimum

{
  "model": "kling-2-6-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video"
  }
}

Permintaan fail rujukan

{
  "model": "kling-2-6-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_kling_2_6_motion_control_example",
  "status": "queued",
  "model": "kling-2-6-motion-control",
  "reserved_credits": 11,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.