OmniHuman 1.5 کو Rivya Public API v1 کے ذریعے model id omnihuman-1-5، supported inputs، parameters، Files API rules، credits اور response examples کے ساتھ استعمال کریں۔

API کے ذریعے availableReadinessویڈیو

API model id

omnihuman-1-5

Inputs

file

Files API

Reference modes کے لیے required

Base credits

per_input_second · default=27 · ⌈total⌉

Capability

ویڈیو

Billing

METERED

Prompt limit

300 characters

Request contract

model id کو top level پر بھیجیں۔ Model-specific controls params میں رہتے ہیں۔

Key	Type	Required	Default	Description
model	string	Yes	omnihuman-1-5	omnihuman-1-5 API model id استعمال کریں۔
prompt	string	No	-	اس model کے لیے زیادہ سے زیادہ 300 characters۔
params	object	No	-	Model-specific parameter object۔ allowed keys کے لیے نیچے والی rows استعمال کریں۔
client_request_id	string	No	-	آپ کے system میں requests trace کرنے کے لیے optional client-side id۔

Model parameters

Key	Type	Required	Default	Range	Options	Description
output_resolution	select	No	1080	-	720, 1080	آؤٹ پٹ ریزولیوشن
pe_fast_mode	select	No	false	-	false, true	معیار کو ترجیح دینے والی جنریشن منتخب کریں، یا ممکنہ معیار کی کمی کے ساتھ تیز تر پروسیسنگ کو ترجیح دیں۔
seed	number	No	-1	-	-	ہر بار نیا بے ترتیب نتیجہ چاہیے ہو تو اسے خالی چھوڑیں۔ اسی عدد صحیح کو دوبارہ استعمال کرنے سے پچھلا نتیجہ دوبارہ بنانا یا باریک بہتر کرنا آسان ہوتا ہے۔ نتیجہ صرف اسی وقت زیادہ قریب رہتا ہے جب پرامپٹ اور دیگر اہم ترتیبات بھی ملتی جلتی رہیں، اور یہ 1:1 مماثلت کی ضمانت نہیں۔

Upload policy

Reference files پہلے upload کریں، پھر returned URL اور duration token کو params.referenceMediaItems کے اندر رکھیں۔

Reference rule

پورٹریٹ تصویر اور آڈیو: 10 MB تک کا بالکل ایک JPEG، PNG یا WebP پورٹریٹ اور 10 MB تک اور 60 سیکنڈ سے کم کی ایک MP3، M4A، WAV، AAC یا OGG آڈیو فائل اپ لوڈ کریں۔

Max files

Accepted file kinds

image, audio

Duration token

duration verification required ہو تو video اور audio references کو /api/v1/files سے durationToken ساتھ رکھنا چاہیے۔

kind	Max size	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

Minimal request

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

Reference-file request

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

create endpoint ایک public task id واپس کرتا ہے۔ task succeeded یا failed ہونے تک status endpoint poll کریں۔

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

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

کچھ modes کو Files API reference uploads درکار ہوتے ہیں۔

OmniHuman 1.5 API Integration