↓
Docs Rivya AI
Halaman API Model

Integrasi API Kling O3

Gunakan Kling O3 melalui Rivya Public API v1 dengan id model kling-o3, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo
ID model API

kling-o3

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

Tarif kredit: 14–67 / detik keluaran Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Video

Tagihan

METERED

Batas prompt

3072 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

KeyTipeWajibDefaultDeskripsi
modelstringYakling-o3Gunakan kling-o3 sebagai id model API.
promptstringYa-Maksimum 3072 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
resolutionselectTidak720p-720p, 1080p, 4kMode generasi
durationselectTidak5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Durasi
audioselectTidakfalse-false, trueBuat audio
aspect_ratioselectTidak16:9-16:9, 9:16, 1:1Rasio aspek

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Media referensi: Unggah total hingga 2 file gambar untuk proyek gambar-ke-video.

File maksimum

2

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kindUkuran maksimumTipe MIME
image10 MBimage/jpeg, image/png

Request minimal

{
  "model": "kling-o3",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "false",
    "aspect_ratio": "16:9"
  }
}

Request file referensi

{
  "model": "kling-o3",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "false",
    "aspect_ratio": "16:9",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "id": "task_kling_o3_example",
  "status": "queued",
  "model": "kling-o3",
  "reserved_credits": 70,
  "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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.