Gunakan OmniHuman 1.5 melalui Rivya Public API v1 dengan id model omnihuman-1-5, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIKesiapanVideo

ID model API

omnihuman-1-5

Input

file

Files API

Diperlukan untuk mode referensi

Kredit dasar

per_input_second · default=27 · ⌈total⌉

Kapabilitas

Video

Tagihan

METERED

Batas prompt

300 karakter

Kontrak request

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

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	omnihuman-1-5	Gunakan omnihuman-1-5 sebagai id model API.
prompt	string	Tidak	-	Maksimum 300 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
output_resolution	select	Tidak	1080	-	720, 1080	Resolusi output
pe_fast_mode	select	Tidak	false	-	false, true	Pilih proses kualitas-utama atau prioritaskan pemrosesan cepat dengan kemungkinan kompromi kualitas.
seed	number	Tidak	-1	-	-	Biarkan kosong untuk hasil acak baru setiap kali. Menggunakan ulang integer yang sama membuat hasil sebelumnya lebih mudah direproduksi atau disempurnakan. Hasil hanya akan lebih dekat bila prompt dan pengaturan kunci lain juga tetap mirip, dan ini bukan jaminan kecocokan 1:1.

Kebijakan unggahan

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

Aturan referensi

Gambar potret dan audio: Unggah tepat satu potret JPEG, PNG, atau WebP hingga 10 MB dan satu berkas audio MP3, M4A, WAV, AAC, atau OGG hingga 10 MB dan kurang dari 60 detik.

File maksimum

Jenis file yang diterima

image, audio

Duration token

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

kind	Ukuran maksimum	Tipe MIME
image	10 MB	image/jpeg, image/png, image/webp
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Request minimal

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1
  }
}

Request file referensi

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      },
      {
        "url": "https://cdn.example.com/reference-audio.wav",
        "kind": "audio",
        "name": "reference-audio.wav",
        "mimeType": "audio/wav",
        "durationSeconds": 12,
        "durationToken": "audio_duration_token_from_files_api"
      }
    ]
  }
}

Response create

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

{
  "id": "task_omnihuman_1_5_example",
  "status": "queued",
  "model": "omnihuman-1-5",
  "reserved_credits": 27,
  "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.

Integrasi API OmniHuman 1.5