Rivya API model IDs، availability، supported modes، parameter tables، prompt limits، reference media rules، اور model detail links دیکھیں۔

یہ page Rivya API v1 کے لیے model-level API reference ہے۔

نیچے دی گئی table اسی model catalog اور public serializer سے generate ہوتی ہے جو /api/v1/models استعمال کرتا ہے۔ یہ ہاتھ سے لکھی ہوئی fixed model count نہیں ہے۔

اس reference کو کیسے پڑھیں

Asynchronous image، video، اور audio models کے لیے POST /api/v1/generations میں model id کو model کے طور پر استعمال کریں۔
Chat model IDs کو POST /api/v1/chat/completions میں استعمال کریں۔
Generation prompt text کے لیے top-level prompt استعمال کریں۔
Chat API turns کے لیے top-level message استعمال کریں۔
Asynchronous model-specific fields کو params کے اندر رکھیں۔
Integration build کرنے سے پہلے api_input_status پڑھیں۔ available_text اور available_url_input کو file upload کے بغیر test کیا جا سکتا ہے؛ partial_requires_files کا مطلب ہے کہ صرف کچھ modes کو Files API چاہیے؛ requires_files_api کا مطلب ہے کہ model call کرنے سے پہلے reference media کو Files API کے ذریعے upload کریں۔
Chat models کے لیے non-streaming support، SSE streaming support، image file_id attachments، web search، thoughts، اور reasoning effort کے لیے chat_capabilities پڑھیں۔
Model detail pages product-level guidance اور examples دیتے ہیں۔

اس reference کو debugger کے ساتھ استعمال کریں

quickstart سے شروع کریں، یہاں model fields confirm کریں، پھر Developers debugger میں mock یا signed-in live request چلائیں۔

API Quickstart Online debugger

Z-Image

z-imageAPI کے ذریعے availableText input ready

تصویر · Alibaba کا lightweight text-to-image model۔ 5 aspect ratios کے ساتھ fast single-image generation، جو صرف 1 credit میں quick concept drafts اور social media visuals کے لیے ideal ہے۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

1000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2API کے ذریعے availablePartial: Files API needed

تصویر · Google کا next-gen image model، 4K resolution، 15 aspect ratios (extreme 8:1 سمیت)، Google Search grounding، اور 14 reference images تک کے ساتھ — Rivya پر سب سے flexible image generator۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

20000 characters

Reference media

image · 14 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

Reference rule

Reference image: Image projects کے لئے 14 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	No	1K	-	1K, 2K, 4K
output_format	select	No	jpg	-	jpg, png
google_search	select	No	false	-	false, true

Nano Banana Pro

nano-banana-proAPI کے ذریعے availablePartial: Files API needed

تصویر · Google کا premium image model، 4K output، 11 aspect ratios، اور 8 reference images تک کے ساتھ۔ Superior detail اور color accuracy کے ساتھ high-fidelity brand اور campaign visuals کے لئے optimized ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

10000 characters

Reference media

image · 8 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Reference rule

Reference image: Image projects کے لئے 8 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	No	1K	-	1K, 2K, 4K
output_format	select	No	png	-	png, jpg

Nano Banana

nano-bananaAPI کے ذریعے availablePartial: Files API needed

تصویر · Google کا flexible image model text-to-image اور image-to-image کے لئے، 11 aspect ratios، 10 reference images تک، اور PNG/JPEG output کے ساتھ۔ Portraits، product compositions، اور wider landing-page visuals کے لئے strong fit۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 10 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

Reference rule

Reference image: Image projects کے لئے 10 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
imageSize	select	No	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	No	png	-	png, jpeg

GPT Image 2

gpt-image-2API کے ذریعے availablePartial: Files API needed

تصویر · Rivya پر OpenAI کا نیا GPT Image model، جس میں text-to-image، image-to-image، 16 reference images تک support، اور واضح 1K / 2K / 4K credit tiers شامل ہیں۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

20000 characters

Reference media

image · 16 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

Reference rule

Reference images: GPT Image 2 image-to-image tasks کے لئے 16 image references تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	No	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5API کے ذریعے availablePartial: Files API needed

تصویر · OpenAI کا image model جس میں medium/high quality tiers اور 16 reference images تک support ہے۔ یہ complex instructions پر عمل کرنے اور accurate spatial relationships کے ساتھ coherent scenes render کرنے میں بہترین ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

Reference media

image · 16 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

Reference rule

Reference image: Image projects کے لئے 16 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
quality	select	No	medium	-	medium, high
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageAPI کے ذریعے availableText input ready

Image · OpenAI کا 4o Image model اب Rivya پر dedicated text-to-image path کے طور پر دستیاب ہے۔ فی الحال page setup کو جان بوجھ کر narrow رکھا گیا ہے: prompt، 3 supported aspect ratios، اور ہر image کے لیے fixed 3 credits۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
size	select	No	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteAPI کے ذریعے availablePartial: Files API needed

تصویر · ByteDance کا lighter Seedream image model، text-to-image اور image editing دونوں کے لیے shared pricing کے ساتھ۔ یہ 8 aspect ratios، 14 reference images تک، اور فی الحال ہر run پر 6 credits کو support کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

3000 characters

Reference media

image · 14 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Reference rule

ریفرنس تصویر: Image projects کے لیے 14 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	No	basic	-	basic, high

Seedream 4.5

seedream-4-5API کے ذریعے availablePartial: Files API needed

تصویر · ByteDance کا high-end image model، 2K/4K quality tiers، 8 aspect ratios، اور 14 reference images تک کے ساتھ۔ Fashion اور lifestyle visuals میں cinematic color grading اور rich texture detail کے لیے معروف۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

3000 characters

Reference media

image · 14 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Reference rule

ریفرنس تصویر: Image projects کے لیے 14 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	No	basic	-	basic, high

Seedream 4.0

seedream-4-0API کے ذریعے availablePartial: Files API needed

تصویر · Seedream 4.0 Rivya پر ByteDance کا balanced image model ہے، text-to-image generation، reference-image editing، اور explicit output controls کے لیے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 10 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Reference rule

ریفرنس تصاویر: Seedream 4.0 edit path کے لیے 10 images تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	No	1K	-	1K, 2K, 4K
max_images	number	No	1	min 1 / max 6 / step 1	-
seed	number	No	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	No	false	-	false, true

Seedream 3.0

seedream-3-0API کے ذریعے availableText input ready

تصویر · Seedream 3.0 اب Rivya پر standalone legacy image model کے طور پر واپس ہے۔ فی الحال یہ صرف public text-to-image path رکھتا ہے اور ہر run پر 5 credits خرچ کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	No	2.5	min 1 / max 10 / step 0.1	-
seed	number	No	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineAPI کے ذریعے availablePartial: Files API needed

