Brug OmniHuman 1.5 via Rivya Public API v1 med model-id omnihuman-1-5, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APIKlarstatusVideo

API-model-id

omnihuman-1-5

Inputs

file

Files API

Krævet for referencetilstande

Basiscredits

per_input_second · default=27 · ⌈total⌉

Funktion

Video

Fakturering

METERED

Promptgrænse

300 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	omnihuman-1-5	Brug API-model-id'et omnihuman-1-5.
prompt	string	Nej	-	Maksimalt 300 tegn for denne model.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
output_resolution	select	Nej	1080	-	720, 1080	Outputopløsning
pe_fast_mode	select	Nej	false	-	false, true	Vælg en kvalitetsprioriteret kørsel, eller prioritér hurtigere behandling med et muligt kvalitetstab.
seed	number	Nej	-1	-	-	Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Portrætbillede og lyd: Upload præcis ét JPEG-, PNG- eller WebP-portræt på højst 10 MB og én MP3-, M4A-, WAV-, AAC- eller OGG-lydfil på højst 10 MB og under 60 sekunder.

Maks. filer

Accepterede filtyper

image, audio

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kind	Maks. størrelse	MIME-typer
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

Minimal anmodning

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

Referencefilanmodning

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

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.

OmniHuman 1.5 API-integration