Gebruik OmniHuman 1.5 via Rivya Public API v1 met model-id omnihuman-1-5, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APIGereedheidVideo

API-model-id

omnihuman-1-5

Inputs

file

Files API

Vereist voor referentiemodi

Basiscredits

per_input_second · default=27 · ⌈total⌉

Mogelijkheid

Video

Facturering

METERED

Promptlimiet

300 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	omnihuman-1-5	Gebruik de API-model-id omnihuman-1-5.
prompt	string	Nee	-	Maximaal 300 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
output_resolution	select	Nee	1080	-	720, 1080	Uitvoerresolutie
pe_fast_mode	select	Nee	false	-	false, true	Kies een kwaliteit-eerst-run of geef prioriteit aan snellere verwerking met een mogelijke kwaliteitsafweging.
seed	number	Nee	-1	-	-	Laat dit leeg voor elke keer een nieuw willekeurig resultaat. Door hetzelfde gehele getal opnieuw te gebruiken, wordt het makkelijker om een eerder resultaat te reproduceren of fijn af te stemmen. Het blijft alleen dichterbij wanneer de prompt en andere belangrijke instellingen ook vergelijkbaar blijven, en het is geen gegarandeerde 1-op-1 match.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Portretbeeld en audio: Upload precies één JPEG-, PNG- of WebP-portret van maximaal 10 MB en één MP3-, M4A-, WAV-, AAC- of OGG-audiobestand van maximaal 10 MB en korter dan 60 seconden.

Max. bestanden

Geaccepteerde bestandstypen

image, audio

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
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

Minimale request

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

Request met referentiebestand

{
  "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"
      }
    ]
  }
}

Create-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

{
  "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
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

OmniHuman 1.5 API-integratie