تصویر · xAI کا image model، جس میں strong creative interpretation اور 5 aspect ratios شامل ہیں۔ Single-image generation artistic expression اور unconventional visual styles پر focused ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	No	false	-	false, true

Flux 2 Pro

flux-2-proAPI کے ذریعے availablePartial: Files API needed

Image · Black Forest Labs کا 32B-parameter flagship۔ Text-to-image اور image-to-image support کرتا ہے، 8 reference images تک، 2K resolution، اور accurate text rendering کے ساتھ - product shots اور brand visuals کے لیے built۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 8 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Reference rule

حوالہ تصویر: تصویری projects کے لیے 8 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	No	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexAPI کے ذریعے availablePartial: Files API needed

Image · Flux 2 family کا editing-focused variant۔ Structural adjustments اور style transfer میں specialize کرتا ہے، 8 reference images تک اور 2K resolution کے ساتھ - existing visuals پر iteration کے لیے ideal۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 8 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Reference rule

حوالہ تصویر: تصویری projects کے لیے 8 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	No	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxAPI کے ذریعے availablePartial: Files API needed

Image · Black Forest Labs کا enhanced Flux Kontext model، زیادہ demanding prompt-led generation اور image editing tasks کے لیے۔ Rivya فی الحال text-to-image اور image-to-image دونوں کو same async project پر رکھتا ہے، اور platform کی current policy کے تحت انہیں fixed 8 credits per run پر price کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "اختیاری واٹرمارک متن"
  }
}

Reference rule

حوالہ تصویر: Image editing projects کے لیے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	No	jpeg	-	jpeg, png
enableTranslation	select	No	true	-	true, false
promptUpsampling	select	No	false	-	false, true
safetyTolerance	number	No	2	min 0 / max 6	-
watermark	text	No	-	-	-

Flux Kontext Pro

flux-kontext-proAPI کے ذریعے availablePartial: Files API needed

Image · Black Forest Labs کا lower-cost Flux Kontext project، text-to-image اور single-image editing کے لیے۔ Rivya فی الحال text-to-image اور image-to-image دونوں کو same async image project پر expose کرتا ہے، current platform pricing policy کے تحت دونوں modes کے لیے fixed 4-credit pricing کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "اختیاری واٹرمارک متن"
  }
}

Reference rule

حوالہ تصویر: Image editing projects کے لیے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	No	jpeg	-	jpeg, png
enableTranslation	select	No	true	-	true, false
promptUpsampling	select	No	false	-	false, true
safetyTolerance	number	No	2	min 0 / max 6	-
watermark	text	No	-	-	-

Qwen2 Image

qwen2-imageAPI کے ذریعے availablePartial: Files API needed

تصویر · Alibaba کا Qwen2 image model فی الحال Rivya پر ایک fixed-price image project کے طور پر integrated ہے۔ یہ safely text-to-image اور image-to-image کو shared aspect-ratio subset کے ساتھ cover کرتا ہے جو دونوں public docs expose کرتی ہیں، plus PNG/JPEG output، seed reuse، اور simple NSFW switch۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

800 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
image_size	select	No	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	No	png	-	png, jpeg
seed	number	No	-	min 0	-
nsfw_checker	select	No	false	-	false, true

Qwen Image

qwen-imageAPI کے ذریعے availablePartial: Files API needed

تصویر · Alibaba Qwen family کا image model، HD presets (Square، Portrait، Landscape) اور PNG/JPEG output کے ساتھ۔ Chinese-language prompts اور culturally nuanced visual generation میں strong ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	No	png	-	png, jpeg

Midjourney

midjourneyAPI کے ذریعے availablePartial: Files API needed

تصویر · Midjourney کا V7 image model text-to-image اور image-to-image کے لئے، Niji anime modes، 3 speed tiers (Relaxed/Fast/Turbo)، style references، اور Omni Reference-driven consistency کے ساتھ۔ Cinematic art، illustrations، اور moodboards کے لئے اب بھی benchmark ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

2000 characters

Reference media

image · 4 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

Reference rule

Reference image: Image projects کے لئے 4 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
speed	select	No	relaxed	-	relaxed, fast, turbo
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	No	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundAPI کے ذریعے availableFiles API needed

تصویر · Rivya پر Recraft کا background-removal model، ایک existing image سے subject isolate کرنے کے لئے۔ اسے اس وقت استعمال کریں جب next step کو transparent asset، clean cutout، یا original background کے بغیر source image چاہئے ہو۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Source image: Exactly 1 image upload کریں۔ Cleaner subject edges عموما cleaner cutouts produce کرتے ہیں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

کوئی extra model parameter required نہیں۔

Recraft Crisp Upscale

recraft-crisp-upscaleAPI کے ذریعے availableFiles API needed

تصویر · Rivya پر Recraft کا light image-upscaling model، ایک approved still پر low-cost sharpness اور clarity boosts کے لئے۔ اسے اس وقت استعمال کریں جب chosen image کو export سے پہلے صرف cheap polish pass چاہئے ہو، heavier delivery-grade upscale نہیں۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Source image: Exactly 1 image upload کریں۔ یہ option quick low-cost polish pass کے لئے ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

کوئی extra model parameter required نہیں۔

Wan 2.7 Image Pro

wan-2-7-image-proAPI کے ذریعے availablePartial: Files API needed

تصویر · Alibaba کا higher-end Wan 2.7 image model، جو Rivya پر text-to-image اور image editing کے لیے separate image slot کے طور پر exposed ہے۔ Generation کو explicitly single output image تک رکھتے ہوئے pricing fixed 12 credits per run رہتی ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 9 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Reference rule

Reference image: Image editing projects کے لیے 9 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	No	2K	-	1K, 2K
watermark	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageAPI کے ذریعے availablePartial: Files API needed

تصویر · Alibaba کا standard Wan 2.7 image model Rivya پر text-to-image اور image editing کے لیے اپنے image slot کے طور پر exposed ہے، اور فی الحال ہر run پر 5 credits cost کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-image, image-to-image

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 9 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Reference rule

Reference image: Image editing projects کے لیے 9 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	No	2K	-	1K, 2K
watermark	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraAPI کے ذریعے availableText input ready

Image · Google Imagen4 Ultra Rivya کا premium Imagen text-to-image tier ہے۔ یہ فی الحال fixed 12-credit، single-image project کے طور پر integrated ہے، public prompt، negative prompt، aspect ratio، اور seed controls کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "اختیاری چیزیں جن سے بچنا ہے",
    "seed": "اختیاری seed value"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	text	No	-	-	-

Google Imagen4

google-imagen4API کے ذریعے availableText input ready

Image · Google Imagen4 Rivya کا standard Imagen text-to-image tier ہے۔ یہ فی الحال fixed 8-credit، single-image project کے طور پر integrated ہے، public prompt، negative prompt، aspect ratio، اور seed controls کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "اختیاری چیزیں جن سے بچنا ہے",
    "seed": "اختیاری seed value"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	text	No	-	-	-

Google Imagen4 Fast

google-imagen4-fastAPI کے ذریعے availableText input ready

Image · Google Imagen4 Fast Rivya کا lightweight Imagen text-to-image tier ہے۔ یہ فی الحال single-image project رکھتا ہے، fixed 4-credit pricing استعمال کرتا ہے، اور multi-image output کھولے بغیر public prompt، negative prompt، aspect ratio، اور seed controls expose کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "اختیاری چیزیں جن سے بچنا ہے",
    "seed": 0
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
aspect_ratio	select	No	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	number	No	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleAPI کے ذریعے availableFiles API needed

تصویر · Topaz کا delivery-grade image upscaler Rivya پر approved stills کے لیے ہے جنہیں real size jump چاہیے ہو۔ اسے تب استعمال کریں جب composition already final ہو اور remaining problem export resolution، review size، یا print readiness ہو۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Source تصویر: وہ 1 approved image upload کریں جسے آپ preserve کرنا چاہتے ہیں۔ یہ option enlargement کے لیے ہے، creative re-editing کے لیے نہیں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
upscale_factor	select	No	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3API کے ذریعے availableText input ready

تصویر · Ideogram V3 Rivya کا text-to-image model ہے، جو text rendering، poster layouts، اور design-first image prompts کے لئے بنایا گیا ہے۔ Current pricing TURBO کے لئے 4 credits، BALANCED کے لئے 7، اور QUALITY کے لئے 10 ہے۔

API guide Model page

Base credits

Modes

text-to-image

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Avoid کرنے کے لئے optional things"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
negative_prompt	text	No	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeAPI کے ذریعے availableFiles API needed

تصویر · Ideogram V3 Reframe فی الحال Rivya پر rendering-speed pricing کے ساتھ single-image reframing project کے طور پر integrated ہے۔ Current pricing TURBO کے لئے 4 credits، BALANCED کے لئے 7، اور QUALITY کے لئے 10 ہے۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image: اس project کے لئے exactly 1 image file upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixAPI کے ذریعے availableFiles API needed

تصویر · Ideogram V3 Remix فی الحال Rivya پر rendering-speed pricing کے ساتھ single-image remix project کے طور پر integrated ہے۔ Current pricing TURBO کے لئے 4 credits، BALANCED کے لئے 7، اور QUALITY کے لئے 10 ہے۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image: اس project کے لئے exactly 1 image file upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
strength	number	No	0.8	min 0.01 / max 1	-
negative_prompt	text	No	-	-	-

Ideogram Character

ideogram-characterAPI کے ذریعے availableFiles API needed

تصویر · ایک approved character image کو نئے scenes، outfits، اور formats میں بدلنے کے لئے character-consistency option۔ اسے اس وقت استعمال کریں جب identity retention broad image editing سے زیادہ اہم ہو اور آپ کو ایک وقت میں صرف ایک output image چاہئے۔

API guide Model page

Base credits

Modes

image-to-image

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Character reference image: 1 clear character reference image upload کریں۔ یہ option extra images ignore کرتا ہے اور output کو single result تک رکھتا ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
negative_prompt	text	No	-	-	-

Seedance 2.0

seedance-2API کے ذریعے availableText input ready

ویڈیو · ByteDance کا full Seedance 2.0 video model، prompt-only generation، frame-driven animation، اور multimodal reference generation کی واضح support کے ساتھ۔ Rivya documented role split کو واضح رکھتا ہے تاکہ frame inputs اور multimodal references الگ رہیں، ایک ambiguous upload bucket میں collapse نہ ہوں۔

API guide Model page

Base credits

175

Modes

text-to-video, image-to-video, reference-to-video

API input

Text input ready

Inputs

text

Prompt limit

2500 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
seedance_scene	select	No	text	-	text, frames, reference
resolution	select	No	720p	-	480p, 720p
aspect_ratio	select	No	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	No	5	min 4 / max 15	-
generate_audio	select	No	true	-	true, false
return_last_frame	select	No	false	-	false, true
web_search	select	No	false	-	false, true
nsfw_checker	select	No	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastAPI کے ذریعے availableText input ready

ویڈیو · ByteDance کا تیز Seedance 2.0 video model، prompt-only generation، frame-driven image animation، اور multimodal reference video generation کے لیے full scene routing کے ساتھ۔ Rivya documented scene split کو واضح رکھتا ہے تاکہ first/last-frame inputs reference image، video، اور audio roles سے نہ ٹکرائیں۔

API guide Model page

Base credits

140

Modes

text-to-video, image-to-video, reference-to-video

API input

Text input ready

Inputs

text

Prompt limit

2500 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
seedance_scene	select	No	text	-	text, frames, reference
resolution	select	No	720p	-	480p, 720p
aspect_ratio	select	No	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	No	5	min 4 / max 15	-
generate_audio	select	No	true	-	true, false
return_last_frame	select	No	false	-	false, true
web_search	select	No	false	-	false, true
nsfw_checker	select	No	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proAPI کے ذریعے availablePartial: Files API needed

ویڈیو · ByteDance کا flagship video model، text-to-video اور image-to-video کے لیے native audio-visual sync کے ساتھ۔ 480p-1080p، 4-12s clips، 6 aspect ratios، dynamic/fixed lens control، optional audio generation، اور lip-sync support۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

2500 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Reference rule

ریفرنس تصویر: Image projects کے لیے 2 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	8	-	4, 8, 12
generate_audio	select	No	false	-	false, true
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	No	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proAPI کے ذریعے availablePartial: Files API needed

ویڈیو · ByteDance کا Seedance 1.0 Pro ماڈل، جو Rivya پر text-to-video اور image-to-video دونوں کے لیے standard 1.0 Pro option کے طور پر دستیاب ہے۔ یہ current page setup کو public V1 Pro docs کے ساتھ resolution، duration، camera lock، seed، اور safety-check controls کے لحاظ سے aligned رکھتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

10000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Reference rule

ریفرنس تصویر: Image-to-video runs کے لیے 1 image file upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	No	false	-	false, true
seed	number	No	-1	min -1 / max 2147483647	-
enable_safety_checker	select	No	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastAPI کے ذریعے availableFiles API needed

ویڈیو · ByteDance کا تیز image-to-video ماڈل۔ ایک ہی reference image کو 720p/1080p میں 5s یا 10s کلپس میں متحرک کرتا ہے - جب static image سے جلدی ویڈیو چاہیے ہو تو رفتار کے لیے بہتر بنایا گیا ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

10000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

ریفرنس تصویر: اسے video میں animate کرنے کے لیے 1 source image upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteAPI کے ذریعے availablePartial: Files API needed

ویڈیو · ByteDance کا Seedance 1.0 Lite ماڈل Rivya پر text-to-video اور image-to-video دونوں کے لیے ہلکے 1.0 option کے طور پر دستیاب ہے۔ یہ public V1 Lite parameter set کی پیروی کرتا ہے اور فی الحال Seedance 1.0 Pro کے مقابلے میں کم pricing ladder استعمال کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

10000 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Reference rule

حوالہ تصویر: image-to-video کے لیے 1 source image upload کریں، یا جب آپ optional end frame بھی دینا چاہتے ہوں تو 2 images upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	No	false	-	false, true
seed	number	No	-1	min -1 / max 2147483647	-
enable_safety_checker	select	No	true	-	true, false

HappyHorse 1.0

happyhorse-1-0API کے ذریعے availablePartial: Files API needed

ویڈیو · Rivya پر ایک flexible AI video model، جو ایک ہی public model page سے text-to-video، single-image motion، multi-image reference video، اور video editing workflows کو support کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video, reference-to-video, video-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image, video · 10 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

Reference rule

Reference media: Video کے بغیر 9 images تک استعمال کریں، یا video editing کے لئے 1 video کے ساتھ 5 image references تک استعمال کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	1080p	-	720p, 1080p
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	No	5	min 3 / max 15	-
audio_setting	select	No	auto	-	auto, origin
seed	number	No	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Alibaba کی newer Wan video line، resolution اور duration کے حساب سے pricing کے ساتھ۔ Rivya فی الحال text-to-video، image-to-video، اور video editing کو one model slot میں expose کرتا ہے، ہر generation پر 80 credits سے شروع۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video, video-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image, video · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "اختیاری exclusions یا failure modes جن سے بچنا ہے۔",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Reference rule

Reference media: 2 assets تک upload کریں۔ Image-to-video کے لیے 2 images تک، یا video editing کے لیے 1 video plus 1 optional image استعمال کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10, 15
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	No	-	-	-
prompt_extend	select	No	true	-	true, false
watermark	select	No	false	-	false, true
audio_setting	select	No	auto	-	auto, origin
seed	number	No	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6API کے ذریعے availablePartial: Files API needed

ویڈیو · Alibaba کا triple-mode Wan option Rivya پر: text-to-video، image-to-video، اور source-video editing ایک ہی project میں۔ یہ 720p/1080p، 5-15 second clips، اور ایک وقت میں one image یا one source video support کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video, video-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image, video · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

Reference rule

Reference media: Image / video projects کے لیے 1 image / video file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Wan 2.5 اب Rivya پر text-to-video اور image-to-video کے لیے one shared entry کے طور پر exposed ہے۔ Current pricing `720p_5 = 60`، `720p_10 = 120`، `1080p_5 = 100`، اور `1080p_10 = 200` credits ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "اختیاری exclusions یا failure modes جن سے بچنا ہے۔",
    "nsfw_checker": "false"
  }
}

Reference rule

Reference image: Image-to-video mode کے لیے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-
negative_prompt	text	No	-	-	-
nsfw_checker	select	No	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Wan 2.2 A14B Turbo اب Rivya پر text-to-video، image-to-video، اور image-and-audio-driven video path cover کرتا ہے۔ Current pricing text یا image runs کے لیے `480p = 8` اور `720p = 12` ہے، plus جب one image اور one audio clip result drive کریں تو `480p = 16`، `580p = 20`، اور `720p = 24` ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video, speech-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image, audio · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "اختیاری exclusions یا failure modes جن سے بچنا ہے۔",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Reference rule

Reference media: 2 assets تک upload کریں۔ Text mode کو none چاہیے، image-to-video ایک image استعمال کرتا ہے، اور image-plus-audio-driven path ایک image plus ایک audio clip استعمال کرتا ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	720p	-	480p, 580p, 720p
aspect_ratio	select	No	16:9	-	16:9, 9:16
enable_prompt_expansion	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-
acceleration	select	No	none	-	none, regular
num_frames	number	No	80	min 40 / max 120 / step 1	-
frames_per_second	number	No	16	min 4 / max 60 / step 1	-
negative_prompt	text	No	-	-	-
num_inference_steps	number	No	27	min 2 / max 40 / step 1	-
guidance_scale	number	No	3.5	min 1 / max 10 / step 0.1	-
shift	number	No	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	No	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceAPI کے ذریعے availableURL input ready

ویڈیو · Wan کا character-replacement video model Rivya پر existing clip میں نظر آنے والے subject کو swap کرنے کے لیے ہے۔ جب motion پہلے ہی درست ہو اور visible subject بدلنا ہو تو one public source video URL، one public replacement image URL، اور resolution tier استعمال کریں۔

API guide Model page

Base credits

Modes

video-to-video

API input

URL input ready

Inputs

url

Prompt limit

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

یہ model model parameters کے ذریعے public URL input قبول کرتا ہے۔

Parameters

key	Type	Required	Default	Range	Options
video_url	text	No	-	-	-
image_url	text	No	-	-	-
resolution	select	No	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3API کے ذریعے availableFiles API needed

ویڈیو · MiniMax کا image-to-video model، جس میں Standard/Pro quality tiers، 768P/1080P resolution، اور 6s یا 10s clips شامل ہیں۔ یہ still images سے smoother motion اور natural transitions کے لئے معروف ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
quality	select	No	standard	-	standard, pro
resolution	select	No	768P	-	768P, 1080P
duration	select	No	6	-	6, 10

Hailuo Pro

hailuo-proAPI کے ذریعے availablePartial: Files API needed

ویڈیو · MiniMax کا older Hailuo Pro video model یہاں ایک fixed Pro-tier model کے طور پر connected ہے، text-to-video اور image-to-video دونوں کے لئے۔ Image mode میں 1 یا 2 reference images قبول ہوتی ہیں، دوسری image last frame کے طور پر استعمال ہوتی ہے، اور ہر run فی الحال 57 credits خرچ کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

1500 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

Reference rule

Reference images: Image mode میں 2 images تک قبول ہوتی ہیں، اور دوسری image last frame بن جاتی ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
prompt_optimizer	select	No	false	-	false, true

Hailuo Standard

hailuo-standardAPI کے ذریعے availablePartial: Files API needed

ویڈیو · MiniMax کا older Hailuo Standard video model، جو یہاں text-to-video اور image-to-video دونوں کے لئے ایک model کے طور پر unified ہے۔ Image mode میں 1 یا 2 reference images قبول ہوتی ہیں، دوسری image last frame کے طور پر استعمال ہوتی ہے، اور فی الحال verified public pricing tiers 12 سے 50 credits تک ہیں۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

1500 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

Reference rule

Reference images: Image mode میں 2 images تک قبول ہوتی ہیں، اور دوسری image last frame بن جاتی ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	6	-	6, 10
resolution	select	No	512P	-	512P, 768P
prompt_optimizer	select	No	false	-	false, true

Kling 3.0

kling-3-0API کے ذریعے availablePartial: Files API needed

ویڈیو · Kuaishou کا premium video model text-to-video اور image-to-video کے لئے، Standard (720P) / Pro (1080P) tiers، single یا multi-shot structure، 3-15s duration، optional audio generation، اور up to 2 reference images کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

2000 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

Reference rule

Reference media: Image-to-video projects کے لئے total 2 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
mode	select	No	pro	-	std, pro
multi_shots	select	No	false	-	false, true
duration	select	No	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	No	false	-	false, true
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlAPI کے ذریعے availableFiles API needed

ویڈیو · ایک reference image plus ایک motion video سے ایک subject کو drive کرنے کے لئے newer Kling motion-control option، جس میں explicit background-source choice شامل ہے۔ اسے اس وقت استعمال کریں جب آپ motion transfer کے ساتھ زیادہ مضبوط control چاہتے ہوں کہ scene video سے آئے یا image سے۔

API guide Model page

Base credits

Modes

video-to-video

API input

Files API needed

Inputs

file

Prompt limit

2500 characters

Reference media

image, video · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image + motion video: Exactly 1 character image اور 1 motion clip upload کریں۔ جب آپ کو orientation control اور background-source choice دونوں چاہئیں تو 3.0 استعمال کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
mode	select	No	pro	-	std, pro
character_orientation	select	No	video	-	video, image
background_source	select	No	input_video	-	input_video, input_image

Kling 2.6

kling-2-6API کے ذریعے availablePartial: Files API needed

ویڈیو · Kuaishou کا video model جس میں optional audio generation، 5s/10s clips، اور 3 aspect ratios شامل ہیں۔ Natural physics کے ساتھ human motion اور expressive character animation میں strong ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

1000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
sound	select	No	false	-	false, true
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlAPI کے ذریعے availableFiles API needed

ویڈیو · ایک reference image plus ایک motion video سے ایک subject کو drive کرنے کے لئے dedicated motion-transfer project۔ اسے اس وقت استعمال کریں جب آپ cheaper Kling motion-control pass چاہتے ہوں اور Kling 3.0 motion-control کے extra scene controls کے بغیر کام چل سکتا ہو۔

API guide Model page

Base credits

Modes

video-to-video

API input

Files API needed

Inputs

file

Prompt limit

2500 characters

Reference media

image, video · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image + motion video: Exactly 1 character image اور 1 motion clip upload کریں۔ دونوں میں head، shoulders، اور torso واضح ہونے چاہئیں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
mode	select	No	720p	-	720p, 1080p
character_orientation	select	No	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Kuaishou کا Kling V2.5 Turbo Pro video model، جو اب text-to-video اور image-to-video دونوں support کرتا ہے۔ Public pricing evidence text اور image tiers دونوں کو 5 seconds اور 10 seconds پر واضح طور پر cover کرتی ہے، اس لئے Rivya اسے براہ راست 42 / 84 credits پر map کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

2500 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Describe کریں کہ video کو کن چیزوں سے بچنا چاہئے",
    "cfg_scale": 0.5
  }
}

Reference rule

Reference images: Image-to-video mode میں switch کرنے کے لئے optionally 2 images تک upload کریں؛ دوسری image tail frame پر map ہوتی ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Kuaishou کا older Kling V2.1 Master video model اب Rivya پر text-to-video اور image-to-video دونوں support کرتا ہے۔ Current pricing 5 seconds کے لئے 160 credits اور 10 seconds کے لئے 320 credits ہے۔

API guide Model page

Base credits

160

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Describe کریں کہ video کو کن چیزوں سے بچنا چاہئے",
    "cfg_scale": 0.5
  }
}

Reference rule

Reference image: Image-to-video mode میں switch کرنے کے لئے optionally ایک image upload کریں؛ text mode میں رہنے کے لئے اسے empty چھوڑ دیں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proAPI کے ذریعے availableFiles API needed

ویڈیو · Kuaishou کا older Kling V2.1 Pro image-to-video model first frame plus optional tail frame image support کرتا ہے۔ Current pricing 5 seconds کے لئے 50 credits اور 10 seconds کے لئے 100 credits ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference images: Image mode 2 image files تک قبول کرتا ہے، اور دوسری image tail frame پر map ہوتی ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardAPI کے ذریعے availableFiles API needed

ویڈیو · Kuaishou کا older Kling V2.1 Standard image-to-video model۔ Current pricing 5 seconds کے لئے 25 credits اور 10 seconds کے لئے 50 credits ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Reference image: Image mode first frame کے طور پر 1 image file تک قبول کرتا ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proAPI کے ذریعے availableFiles API needed

ویڈیو · Kuaishou کا Kling AI Avatar Pro higher-quality talking-avatar model ہے، جو ایک portrait image plus ایک audio clip سے lip-synced avatar video generate کرتا ہے۔ Rivya فی الحال اسے fixed 16 credits per generation پر price کرتا ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image, audio · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Portrait image and audio: ایک portrait image اور ایک audio clip ساتھ upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

کوئی extra model parameter required نہیں۔

Kling AI Avatar Standard

kling-ai-avatar-standardAPI کے ذریعے availableFiles API needed

ویڈیو · Kuaishou کا Kling AI Avatar Standard talking-avatar model ہے، جو ایک portrait image plus ایک audio clip سے lip-synced avatar video generate کرتا ہے۔ Rivya فی الحال اسے fixed 8 credits per generation پر price کرتا ہے۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image, audio · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Portrait image and audio: ایک portrait image اور ایک audio clip ساتھ upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

کوئی extra model parameter required نہیں۔

Infinitalk

infinitalkAPI کے ذریعے availableFiles API needed

ویڈیو · Infinitalk ایک portrait-plus-audio talking-video model ہے۔ Current pricing resolution اور audio duration کے حساب سے metered ہے: 480p = 3 credits per second اور 720p = 12 credits per second۔

API guide Model page

Base credits

Modes

image-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

image, audio · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Portrait image and audio: ایک portrait image اور ایک audio clip ساتھ upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
resolution	select	No	480p	-	480p, 720p
seed	number	No	-	min 10000 / max 1000000	-

Runway

runwayAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Runway ایک الگ ویڈیو ماڈل ہے جو متن سے ویڈیو اور تصویر سے ویڈیو دونوں کو سپورٹ کرتا ہے۔ عوامی قیمت کے شواہد فی الحال صرف 6 جنریشن درجات کی تصدیق کرتے ہیں، اس لیے Rivya اسے تصدیق شدہ سیٹ پر رکھتا ہے: `720p_5 = 12`، `720p_10 = 30`، اور `1080p_5 = 30`۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

1800 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "watermark disable کرنے کے لیے empty چھوڑ دیں"
  }
}

Reference rule

حوالہ تصویر: image-to-video mode میں switch کرنے کے لیے optional طور پر ایک image upload کریں؛ text mode میں رہنے کے لیے اسے empty چھوڑ دیں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
duration	select	No	5	-	5, 10
quality	select	No	720p	-	720p, 1080p
aspectRatio	select	No	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	No	-	-	-

Runway Aleph

runway-alephAPI کے ذریعے availableFiles API needed

ویڈیو · Existing clip کو نئے visual result میں rework کرنے کے لئے source-video transformation project۔ Aleph اس وقت استعمال کریں جب motion آپ کی input footage سے آئے اور creative direction prompt سے، fixed 90-credit price کے ساتھ۔

API guide Model page

Base credits

Modes

video-to-video

API input

Files API needed

Inputs

file

Prompt limit

5000 characters

Reference media

video, image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Input media: وہ source clip upload کریں جسے Aleph سے transform کروانا ہے۔ Extra style یا subject guidance کی ضرورت ہو تو صرف ایک optional still image add کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	No	-	-	-
seed	number	No	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoAPI کے ذریعے availableFiles API needed

ویڈیو · ایک existing clip کو نئی visual direction میں push کرنے کے لئے standalone source-video rewrite project۔ اسے اس وقت استعمال کریں جب prompt کو footage خود transform کرنی ہو، صرف export sharpen نہیں کرنا۔

API guide Model page

Base credits

Modes

video-to-video

API input

Files API needed

Inputs

file

Prompt limit

Reference media

video · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Input video: ایک short source clip upload کریں جسے آپ transform کرنا چاہتے ہیں۔ یہ option footage کو simply enhance کرنے کے بجائے rewrite کرتا ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
watermark	text	No	-	-	-

Grok Imagine Video

grok-imagine-videoAPI کے ذریعے availablePartial: Files API needed

ویڈیو · xAI کا video model، جس میں Fun/Normal/Spicy creative modes اور 5 aspect ratios شامل ہیں۔ مختلف creative tones کے لئے منفرد style presets — playful سے cinematic اور edgy تک۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

Reference rule

Reference image: Image projects کے لئے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
mode	select	No	normal	-	fun, normal, spicy
duration	number	No	6	min 6 / max 30 / step 1	-
resolution	select	No	480p	-	480p, 720p
aspect_ratio	select	No	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Sora 2 کی premium tier، Standard/High quality modes، 10s/15s clips، اور watermark removal کے ساتھ۔ Professional video production کے لیے enhanced detail، lighting، اور motion fidelity۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

10000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Reference rule

ریفرنس تصویر: Image projects کے لیے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
size	select	No	-	-	standard, high
n_frames	select	No	10	-	10, 15
aspect_ratio	select	No	landscape	-	landscape, portrait
remove_watermark	select	No	false	-	false, true
upload_method	select	No	s3	-	s3, oss

Sora 2

sora-2API کے ذریعے availablePartial: Files API needed

ویڈیو · OpenAI کا video model، text-to-video اور image-to-video کے لیے، realistic world simulation، synced audio، 10s/15s clips، landscape/portrait outputs، اور optional watermark removal کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

10000 characters

Reference media

image · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Reference rule

ریفرنس تصویر: Image projects کے لیے 1 image file تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
n_frames	select	No	10	-	10, 15
aspect_ratio	select	No	landscape	-	landscape, portrait
remove_watermark	select	No	false	-	false, true
upload_method	select	No	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerAPI کے ذریعے availableURL input ready

ویڈیو · Rivya پر finished public Sora share links کے لیے Sora کا watermark-removal post-processing model۔ اسے video already done ہونے کے بعد استعمال کریں، جب remaining task watermark removal اور S3 یا OSS delivery چننا ہو۔

API guide Model page

Base credits

Modes

video-to-video

API input

URL input ready

Inputs

url

Prompt limit

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

یہ model model parameters کے ذریعے public URL input قبول کرتا ہے۔

Parameters

key	Type	Required	Default	Range	Options
video_url	text	Yes	-	-	-
upload_method	select	Yes	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleAPI کے ذریعے availableFiles API needed

ویڈیو · Topaz کا delivery-grade video upscaler Rivya پر ایسے approved clips کے لیے ہے جنہیں export کے وقت صرف زیادہ clarity چاہیے۔ اسے تب استعمال کریں جب shot، motion، اور timing پہلے ہی درست ہوں اور باقی مسئلہ resolution یا final-file sharpness ہو۔

API guide Model page

Base credits

Modes

video-to-video

API input

Files API needed

Inputs

file

Prompt limit

Reference media

video · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

ماخذ ویڈیو: وہ 1 source clip upload کریں جسے آپ preserve کرنا چاہتے ہیں۔ یہ option shot بدلنے کے بجائے delivery clarity improve کرتا ہے۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
upscale_factor	select	No	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Google Veo 3.1 کا quality-first variant premium text-to-video اور image-led generation کے لیے۔ Higher-fidelity visuals، stronger motion realism، اور default background audio اسے Rivya کا higher-end Veo option بناتے ہیں۔

API guide Model page

Base credits

150

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "اختیاری watermark text",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Reference rule

Reference image: Supported image-led project کے لیے 2 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Veo3.1 Fast

veo3-1-fastAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Google Veo 3.1 کا fast variant triple-mode support کے ساتھ: text-to-video، image-to-video، اور reference-to-video۔ 3 reference images تک، native audio، اور mode-aware aspect-ratio controls اسے quick cinematic clips کے لیے مفید بناتے ہیں۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video, reference-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 3 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "اختیاری watermark text",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Reference rule

Reference image: Image اور reference-driven projects کے لیے 3 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
generationType	select	No	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Veo3.1 Lite

veo3-1-liteAPI کے ذریعے availablePartial: Files API needed

ویڈیو · Google Veo 3.1 کا lowest-cost variant۔ Rivya فی الحال صرف smallest stable subset expose کرتا ہے: text-to-video اور image-to-video، ہر generation پر fixed `10` credits کے ساتھ۔

API guide Model page

Base credits

Modes

text-to-video, image-to-video

API input

Partial: Files API needed

Inputs

text, file

Prompt limit

5000 characters

Reference media

image · 2 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "اختیاری watermark text",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Reference rule

Reference image: Supported image-driven project کے لیے 2 image files تک upload کریں۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt یا URL modes ابھی callable ہو سکتے ہیں۔ Reference-media modes کو اب بھی Files API upload support چاہیے۔ Files API

Parameters

key	Type	Required	Default	Range	Options
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Suno Music

suno-musicAPI کے ذریعے availableText input ready

آڈیو · Suno Music Rivya کا text-to-music model ہے، جو ایک short brief کو vocals کے ساتھ یا بغیر first song draft میں بدلتا ہے۔ یہ fixed `12` credit entry point برقرار رکھتا ہے اور successful track کے بعد `Extend Music` کو next step کے طور پر expose کرتا ہے۔

API guide Model page

Base credits

Modes

text-to-audio

API input

Text input ready

Inputs

text

Prompt limit

500 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
model	select	No	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	No	false	-	false, true

Suno Sounds

suno-soundsAPI کے ذریعے availableText input ready

آڈیو · Suno Sounds Rivya کا lightweight text-to-sound model ہے، ambience loops، background sound، اور short sonic sketches کے لیے۔ یہ documented fixed price `3` credits per generation برقرار رکھتا ہے اور successful results کو `Vocal Separation` میں continue کرنے دیتا ہے۔

API guide Model page

Base credits

Modes

text-to-audio

API input

Text input ready

Inputs

text

Prompt limit

500 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
model	select	No	V5	-	V5, V5_5
soundLoop	select	No	false	-	false, true
soundTempo	number	No	-	min 1 / max 300 / step 1	-
soundKey	select	No	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsAPI کے ذریعے availableText input ready

آڈیو · Suno Lyrics Rivya کا lyric-generation model ہے، جو ایک theme یا mood کو fixed `1` credit per request پر song words میں بدلتا ہے۔

API guide Model page

Base credits

Modes

text-to-audio

API input

Text input ready

Inputs

text

Prompt limit

200 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

کوئی extra model parameter required نہیں۔

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3API کے ذریعے availableText input ready

Audio · ElevenLabs کا multi-speaker dialogue model Rivya پر۔ یہ role-based speech generation کے لیے built ہے، individual voice assignments، stability controls، اور podcasts، interviews، character scenes کے لیے dialogue-ready pacing کے ساتھ۔

API guide Model page

Base credits

Modes

dialogue-to-audio

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
default_voice	select	No	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	No	0.5	-	0, 0.5, 1
language_code	text	No	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5API کے ذریعے availableText input ready

Audio · ElevenLabs کا fast text-to-speech model Rivya پر۔ Low-latency voice generation اور adjustable stability، similarity، style، speed کے ساتھ یہ rapid voiceover drafts اور interactive TTS projects کے لیے built ہے۔

API guide Model page

Base credits

Modes

text-to-speech

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "اختیاری context اس line سے پہلے",
    "next_text": "اختیاری context اس line کے بعد",
    "language_code": "اختیاری locale code جیسے en یا zh"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
voice	select	Yes	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	No	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	No	0.75	min 0 / max 1 / step 0.05	-
style	number	No	0	min 0 / max 1 / step 0.05	-
speed	number	No	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	No	false	-	false, true
previous_text	text	No	-	-	-
next_text	text	No	-	-	-
language_code	text	No	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2API کے ذریعے availableText input ready

Audio · ElevenLabs کا multilingual text-to-speech model Rivya پر، auto-detection کے ساتھ تقریباً 30 languages support کرتا ہے۔ یہ localization، cross-language delivery، اور زیادہ natural multilingual voiceovers کے لیے stronger option ہے۔

API guide Model page

Base credits

Modes

text-to-speech

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
voice	select	Yes	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	No	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	No	0.75	min 0 / max 1 / step 0.05	-
style	number	No	0	min 0 / max 1 / step 0.05	-
speed	number	No	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	No	false	-	false, true
previous_text	text	No	-	-	-
next_text	text	No	-	-	-
language_code	text	No	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2API کے ذریعے availableText input ready

Audio · ElevenLabs کا text-to-sound model Rivya پر short effects، transitions، اور ambience loops کے لیے۔ Editing، product، یا game projects کے لیے adjustable prompt influence، loop mode، اور 19 output formats کے ساتھ 0.5-22 second audio clips generate کریں۔

API guide Model page

Base credits

Modes

text-to-audio

API input

Text input ready

Inputs

text

Prompt limit

5000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Required	Default	Range	Options
loop	select	No	false	-	false, true
duration_seconds	number	No	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	No	0.3	min 0 / max 1 / step 0.05	-
output_format	select	No	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationAPI کے ذریعے availableFiles API needed

Audio · ElevenLabs کا audio cleanup اور voice-isolation model Rivya پر۔ ایک recording upload کریں تاکہ vocals isolate ہوں، background noise remove ہو، اور spoken audio editing یا publishing سے پہلے clean ہو جائے۔

API guide Model page

Base credits

Modes

audio-to-audio

API input

Files API needed

Inputs

file

Prompt limit

Reference media

audio · 1 file(s)

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

اس model کے لیے کوئی runnable Public API example نہیں دکھایا گیا۔

Reference rule

Source audio: ایک audio file upload کریں اور Rivya target track کو isolate اور clean کرے گا۔

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

File-based modes کو complete API-ready examples کے طور پر دکھانے سے پہلے /api/v1/files درکار ہے۔ Files API

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.5

gpt-5-5-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا advanced GPT chat model، جو complex reasoning، image-aware analysis، research synthesis، اور structured writing کے لئے موزوں ہے جب brief کو زیادہ room چاہئے۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.4

gpt-5-4-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا higher-end AI chat model، جس میں زیادہ مضبوط structured input handling، reasoning control، اور complex analysis و writing tasks کے لئے tool-oriented conversation projects شامل ہیں۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.4 Codex

gpt-5.4-codex-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا higher-end Codex model، جو demanding repo-scale development projects کے لئے stronger coding، structured reasoning، اور tool-oriented collaboration فراہم کرتا ہے۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.3 Codex

gpt-5-3-codex-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا تازہ ترین اور سب سے capable Codex model۔ یہ سب سے demanding development projects کے لئے state-of-the-art code generation کو deeper agentic reasoning کے ساتھ combine کرتا ہے۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.2

gpt-5-2-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا flagship AI chat model، جس میں advanced reasoning، 6 images تک کے لئے vision support، اور 20K-character context window شامل ہے۔ یہ research، planning، writing اور image-aware analysis کے لئے ایک مضبوط general GPT option ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.2 Codex

gpt-5-2-codex-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا زیادہ advanced Codex model، جو complex engineering tasks کے لئے stronger reasoning فراہم کرتا ہے۔ یہ long-horizon agentic coding، architecture decisions، اور بڑے refactors کے لئے optimized ہے جہاں plain code generation کافی نہیں ہوتی۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5.1 Codex

gpt-5-1-codex-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا اپ گریڈ شدہ Codex ماڈل، جس میں agentic coding کاموں کے لئے کوڈ کی درستگی بہتر اور reasoning زیادہ مضبوط ہے۔ یہ طویل output اور repo-aware project والا وہی انداز برقرار رکھتا ہے، مگر multi-file refactors اور زیادہ محفوظ code edits کو بہتر بناتا ہے۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

GPT-5 Codex

gpt-5-codex-chatAPI کے ذریعے availableText input ready

چیٹ · Rivya پر OpenAI کا code-specialized GPT-5 Codex model، جو debugging، implementation planning، refactors، اور vision support کے ساتھ technical problem-solving کے لئے موزوں ہے۔

API guide Model page

Base credits

Modes

responses

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Gemini 3.1 Pro

gemini-3-1-pro-chatAPI کے ذریعے availableText input ready

Chat · Google کا latest اور most capable Gemini AI chat model Rivya پر۔ Top-tier reasoning، vision، اور instruction following کے ساتھ یہ demanding analytical اور creative tasks کے لیے strongest Gemini option ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Gemini 3 Pro

gemini-3-pro-chatAPI کے ذریعے availableText input ready

Chat · Google کا higher-depth Gemini AI chat model Rivya پر۔ Gemini 2.5 Pro سے stronger reasoning اور vision support کے ساتھ یہ research synthesis، technical writing، اور زیادہ deliberate multimodal analysis کے لیے بہتر suited ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Gemini 3 Flash

gemini-3-flash-chatAPI کے ذریعے availableText input ready

Chat · Google کا next-gen fast AI chat model Rivya پر۔ Gemini 2.5 Flash سے بھی lower token costs اور stronger reasoning کے ساتھ یہ high-volume multimodal chat، screenshot triage، اور rapid assistant work کے لیے built ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Gemini 2.5 Pro

gemini-2-5-pro-chatAPI کے ذریعے availableText input ready

Chat · Google کا زیادہ advanced Gemini AI chat model Rivya پر۔ Flash سے stronger reasoning، vision support، اور 20K context کے ساتھ یہ 2 credits پر research synthesis، document analysis، اور structured writing کے لیے بہتر fit ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Gemini 2.5 Flash

gemini-2-5-flash-chatAPI کے ذریعے availableText input ready

Chat · Google کا سب سے fast اور affordable AI chat model Rivya پر۔ 1 credit per use اور 6 images تک vision support کے ساتھ یہ quick Q&A، first-pass summaries، screenshot triage، اور everyday AI assistance کے لیے fit ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text, file

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ Image attachments کو Files API کی file_id values استعمال کرنی ہوں گی۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Opus 4.7

claude-opus-4-7-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا flagship Claude chat model Rivya پر، deep reasoning، careful synthesis، executive writing، اور high-impact text work کے لیے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Opus 4.6

claude-opus-4-6-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا flagship Claude AI chat model Rivya پر۔ یہ demanding، high-stakes projects میں deep reasoning، complex analysis، اور high-quality writing کے لیے built ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Sonnet 4.6

claude-sonnet-4-6-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا balanced Claude AI chat model Rivya پر۔ یہ content، research، اور coding projects کے لیے strong long-form reasoning اور careful analysis برقرار رکھتا ہے، بغیر Opus-level spend تک jump کیے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Opus 4.5

claude-opus-4-5-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا flagship Claude AI chat model Rivya پر۔ یہ deep reasoning، complex analysis، اور expert-level writing میں exceptional ہے، اس لیے mission-critical AI tasks کے لیے premium choice ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Sonnet 4.5

claude-sonnet-4-5-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا balanced Claude AI chat model Rivya پر۔ یہ nuanced writing، careful analysis، اور safety-conscious responses میں مضبوط ہے، اس لیے content creation اور research کے لیے ایک مضبوط Claude option بنتا ہے۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Claude Haiku 4.5

claude-haiku-4-5-chatAPI کے ذریعے availableText input ready

Chat · Anthropic کا lightweight Claude AI chat model Rivya پر۔ یہ speed، cost efficiency، اور high-frequency projects میں stable day-to-day chat performance کے لیے tuned ہے، جہاں آپ premium spend کے بغیر Claude tone چاہتے ہیں۔

API guide Model page

Base credits

Modes

chat-completion

API input

Text input ready

Inputs

text

Prompt limit

20000 characters

Reference media

Request

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Recommended

Body

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Reference rule

Result

create response ایک public task id واپس کرتا ہے۔ status succeeded یا failed ہونے تک GET /api/v1/generations/{taskId} poll کریں۔

Common errors

validation_failed, insufficient_credits, idempotency_conflict, not_found

Public API v1 میں Chat API non-streaming اور SSE streaming turns support کرتی ہے۔ اس chat model کے لیے image attachments supported نہیں ہیں۔

Parameters

کوئی extra model parameter required نہیں۔

Model API reference

اس reference کو کیسے پڑھیں

Request pattern

Dynamic model reference

اس reference کو debugger کے ساتھ استعمال کریں

Z-Image

Body

Parameters

Nano Banana 2

Body

Parameters

Nano Banana Pro

Body

Parameters

Nano Banana

Body

Parameters

GPT Image 2

Body

Parameters

GPT Image 1.5

Body

Parameters

4o Image

Body

Parameters

Seedream 5.0 Lite

Body

Parameters

Seedream 4.5

Body

Parameters

Seedream 4.0

Body

Parameters

Seedream 3.0

Body

Parameters

Grok Imagine

Body

Parameters

Flux 2 Pro

Body

Parameters

Flux 2 Flex

Body

Parameters

Flux Kontext Max

Body

Parameters

Flux Kontext Pro

Body

Parameters

Qwen2 Image

Body

Parameters

Qwen Image

Body

Parameters

Midjourney

Body

Parameters

Recraft Remove Background

Body

Parameters

Recraft Crisp Upscale

Body

Parameters

Wan 2.7 Image Pro

Body

Parameters

Wan 2.7 Image

Body

Parameters

Google Imagen4 Ultra

Body

Parameters

Google Imagen4

Body

Parameters