Model API Reference
Look up Rivya API model IDs, availability, supported modes, parameter tables, prompt limits, reference media rules, and model detail links.
Last reviewed on August 29, 2026
This page is the model-level API reference for Rivya API v1.
The table below is generated from the same model catalog and public serializer used by /api/v1/models. It is not a hand-written fixed model count.
The reference documents the implemented contract. Runtime calls still require Public API to be enabled for the deployment and the selected model to report an available API status at request time.
How To Read This Reference
Use the model
idasmodelinPOST /api/v1/generationsfor asynchronous image, video, and audio models.Use chat model IDs in
POST /api/v1/chat/completions.Use top-level
promptfor generation prompt text.Use top-level
messagefor Chat API turns.Put asynchronous model-specific fields inside
params.Read
api_input_statusbefore building an integration.available_textandavailable_url_inputcan be tested without file upload;partial_requires_filesmeans only some modes need Files API;requires_files_apimeans upload reference media through Files API before calling the model.For all five Image5 models, preserve the original model-bound Files API
width,height,size_bytes, andimage_dimensions_token, and pass them aswidth,height,sizeBytes, andimageDimensionsToken; re-upload when the token is absent or expired. Layer Decomposition additionally requires exactly one image within its documented geometry limits.Grok Imagine Image 2.0 uses the same signed image fields for each of its one to five standard image-edit references. Prompt-only requests use text-to-image; signed references switch to image edit.
autois edit-only, while Segment Map and Segment Edit remain unavailable.For Video8 video references, preserve
duration_seconds,duration_token,video_width,video_height,frames_per_second,video_bitrate_mbps,video_file_size_bytes, andvideo_metadata_token. Pass them asdurationSeconds,durationToken,width,height,framesPerSecond,videoBitrateMbps,sizeBytes, andvideoMetadataToken; re-upload when either signed token is absent or expired.Wan 3.0 exposes mutually exclusive text, first/last-frame, and multimodal-reference scenes with Standard or Prime, 480P/720P/1080P, six aspect ratios, explicit 2–30-second or intelligent duration, generated audio, and seed. Its images use signed MIME, dimensions, and byte size; videos also require signed duration and video metadata; audio duration tokens bind MIME type and byte size. Intelligent duration reserves 30 seconds and cannot be combined with reference video. File-to-video and link-to-video shortcuts remain unavailable.
Model-specific Files API limits are stricter than generic file-kind defaults. Use the target model ID during upload so unsupported kinds, MIME types, byte sizes, durations, dimensions, frame rates, and bitrates fail before credit reservation.
For chat models, read
chat_capabilitiesfor non-streaming support, SSE streaming support, imagefile_idattachments, web search, thoughts, and reasoning effort.Model detail pages give product-level guidance and examples.
Request Pattern
{
"model": "z-image",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "1:1"
}
}For JavaScript and Python examples, see Create Generation.
Chat request shape:
{
"model": "claude-sonnet-5-chat",
"message": "Write a concise launch plan for a new product image campaign"
}For Chat examples, see Chat API.
Dynamic Model Reference
Use this reference with the debugger
Start from the quickstart, confirm model fields here, then run a mock or signed-in live request in the Developers debugger.
GPT Image 2.5 Flare
gpt-image-2-5-flareAvailable via APIPartial: Files API neededImage · Generate images from text or edit with up to 16 reference images. Choose 1K, 2K, or 4K and an automatic, transparent, or opaque background.
Base credits
per_image · 1K=3 · 2K=10 · 4K=16 · ⌈total⌉
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-5-flare",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "auto",
"resolution": "1K",
"background": "auto"
}
}Reference rule
Reference images: Upload up to 16 image references for GPT Image 2.5 Flare image-to-image tasks.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| aspect_ratio | select | No | auto | - | auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9 |
| resolution | select | No | 1K | - | 1K, 2K, 4K |
| background | select | No | auto | - | auto, transparent, opaque |
GPT Image 2.5 Sunburst
gpt-image-2-5-sunburstAvailable via APIPartial: Files API neededImage · Generate images from text or edit with up to 16 reference images. Choose 1K, 2K, or 4K and an automatic, transparent, or opaque background.
Base credits
per_image · 1K=3 · 2K=10 · 4K=16 · ⌈total⌉
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-5-sunburst",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "auto",
"resolution": "1K",
"background": "auto"
}
}Reference rule
Reference images: Upload up to 16 image references for GPT Image 2.5 Sunburst image-to-image tasks.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| aspect_ratio | select | No | auto | - | auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9 |
| resolution | select | No | 1K | - | 1K, 2K, 4K |
| background | select | No | auto | - | auto, transparent, opaque |
GPT Image 2
gpt-image-2Available via APIPartial: Files API neededImage · OpenAI's newer GPT Image model on Rivya, with text-to-image, image-to-image, up to 16 reference images, and clear 1K / 2K / 4K credit tiers.
Base credits
per_image · 1K=3 · 2K=5 · 4K=8 · ⌈total⌉
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: Upload up to 16 image references for GPT Image 2 image-to-image tasks.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-5Available via APIPartial: Files API neededImage · OpenAI's image model with medium/high quality tiers and up to 16 reference images. Excels at following complex instructions and rendering coherent scenes with accurate spatial relationships.
Base credits
per_image · medium=4 · high=22 · ⌈total⌉
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: Upload up to 16 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
Z-Image
z-imageAvailable via APIText input readyImage · Alibaba's lightweight text-to-image model. Fast single-image generation with 5 aspect ratios — ideal for quick concept drafts and social media visuals at just 1 credit.
Base credits
per_image · default=0.8 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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-2Available via APIPartial: Files API neededImage · Nano Banana 2 is Rivya's newer Nano Banana image model for brand visuals, product images, and reference-led creative drafts when you want a more current Google-image path than the base tier.
Base credits
per_image · 1K=5 · 2K=8 · 4K=12 · ⌈total⌉
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"
}
}Reference rule
Reference image: Upload up to 14 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
Nano Banana 2 Lite
nano-banana-2-liteAvailable via APIPartial: Files API neededImage · Nano Banana 2 Lite is Rivya's lower-credit Nano Banana option for quick product concepts, social image variants, and reference-led drafts, with a fixed 3-credit generation price and 15 aspect-ratio choices.
Base credits
per_image · default=3 · ⌈total⌉
Modes
text-to-image, image-to-image
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image · 10 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "nano-banana-2-lite",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "auto"
}
}Reference rule
Reference images: Upload up to 10 JPEG, PNG, or WebP images, no more than 30 MB each.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| aspect_ratio | select | No | auto | - | auto, 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 |
Nano Banana Pro
nano-banana-proAvailable via APIPartial: Files API neededImage · Google's premium image model with 4K output, 11 aspect ratios, and up to 8 reference images. Optimized for high-fidelity brand and campaign visuals with superior detail and color accuracy.
Base credits
per_image · 1K=8 · 2K=8 · 4K=14 · ⌈total⌉
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: Upload up to 8 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-bananaAvailable via APIPartial: Files API neededImage · Google's flexible image model for text-to-image and image-to-image with 11 aspect ratios, up to 10 reference images, and PNG/JPEG output. A strong fit for portraits, product compositions, and wider landing-page visuals.
Base credits
per_request · text_to_image=3 · image_to_image=3 · ⌈total⌉
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: Upload up to 10 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
4o Image
4o-imageAvailable via APIText input readyImage · OpenAI's 4o Image model is now available as a dedicated text-to-image path on Rivya. It keeps the page setup intentionally narrow for now: prompt plus 3 supported aspect ratios at a fixed 3 credits per image.
Base credits
per_request · text_to_image=3 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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-liteAvailable via APIPartial: Files API neededImage · ByteDance's lighter Seedream image model with shared pricing across text-to-image and image editing. It supports 8 aspect ratios, up to 14 reference images, and currently costs 6 credits per run.
Base credits
per_image · default=5.5 · ⌈total⌉
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",
"output_format": "png",
"nsfw_checker": "true"
}
}Reference rule
Reference image: Upload up to 14 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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, ultra |
| output_format | select | No | png | - | png, jpeg |
| nsfw_checker | select | No | true | - | false, true |
Seedream 5.0 Pro
seedream-5-proAvailable via APIPartial: Files API neededImage · Seedream 5.0 Pro is Rivya's multi-reference image model for campaign frames, editorial scenes, and product compositions, with text-to-image, image-to-image, 1K or 2K output, and up to 10 reference images.
Base credits
per_image_plus_reference_image · basic=7 · high=14 · additional_input_image=0.5 · ⌈total⌉
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-5-pro",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "1:1",
"quality": "basic",
"output_format": "png",
"nsfw_checker": "false"
}
}Reference rule
Reference images: Upload up to 10 JPEG, PNG, or WebP images, no more than 10 MB each.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| aspect_ratio | 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 |
| output_format | select | No | png | - | png, jpeg |
| nsfw_checker | select | No | false | - | false, true |
Seedream 5.0 Pro Layer Decomposition
seedream-5-pro-layer-decompositionAvailable via APIFiles API neededImage · Seedream 5.0 Pro Layer Decomposition separates one source image into a base image and reusable PNG layers, with optional prompt or bounding-box guidance and Auto, 1K, 1.5K, or 2K sizing.
Base credits
per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉
Modes
image-to-layers
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
No runnable Public API example is shown for this model.
Reference rule
Source image: Upload exactly one PNG, JPEG, WebP, BMP, TIFF, or GIF up to 30 MB; HEIC and HEIF are not supported.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| size | select | No | auto | - | auto, 1K, 1.5K, 2K |
| output_format | select | No | jpeg | - | jpeg, png |
Seedream 5.0 Flash
seedream-5-flashThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Seedream 5.0 Flash — This model has been announced. Rivya is verifying its inputs, billing, and content before enabling generation. Please choose an available alternative.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Seedream 5.0 Flash Layer Decomposition
seedream-5-flash-layer-decompositionThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Seedream 5.0 Flash Layer Decomposition — This model has been announced. Rivya is verifying its inputs, billing, and content before enabling generation. Please choose an available alternative.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Seedream 4.5
seedream-4-5Available via APIPartial: Files API neededImage · ByteDance's high-end image model with 2K/4K quality tiers, 8 aspect ratios, and up to 14 reference images. Known for cinematic color grading and rich texture detail in fashion and lifestyle visuals.
Base credits
per_image · default=6.5 · ⌈total⌉
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
Reference image: Upload up to 14 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-0This request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Seedream 4.0 is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 10 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Seedream 3.0
seedream-3-0This request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Seedream 3.0 is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Grok Imagine Image 2.0
grok-imagine-image-2-0Available via APIPartial: Files API neededImage · Grok Imagine Image 2.0 supports single-image text generation and standard image editing with one to five signed reference images, five fixed aspect ratios, and an automatic ratio option for edit requests.
Base credits
per_image · text_to_image=4 · image_edit=4 · ⌈total⌉
Modes
text-to-image, image-to-image
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image · 5 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "grok-imagine-image-2-0",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "1:1"
}
}Reference rule
Reference images: Upload one to five JPEG, PNG, or WebP images, no more than 10 MB each. Signed upload metadata is required for every reference.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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, auto |
Grok Imagine
grok-imagineAvailable via APIPartial: Files API neededImage · xAI's image model with strong creative interpretation and 5 aspect ratios. Standard text requests return 2 images, while quality requests return 4.
Base credits
per_request · standard=4 · standard_output_images=2 · quality=5 · quality_output_images=4 · image_to_image=4 · ⌈total⌉
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",
"nsfw_checker": "false",
"enable_pro": "false"
}
}Reference rule
Reference image: Upload up to 1 image file for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
| nsfw_checker | select | No | false | - | false, true |
| enable_pro | select | No | false | - | false, true |
Flux 2 Pro
flux-2-proAvailable via APIPartial: Files API neededImage · Black Forest Labs' 32B-parameter flagship. Supports text-to-image and image-to-image with up to 8 reference images, 2K resolution, and accurate text rendering — built for product shots and brand visuals.
Base credits
per_image · 1K=5 · 2K=7 · ⌈total⌉
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",
"nsfw_checker": "false"
}
}Reference rule
Reference image: Upload up to 8 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
| nsfw_checker | select | No | false | - | false, true |
Flux 2 Flex
flux-2-flexAvailable via APIPartial: Files API neededImage · Flux 2 family's editing-focused variant. Specializes in structural adjustments and style transfer with up to 8 reference images and 2K resolution — ideal for iterating on existing visuals.
Base credits
per_image · 1K=14 · 2K=24 · ⌈total⌉
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",
"nsfw_checker": "false"
}
}Reference rule
Reference image: Upload up to 8 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
| nsfw_checker | select | No | false | - | false, true |
Flux Kontext Max
flux-kontext-maxAvailable via APIPartial: Files API neededImage · BFL now calls FLUX.1 Kontext [max] previous-generation and recommends FLUX.2 for new projects. Black Forest Labs' enhanced Flux Kontext model for demanding prompt-led generation and image editing. Rivya offers both text-to-image and image-to-image on one model page at a fixed 8 credits per run.
Base credits
per_image · default=8 · ⌈total⌉
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": "Optional watermark text"
}
}Reference rule
Reference image: Upload up to 1 image file for image editing projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-proAvailable via APIPartial: Files API neededImage · BFL now calls FLUX.1 Kontext [pro] previous-generation and recommends FLUX.2 for new projects. Black Forest Labs' lower-cost Flux Kontext model for text-to-image generation and single-image editing. Rivya offers both modes on one model page at a fixed 4 credits per run.
Base credits
per_image · default=4 · ⌈total⌉
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": "Optional watermark text"
}
}Reference rule
Reference image: Upload up to 1 image file for image editing projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 | - | - | - |
Qwen Image 3.0
qwen-image-3Available via APIPartial: Files API neededImage · Qwen Image 3.0 is Rivya's configurable Qwen image model for Chinese or English prompts, reference-led layouts, and reproducible visual tests with 1K or 2K output, prompt expansion, negative prompts, and seed control.
Base credits
per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉
Modes
text-to-image, image-to-image
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
800 characters
Reference media
image · 3 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "qwen-image-3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": "true",
"nsfw_checker": "false",
"negative_prompt": "Optional elements or failure modes to avoid, up to 5,000 characters.",
"seed": 1
}
}Reference rule
Reference images: Upload up to three JPEG, PNG, WebP, BMP, GIF, or TIFF images, no more than 10 MB each.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | Yes | 1K | - | 1K, 2K |
| image_size | select | No | 16:9 | - | 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 |
| output_format | select | No | png | - | png, jpeg |
| prompt_extend | select | No | true | - | true, false |
| nsfw_checker | select | No | false | - | false, true |
| negative_prompt | text | No | - | - | - |
| seed | number | No | 1 | min 0 / max 2147483647 / step 1 | - |
Qwen Image 3.0 Pro
qwen-image-3-proAvailable via APIPartial: Files API neededImage · Qwen Image 3.0 Pro is Rivya's separate Pro-tier Qwen image model for polished campaign key visuals, product scenes, and poster concepts, with Chinese or English prompts, up to three references, and distinct 1K and 2K credit tiers.
Base credits
per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉
Modes
text-to-image, image-to-image
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
800 characters
Reference media
image · 3 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "qwen-image-3-pro",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": "true",
"nsfw_checker": "false",
"negative_prompt": "Optional elements or failure modes to avoid, up to 5,000 characters.",
"seed": 1
}
}Reference rule
Reference images: Upload up to three JPEG, PNG, WebP, BMP, GIF, or TIFF images, no more than 10 MB each.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | Yes | 1K | - | 1K, 2K |
| image_size | select | No | 16:9 | - | 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 |
| output_format | select | No | png | - | png, jpeg |
| prompt_extend | select | No | true | - | true, false |
| nsfw_checker | select | No | false | - | false, true |
| negative_prompt | text | No | - | - | - |
| seed | number | No | 1 | min 0 / max 2147483647 / step 1 | - |
Qwen Image 2.1
qwen2-1-imageThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Qwen Image 2.1 — This model has been announced. Rivya is verifying its inputs, billing, and content before enabling generation. Please choose an available alternative.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Qwen2 Image
qwen2-imageAvailable via APIPartial: Files API neededImage · Alibaba's Qwen2 image model is currently integrated on Rivya as one fixed-price image project. It safely covers text-to-image and image-to-image with the shared aspect-ratio subset both public docs expose, plus PNG/JPEG output, seed reuse, and a simple NSFW switch.
Base credits
per_image · default=5.6 · ⌈total⌉
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: Upload up to 1 image file for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| image_size | select | No | 16:9 | - | 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9 |
| output_format | select | No | png | - | png, jpeg |
| seed | number | No | - | min 0 | - |
| nsfw_checker | select | No | false | - | false, true |
Qwen Image
qwen-imageAvailable via APIPartial: Files API neededImage · Alibaba Qwen family's image model with HD presets (Square, Portrait, Landscape) and PNG/JPEG output. Strong at Chinese-language prompts and culturally nuanced visual generation.
Base credits
per_output_megapixel · default=4 · ⌈total⌉
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: Upload up to 1 image file for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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
midjourneyThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Midjourney is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 4 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
Reference image: Midjourney is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Recraft Remove Background
recraft-remove-backgroundAvailable via APIFiles API neededImage · Recraft's background-removal model on Rivya for isolating the subject from one existing image. Use it when the next step needs a transparent asset, a clean cutout, or a source image without the original background.
Base credits
per_image · default=1 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Source image: Upload exactly 1 JPG, PNG, or WebP image, up to 5 MB and 16 MP; each dimension must be 256–4096 px.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
No extra model parameter is required.
Recraft Crisp Upscale
recraft-crisp-upscaleAvailable via APIFiles API neededImage · Recraft's light image-upscaling model on Rivya for low-cost sharpness and clarity boosts on one approved still. Use it when the chosen image only needs a cheap polish pass before export, not a heavier delivery-grade upscale.
Base credits
per_image · default=0.5 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Source image: Upload exactly 1 JPG, PNG, or WebP image, up to 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
No extra model parameter is required.
Wan 2.7 Image Pro
wan-2-7-image-proAvailable via APIPartial: Files API neededImage · On Rivya, Wan 2.7 Image Pro currently supports text to image and image to image. It can also take up to 9 reference images. Fixed 12 credits per image; one image per request.
Base credits
per_image · default=12 · ⌈total⌉
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: Upload up to 9 image files for image editing projects. JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-imageAvailable via APIPartial: Files API neededImage · On Rivya, Wan 2.7 Image currently supports text to image and image to image. It can also take up to 9 reference images. Fixed 5 credits per image; one image per request.
Base credits
per_image · default=4.8 · ⌈total⌉
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: Upload up to 9 image files for image editing projects. JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-ultraAvailable via APIText input readyImage · Google Imagen4 Ultra is Rivya's premium Imagen text-to-image tier. It is currently integrated as a fixed 12-credit, single-image project with public prompt, negative prompt, aspect ratio, and seed controls.
Base credits
per_image · default=12 · ⌈total⌉
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": "Optional things to avoid",
"seed": "Optional seed value"
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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, auto |
| negative_prompt | text | No | - | - | - |
| seed | text | No | - | - | - |
Google Imagen4
google-imagen4Available via APIText input readyImage · Google Imagen4 is Rivya's standard Imagen text-to-image tier. It is currently integrated as a fixed 8-credit, single-image project with public prompt, negative prompt, aspect ratio, and seed controls.
Base credits
per_request · default=8 · ⌈total⌉
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": "Optional things to avoid",
"seed": "Optional seed value"
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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, auto |
| negative_prompt | text | No | - | - | - |
| seed | text | No | - | - | - |
Google Imagen4 Fast
google-imagen4-fastAvailable via APIText input readyImage · Google Imagen4 Fast is Rivya's lightweight Imagen text-to-image tier. It currently keeps a single-image project, uses fixed 4-credit pricing, and exposes the public prompt, negative prompt, aspect ratio, and seed controls without opening multi-image output.
Base credits
per_request · default=4 · ⌈total⌉
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": "Optional things to avoid",
"seed": 1
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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, auto |
| negative_prompt | text | No | - | - | - |
| seed | number | No | - | - | - |
Topaz Image Upscaler
topaz-image-upscaleAvailable via APIFiles API neededImage · Topaz's delivery-grade image upscaler on Rivya for approved stills that need a real size jump. Use it when the composition is already final and the remaining problem is export resolution, review size, or print readiness.
Base credits
per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Source image: Exactly 1 JPEG, PNG, or WebP image up to 10 MB; output longest edge ≤ 8192 px.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| upscale_factor | select | No | 2 | - | 1, 2, 4 |
Ideogram V3
ideogram-v3Available via APIText input readyImage · Ideogram V3 is Rivya's text-to-image model for text rendering, poster layouts, and design-first image prompts. Current pricing is 4 credits for TURBO, 7 for BALANCED, and 10 for QUALITY.
Base credits
per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉
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": 1,
"negative_prompt": "Optional things to avoid"
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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 | - | - | - |
| negative_prompt | text | No | - | - | - |
Ideogram V3 Reframe
ideogram-v3-reframeThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Image · Ideogram V3 Reframe is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
Reference image: Ideogram V3 Reframe is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Ideogram V3 Remix
ideogram-v3-remixAvailable via APIFiles API neededImage · Ideogram V3 Remix: TURBO 4 / BALANCED 7 / QUALITY 10 credits per image. Choose 1–4 outputs. The total is the per-image rate multiplied by the selected count, rounded up to whole credits.
Base credits
per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference image: Upload exactly 1 image file for this project.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 |
| num_images | select | No | 1 | - | 1, 2, 3, 4 |
| seed | number | No | - | - | - |
| strength | number | No | 0.8 | min 0.01 / max 1 | - |
| negative_prompt | text | No | - | - | - |
Ideogram Character
ideogram-characterAvailable via APIFiles API neededImage · Character-consistency option for turning one approved character image into new scenes, outfits, and formats. TURBO 12 / BALANCED 18 / QUALITY 24 credits per image. Choose 1–4 outputs. The total is the per-image rate multiplied by the selected count, rounded up to whole credits.
Base credits
per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Character reference image: Upload exactly 1 image file for this project.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 |
| num_images | select | No | 1 | - | 1, 2, 3, 4 |
| seed | number | No | - | - | - |
| negative_prompt | text | No | - | - | - |
Seedance 2.5
seedance-2-5Available via APIPartial: Files API neededVideo · Seedance 2.5 is Rivya's larger Seedance workflow for prompt-only video, first- and last-frame guidance, multimodal references, and video-guided transformation. It adds a 1080p tier, output up to 30 seconds, automatic duration, MP4 or MOV output, and substantially larger image, video, and audio reference capacity than Mini.
Base credits
per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=95 · 1080p_without_video=158 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video, video-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
30000 characters
Reference media
image, video, audio · 50 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "seedance-2-5",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"seedance_scene": "text",
"resolution": "720p",
"aspect_ratio": "adaptive",
"duration": 5,
"output_format": "mp4",
"generate_audio": "true",
"return_last_frame": "false",
"web_search": "false",
"nsfw_checker": "true"
}
}Reference rule
Guide frames or high-capacity references: Frames accepts 1 or 2 JPEG, PNG, WebP, BMP, GIF, or TIFF images up to 30 MB each. Reference accepts up to 30 images, 10 MP4/MOV videos up to 95 MB and 2-30 seconds each, and 10 MP3/WAV audio files up to 15 MB and 2-30 seconds each; video and audio totals are each capped at 30 seconds, and all media together is capped at 50 files.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| seedance_scene | select | No | text | - | text, frames, reference |
| resolution | select | No | 720p | - | 480p, 720p, 1080p |
| aspect_ratio | select | No | adaptive | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
| duration | number | No | 5 | min -1 / max 30 / step 1 | - |
| output_format | select | No | mp4 | - | mp4, mov |
| 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 | true | - | false, true |
Seedance 2.0
seedance-2Available via APIText input readyVideo · ByteDance's full Seedance 2.0 video model with explicit support for prompt-only generation, frame-driven animation, and multimodal reference generation. Rivya keeps the documented role split explicit so frame inputs and multimodal references stay mutually exclusive instead of collapsing into one ambiguous upload bucket.
Base credits
per_input_and_output_second · 720p_without_video=41 · 1080p_with_video=62 · 1080p_without_video=102 · 4K_with_video=128 · 4K_without_video=208 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video
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": "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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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 | - | 720p, 1080p, 4K |
| 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-fastAvailable via APIPartial: Files API neededVideo · ByteDance's faster Seedance 2.0 video model with full scene routing for prompt-only generation, frame-driven image animation, and multimodal reference video generation. Rivya keeps the documented scene split explicit so first/last-frame inputs do not collide with reference image, video, and audio roles.
Base credits
per_input_and_output_second · 480p_with_video=6.8 · 480p_without_video=11.7 · 720p_with_video=15 · 720p_without_video=24.8 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image, video, audio · 15 file(s)
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
Multimodal reference: Frames: 1–2 signed images. Reference: up to 9 JPEG/PNG/WebP/BMP/TIFF/GIF images under 30 MB each, 3 MP4/MOV videos of 2–15 seconds under 50 MB each, and 3 MP3/WAV audio clips of 2–15 seconds under 15 MB each. Video and audio each have a separate 15-second total limit.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
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 Mini
seedance-2-miniAvailable via APIPartial: Files API neededVideo · Seedance 2.0 Mini is Rivya's lower-rate multimodal Seedance workflow for prompt-only video, first- or first-and-last-frame animation, and mixed image, video, or audio references. Its 480p and 720p tiers cover 4-to-15-second output while keeping the three input scenes mutually exclusive.
Base credits
per_input_and_output_second · 480p_with_video=2.4 · 480p_without_video=3.8 · 720p_with_video=5 · 720p_without_video=8.2 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image, video, audio · 15 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "seedance-2-mini",
"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",
"web_search": "false",
"nsfw_checker": "true"
}
}Reference rule
Guide frames or multimodal references: Frames accepts one or two JPEG/PNG/WebP/GIF images up to 30 MB each. Reference accepts up to 9 such images, 3 MP4/MOV/MKV videos up to 50 MB and 2-15 seconds each, and 3 MP3/WAV audio files up to 15 MB and 2-15 seconds each; video and audio totals are each capped at 15 seconds.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
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 / step 1 | - |
| generate_audio | select | No | true | - | true, false |
| web_search | select | No | false | - | false, true |
| nsfw_checker | select | No | true | - | false, true |
Seedance 1.5 Pro
seedance-1-5-proAvailable via APIPartial: Files API neededVideo · A Seedance video model for text-to-video and image-to-video with native audio-visual sync. It supports 480p–1080p, 4–12s clips, 6 aspect ratios, dynamic or fixed lens control, optional audio generation, and lip-sync.
Base credits
per_output_second · 480p_without_audio=1.75 · 480p_with_audio=3.5 · 720p_without_audio=3.5 · 720p_with_audio=7 · 1080p_without_audio=7.5 · 1080p_with_audio=15 · ⌈total⌉
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",
"nsfw_checker": "false"
}
}Reference rule
Reference image: Upload up to 2 image files for image projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 480p, 720p, 1080p |
| duration | number | No | 8 | min 4 / max 12 / step 1 | - |
| 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 |
| nsfw_checker | select | No | false | - | false, true |
Seedance 1.0 Pro
seedance-1-0-proThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Seedance 1.0 Pro is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Seedance 1.0 Pro Fast
seedance-1-0-pro-fastThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Seedance 1.0 Pro Fast is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Seedance 1.0 Lite
seedance-1-0-liteThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Seedance 1.0 Lite is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 2 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
HappyHorse 1.1
happyhorse-1-1Available via APIPartial: Files API neededVideo · HappyHorse 1.1 is a flexible AI video model for prompt-only clips, single-image animation, and multi-image reference video at 720p or 1080p, with 3 to 15 seconds of output.
Base credits
per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
4999 characters
Reference media
image · 9 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "happyhorse-1-1",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5
}
}Reference rule
First frame or reference images: Upload one JPEG, PNG, or WebP image for first-frame animation, or 2 to 9 images for reference-led video. Each file can be up to 20 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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, 4:5, 5:4, 9:21, 21:9 |
| duration | number | No | 5 | min 3 / max 15 / step 1 | - |
HappyHorse 1.0
happyhorse-1-0Available via APIPartial: Files API neededVideo · HappyHorse 1.0 on Rivya supports text-to-video, single-image animation, and multi-image reference video from one model page.
Base credits
per_output_second · 720p=28 · 1080p=48 · ⌈total⌉
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 · 9 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,
"seed": 0
}
}Reference rule
Reference media: Use exactly 1 image for image-to-video or 2 to 9 images for reference video. Images must be JPEG, PNG, or WebP and no larger than 10 MB; single-image mode requires both dimensions to be at least 300 px, while reference mode requires the shortest side to be at least 400 px.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 | - |
| seed | number | No | 0 | min 0 / max 2147483647 | - |
Wan 3.0 Video
wan-3-0-videoAvailable via APIPartial: Files API neededVideo · Wan 3.0 Video combines Standard and Prime tiers with text-to-video, first/last-frame guidance, and signed multimodal references. It supports 480P, 720P, or 1080P output, explicit 2-30-second clips or intelligent duration, and reference bundles containing images, video, and audio.
Base credits
per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video, video-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image, video, audio · 20 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "wan-3-0-video",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"seedance_scene": "text",
"variant": "standard",
"resolution": "1080P",
"aspect_ratio": "adaptive",
"duration": 5,
"audio": "true",
"seed": 0
}
}Reference rule
Guide frames or signed multimodal references: Frames accepts a required first image and one optional last image. Reference accepts up to 10 JPEG, non-transparent PNG, WebP, or BMP images at 20 MB each, 5 MP4/MOV videos at 95 MB and 1-15 seconds each, and 5 MP3/WAV audio clips at 15 MB and 1-15 seconds each; video and audio totals are each capped at 15 seconds.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| seedance_scene | select | No | text | - | text, frames, reference |
| variant | select | No | standard | - | standard, prime |
| resolution | select | No | 1080P | - | 480P, 720P, 1080P |
| aspect_ratio | select | No | adaptive | - | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 |
| duration | number | No | 5 | min -1 / max 30 / step 1 | - |
| audio | select | No | true | - | true, false |
| seed | number | No | - | min 0 / max 2147483647 / step 1 | - |
Wan 2.7 Video
wan-2-7-videoAvailable via APIPartial: Files API neededVideo · Wan 2.7 Video: 720p = 16 credits/s; 1080p = 24 credits/s; text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s; nsfw_checker=true.
Base credits
per_output_second · 720p=16 · 1080p=24 · ⌈total⌉
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": "negative_prompt ≤ 500",
"prompt_extend": "true",
"watermark": "false",
"audio_setting": "auto",
"seed": 0
}
}Reference rule
Reference media: Reference media: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 720p, 1080p |
| duration | number | No | 5 | min 0 / max 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-6Available via APIPartial: Files API neededVideo · Wan 2.6 supports text-to-video with no media, image-to-video with exactly one image, and video editing with one to three videos; images and videos cannot be mixed. Text and image inputs support 5, 10, or 15 seconds; video input supports 5 or 10 seconds only.
Base credits
per_video · 720p_5=70 · 720p_10=140 · 720p_15=210 · 1080p_5=104.5 · 1080p_10=209.5 · 1080p_15=315 · ⌈total⌉
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 · 3 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": "1080p",
"duration": "5",
"multi_shots": "false",
"nsfw_checker": "true"
}
}Reference rule
Reference media: Use exactly 1 JPG/PNG/WebP image (at least 256×256, up to 10 MB) or 1–3 MP4/MOV videos (up to 10 MB per file).
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 1080p | - | 720p, 1080p |
| duration | select | No | 5 | - | 5, 10, 15 |
| multi_shots | select | No | false | - | false, true |
| nsfw_checker | select | No | true | - | false, true |
Wan 2.6 Flash
wan-2-6-flashThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Wan 2.6 Flash / Temporarily unavailable — This is a temporary pricing and integration-safety hold, not a Coming Soon announcement. The page remains indexable, but generation and callable pricing stay closed until the complete price contract is stable.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Wan 2.5 Video
wan-2-5-videoAvailable via APIPartial: Files API neededVideo · Wan 2.5 is now exposed on Rivya as one shared entry for text-to-video and image-to-video. Current pricing is `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100`, and `1080p_10 = 200` credits.
Base credits
per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉
Modes
text-to-video, image-to-video
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": "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": "Optional exclusions or failure modes to avoid."
}
}Reference rule
Reference image: Upload up to 1 image file for image-to-video mode.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 | - | - | - |
Wan 2.2 A14B Turbo
wan-2-2-a14b-turboAvailable via APIPartial: Files API neededVideo · Text and image input support 480p or 720p (40 or 80 credits for 5 seconds). Image plus audio also supports 580p; its 480p / 580p / 720p rates are 12 / 18 / 24 credits per output second.
Base credits
per_output_second · 480p_standard_5s=40 · 580p_standard_5s=60 · 720p_standard_5s=80 · 480p_speech=12 · 580p_speech=18 · 720p_speech=24 · ⌈total⌉
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": "Optional exclusions or failure modes to avoid.",
"num_inference_steps": 27,
"guidance_scale": 3.5,
"shift": 5,
"enable_safety_checker": "true"
}
}Reference rule
Reference media: Upload up to 2 assets. Text mode needs none, image-to-video uses 1 image, and the image-plus-audio-driven path uses 1 image plus 1 audio clip.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 4 | - |
| 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-replaceAvailable via APIFiles API neededVideo · Choose Wan Animate Replace when the source clip already has the right motion and framing, and only the visible subject should change. Go back to prompt-led generation when the whole shot needs to be reimagined, or use a broader editing project when more than a subject swap is on the table.
Base credits
per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉
Modes
video-to-video
API input
Files API needed
Inputs
file
Prompt limit
-
Reference media
video, image · 2 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
video: video, image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 480p | - | 480p, 580p, 720p |
Wan Animate 2
wan-animate-2This model is planned for Public API but is not callable yet.This model is planned for Public API but is not callable yet.Video · Wan Animate 2 is a Coming Soon Video to Video listing. Its public character-animation positioning does not provide a callable contract or price for Rivya.
Base credits
This model is planned for Public API but is not callable yet.
Modes
API input
This model is planned for Public API but is not callable yet.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is planned for Public API but is not callable yet.
Parameters
No extra model parameter is required.
MiniMax H3
minimax-h3Available via APIPartial: Files API neededVideo · MiniMax H3 is Rivya's 768P or 2K video model for prompt-only generation, first- and last-frame animation, and multimodal reference work. Its reference path can combine images, MP4 or MOV clips, and MP3 or WAV audio, while its credit formula separately accounts for verified input-video time and images beyond the first five.
Base credits
per_input_and_output_second · 768P=8 · 2K=13 · additional_image_after_five=4 · ⌈total⌉
Modes
text-to-video, image-to-video, reference-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
7000 characters
Reference media
image, video, audio · 15 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "minimax-h3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"seedance_scene": "text",
"resolution": "2K",
"aspect_ratio": "16:9",
"minimax_single_frame_role": "first",
"duration": 6
}
}Reference rule
Guide frames or multimodal references: Frames accepts 1 or 2 JPEG, PNG, or WebP images up to 30 MB each. Reference accepts up to 9 such images, 3 MP4/MOV videos up to 50 MB and 2-15 seconds each, and 3 MP3/WAV audio files up to 15 MB and 2-15 seconds each; video and audio totals are each capped at 15 seconds, all media is capped at 15 files, and audio cannot be used alone.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| seedance_scene | select | No | text | - | text, frames, reference |
| resolution | select | No | 2K | - | 768P, 2K |
| aspect_ratio | select | No | 16:9 | - | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| minimax_single_frame_role | select | No | first | - | first, last |
| duration | number | No | 6 | min 4 / max 15 / step 1 | - |
Hailuo 2.3
hailuo-2-3Available via APIFiles API neededVideo · MiniMax's image-to-video model with Standard/Pro quality tiers, 768P/1080P resolution, and 6s or 10s clips. Known for smoother motion and natural transitions from still images.
Base credits
per_video · standard_768P_6=25 · standard_768P_10=40 · standard_1080P_6=40 · pro_768P_6=40 · pro_768P_10=80 · pro_1080P_6=70 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference image: Upload up to 1 image file for image projects. JPG / PNG / WebP · ≤ 10 MB · 1 image.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 |
| nsfw_checker | select | No | true | - | false, true |
Hailuo Pro
hailuo-proAvailable via APIPartial: Files API neededVideo · MiniMax's current Hailuo Pro video model is connected here as one fixed Pro-tier model for both text-to-video and image-to-video. Image mode accepts 1 or 2 reference images, with the second image used as the last frame, and each run currently costs 57 credits. Fixed output: 1080P · 6s · 57 credits.
Base credits
per_video · 1080P_6=57 · ⌈total⌉
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": "true",
"nsfw_checker": "true"
}
}Reference rule
Reference images: Image mode accepts up to 2 images, and the second image becomes the last frame. · JPG / PNG / WebP · ≤ 10 MB
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| prompt_optimizer | select | No | true | - | false, true |
| nsfw_checker | select | No | true | - | false, true |
Hailuo Standard
hailuo-standardAvailable via APIPartial: Files API neededVideo · MiniMax's older Hailuo Standard video model, unified here as one model for both text-to-video and image-to-video. Image mode accepts 1 or 2 reference images, with the second image used as the last frame, and the currently verified public pricing tiers range from 12 to 50 credits.
Base credits
per_video · text_6=30 · text_10=50 · image_512P_6=12 · image_512P_10=20 · image_768P_10=50 · ⌈total⌉
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": "768P",
"prompt_optimizer": "true"
}
}Reference rule
Reference images: Image mode accepts up to 2 images, and the second image becomes the last frame. JPG / PNG / WebP · ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| duration | select | No | 6 | - | 6, 10 |
| resolution | select | No | 768P | - | 512P, 768P |
| prompt_optimizer | select | No | true | - | false, true |
Kling 4.0
kling-4-0This model is planned for Public API but is not callable yet.This model is planned for Public API but is not callable yet.Video · Kling 4.0 — Coming Soon. Kling 4.0 is a Coming Soon discovery page only; choose an available alternative for current work.
Base credits
This model is planned for Public API but is not callable yet.
Modes
API input
This model is planned for Public API but is not callable yet.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is planned for Public API but is not callable yet.
Parameters
No extra model parameter is required.
Kling 4.0 Flash
kling-4-0-flashThis model is planned for Public API but is not callable yet.This model is planned for Public API but is not callable yet.Video · Kling 4.0 Flash — Coming Soon. Kling 4.0 Flash is a Coming Soon discovery page only; choose an available alternative for current work.
Base credits
This model is planned for Public API but is not callable yet.
Modes
API input
This model is planned for Public API but is not callable yet.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is planned for Public API but is not callable yet.
Parameters
No extra model parameter is required.
Kling 3.0
kling-3-0Available via APIPartial: Files API neededVideo · Kuaishou's premium video model for text-to-video and image-to-video, with Standard (720P), Pro (1080P), and 4K tiers, single or multi-shot structure, 3–15s duration, optional audio generation, and up to 2 reference images.
Base credits
per_output_second · 720p_without_audio=14 · 720p_with_audio=20 · 1080p_without_audio=18 · 1080p_with_audio=27 · 4K=67 · ⌈total⌉
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-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: Upload up to 2 image files total for image-to-video projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| mode | select | No | pro | - | std, pro, 4k |
| 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-controlAvailable via APIFiles API neededVideo · Exact 1-image + 1-motion-video project keeps identity and movement roles clear Standard (720P): 20 × verified motion-video seconds; Pro (1080P): 27 × seconds
Base credits
per_output_second · 720p=20 · 1080p=27 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference image + motion video: Exact 1-image + 1-motion-video project keeps identity and movement roles clear Standard (720P): 20 × verified motion-video seconds; Pro (1080P): 27 × seconds
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| mode | select | No | 720p | - | 720p, 1080p |
| character_orientation | select | No | video | - | video, image |
Kling 3.0 Turbo
kling-3-turboAvailable via APIPartial: Files API neededVideo · Kling 3.0 Turbo is Rivya's focused Kling video model for prompt-only generation or animation from one still image. Its two paths share 720p and 1080p output with integer durations from 3 to 15 seconds, while aspect-ratio control stays exclusive to text-to-video.
Base credits
per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉
Modes
text-to-video, image-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
2500 characters
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "kling-3-turbo",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}
}Reference rule
Optional starting image: For image-to-video, upload exactly one JPEG or PNG image up to 10 MB. Text-to-video uses no uploaded media.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 720p, 1080p |
| duration | number | No | 5 | min 3 / max 15 / step 1 | - |
| aspect_ratio | select | No | 16:9 | - | 1:1, 9:16, 16:9 |
Kling O3
kling-o3Available via APIPartial: Files API neededVideo · Verified single-shot generation is available from text, one first frame, or a first-and-last-frame pair.
Base credits
per_output_second · 720p_without_audio=14 · 720p_with_audio=18 · 1080p_without_audio=18 · 1080p_with_audio=23 · 4k_without_audio=67 · 4k_with_audio=67 · ⌈total⌉
Modes
text-to-video, image-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
3072 characters
Reference media
image · 2 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "kling-o3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "720p",
"duration": "5",
"audio": "false",
"aspect_ratio": "16:9"
}
}Reference rule
Reference media: Upload up to 2 image files total for image-to-video projects.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 720p, 1080p, 4k |
| duration | select | No | 5 | - | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
| audio | select | No | false | - | false, true |
| aspect_ratio | select | No | 16:9 | - | 16:9, 9:16, 1:1 |
Kling 2.6
kling-2-6Available via APIPartial: Files API neededVideo · Kuaishou's video model with optional audio generation, 5s/10s clips, and 3 aspect ratios. Strong at human motion and expressive character animation with natural physics.
Base credits
per_video · 5s_without_audio=55 · 5s_with_audio=110 · 10s_without_audio=110 · 10s_with_audio=220 · ⌈total⌉
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: Upload up to 1 image file for image projects. JPEG/PNG ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-controlAvailable via APIFiles API neededVideo · Dedicated motion-transfer project for driving one subject from one reference image plus one motion video. Use it when you want a cheaper Kling motion-control pass and can live without the extra scene controls in Kling 3.0 motion-control.
Base credits
per_output_second · 720p=11 · 1080p=18 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference image + motion video: Upload exactly 1 character image and 1 motion clip. Both should clearly show the head, shoulders, and torso.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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-proAvailable via APIPartial: Files API neededVideo · Kuaishou's Kling V2.5 Turbo Pro video model, now supporting both text-to-video and image-to-video. Public pricing evidence clearly covers both text and image tiers at 5 seconds and 10 seconds, so Rivya maps it directly to 42 / 84 credits.
Base credits
per_video · 5s=42 · 10s=84 · ⌈total⌉
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 what the video should avoid",
"cfg_scale": 0.5
}
}Reference rule
Reference images: Optionally upload up to 2 images to switch into image-to-video mode; the second image maps to the tail frame. JPEG/PNG ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 / step 0.1 | - |
Kling V2.1 Master
kling-v2-1-masterAvailable via APIPartial: Files API neededVideo · Kuaishou's older Kling V2.1 Master video model now supports both text-to-video and image-to-video on Rivya. Current pricing is 160 credits for 5 seconds and 320 credits for 10 seconds.
Base credits
per_video · 5s=160 · 10s=320 · ⌈total⌉
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 what the video should avoid",
"cfg_scale": 0.5
}
}Reference rule
Reference image: Optionally upload one image to switch into image-to-video mode; leave it empty to stay in text mode. JPEG/PNG ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 / step 0.1 | - |
Kling V2.1 Pro
kling-v2-1-proAvailable via APIFiles API neededVideo · Kuaishou's older Kling V2.1 Pro image-to-video model supports a first frame plus an optional tail frame image. Current pricing is 50 credits for 5 seconds and 100 credits for 10 seconds.
Base credits
per_video · 5s=50 · 10s=100 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference images: Image mode accepts up to 2 image files, and the second image maps to the tail frame. JPEG/PNG ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 / step 0.1 | - |
Kling V2.1 Standard
kling-v2-1-standardAvailable via APIFiles API neededVideo · Kuaishou's older Kling V2.1 Standard image-to-video model. Current pricing is 25 credits for 5 seconds and 50 credits for 10 seconds.
Base credits
per_video · 5s=25 · 10s=50 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Reference image: Image mode accepts up to 1 image file as the first frame. JPEG/PNG ≤ 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 / step 0.1 | - |
Kling AI Avatar Pro
kling-ai-avatar-proAvailable via APIFiles API neededVideo · Kuaishou's Kling AI Avatar Pro higher-quality talking-avatar model, using one portrait image plus one audio clip to generate lip-synced avatar video. Rivya charges 16 credits per second of verified audio, up to 300 seconds, with the total rounded up to a whole credit.
Base credits
per_input_second · default=16 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Portrait image and audio: Upload one portrait image and one audio clip together.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
No extra model parameter is required.
Kling AI Avatar Standard
kling-ai-avatar-standardAvailable via APIFiles API neededVideo · Kuaishou's Kling AI Avatar Standard talking-avatar model, using one portrait image plus one audio clip to generate lip-synced avatar video. Rivya charges 8 credits per second of verified audio, up to 300 seconds, with the total rounded up to a whole credit.
Base credits
per_input_second · default=8 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Portrait image and audio: Upload one portrait image and one audio clip together.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
No extra model parameter is required.
Infinitalk
infinitalkAvailable via APIFiles API neededVideo · Infinitalk is a portrait-plus-audio talking-video model. Current pricing is metered by resolution and audio duration: 480p = 3 credits per second and 720p = 12 credits per second.
Base credits
per_input_second · 480p=3 · 720p=12 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Portrait image and audio: Upload one portrait image and one audio clip together.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 480p | - | 480p, 720p |
| seed | number | No | - | min 10000 / max 1000000 | - |
Runway
runwayAvailable via APIPartial: Files API neededVideo · Runway is a standalone video model that supports both text-to-video and image-to-video. Public pricing evidence currently confirms only 3 generation tiers, so Rivya keeps it on the verified set: `720p_5 = 12`, `720p_10 = 30`, and `1080p_5 = 30`.
Base credits
per_video · 720p_5s=12 · 720p_10s=30 · 1080p_5s=30 · ⌈total⌉
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": "Leave empty to disable watermark"
}
}Reference rule
Reference image: Optionally upload one image to switch into image-to-video mode; leave it empty to stay in text mode.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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-alephAvailable via APIFiles API neededVideo · Source-video transformation project for reworking an existing clip into a new visual result. Use Aleph when the motion comes from your input footage and the creative direction comes from your prompt, with a fixed 90-credit price.
Base credits
per_video · default=90 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Input media: Upload the source clip you want Aleph to transform. Add one optional still image only when you need extra style or subject guidance.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. 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 | - | - | - |
Luma Modify Video
luma-modify-videoThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Luma Modify Video is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
video · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
video: video
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Grok Imagine Video 1.5 Preview
grok-imagine-videoAvailable via APIPartial: Files API neededVideo · Grok Imagine Video 1.5 Preview supports 1–15 seconds, 480p or 720p, up to 7 reference images, and prompts up to 4096 characters.
Base credits
per_output_second · 480p=2.4 · 720p=4.5 · ⌈total⌉
Modes
text-to-video, image-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
4096 characters
Reference media
image · 7 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": {
"duration": 8,
"resolution": "480p",
"aspect_ratio": "auto",
"nsfw_checker": "true"
}
}Reference rule
Reference image: Up to 7 JPEG, PNG, or WebP images, each no larger than 20MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| duration | number | No | 8 | min 1 / max 15 / step 1 | - |
| resolution | select | No | 480p | - | 480p, 720p |
| aspect_ratio | select | No | auto | - | auto, 1:1, 16:9, 9:16, 3:2, 2:3 |
| nsfw_checker | select | No | true | - | true, false |
Sora 2 Pro
sora-2-proThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Sora 2 Pro is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Sora 2
sora-2This request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Sora 2 is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
image · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
image: image
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Sora Watermark Remover
sora-watermark-removerThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · Sora Watermark Remover is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Topaz Video Upscaler
topaz-video-upscaleAvailable via APIFiles API neededVideo · One uploaded video, no prompt, with a 1x, 2x, or 4x upscale factor; 2x is the default.
Base credits
per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉
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
No runnable Public API example is shown for this model.
Reference rule
Source video: Rivya accepts one MP4, MOV, or MKV file up to 10MB; the upstream interface allows 50MB, so Rivya uses the stricter limit.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| upscale_factor | select | No | 2 | - | 1, 2, 4 |
Veo3.1 Quality
veo3-1-qualityAvailable via APIPartial: Files API neededVideo · 720p costs 225 credits, 1080p costs 233 (232.5 rounded up), and 4K costs 285; Extend costs 225, while eligible 1080p/4K result actions cost 8/60. Audio is experimental and not guaranteed; review every result manually before delivery. Resolution actions require an owned successful 720p base task or Extend result; a direct 1080p/4K result cannot request another resolution action.
Base credits
per_video · generate_720p=225 · generate_1080p=232.5 · generate_4K=285 · extend_quality=225 · get_1080p=7.5 · get_4K=60 · ⌈total⌉
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": {
"generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
"aspectRatio": "16:9",
"resolution": "720p",
"duration": "8",
"watermark": "Optional watermark text",
"enableTranslation": "true"
}
}Reference rule
Reference image: Use 1 image as a starting frame or 2 images as start and end frames. JPEG / PNG · 1–2 · 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
| aspectRatio | select | No | 16:9 | - | 16:9, 9:16, Auto |
| resolution | select | No | 720p | - | 720p, 1080p, 4k |
| duration | select | No | 8 | - | 4, 6, 8 |
| watermark | text | No | - | - | - |
| enableTranslation | select | No | true | - | true, false |
Veo3.1 Fast
veo3-1-fastAvailable via APIPartial: Files API neededVideo · Supports text, first/last-frame, and one-to-three-reference-image generation with direct 720p/1080p/4K and 4/6/8-second controls. Audio is experimental and not guaranteed; review every result manually before delivery.
Base credits
per_video · generate_720p=30 · generate_1080p=37.5 · generate_4K=90 · extend_fast=30 · get_1080p=7.5 · get_4K=60 · ⌈total⌉
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": "TEXT_2_VIDEO",
"aspectRatio": "16:9",
"resolution": "720p",
"duration": "8",
"watermark": "Optional watermark text",
"enableTranslation": "true"
}
}Reference rule
Reference image: Reference mode accepts 1–3 verified JPEG or PNG images up to 10 MB each, only 16:9 or 9:16, and requires an 8-second duration.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| generationType | select | No | TEXT_2_VIDEO | - | TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO |
| aspectRatio | select | No | 16:9 | - | 16:9, 9:16, Auto |
| resolution | select | No | 720p | - | 720p, 1080p, 4k |
| duration | select | No | 8 | - | 4, 6, 8 |
| watermark | text | No | - | - | - |
| enableTranslation | select | No | true | - | true, false |
Veo3.1 Lite
veo3-1-liteAvailable via APIPartial: Files API neededVideo · Supports text, first/last-frame, and one-to-three-reference-image generation with direct 720p/1080p/4K and 4/6/8-second controls. Audio is experimental and not guaranteed; review every result manually before delivery.
Base credits
per_video · generate_720p=15 · generate_1080p=22.5 · generate_4K=75 · extend_lite=15 · get_1080p=7.5 · get_4K=60 · ⌈total⌉
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-lite",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
"aspectRatio": "16:9",
"resolution": "720p",
"duration": "8",
"watermark": "Optional watermark text",
"enableTranslation": "true"
}
}Reference rule
Reference image: Reference mode accepts 1–3 verified JPEG or PNG images up to 10 MB each, only 16:9 or 9:16, and requires an 8-second duration.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need 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 |
| resolution | select | No | 720p | - | 720p, 1080p, 4k |
| duration | select | No | 8 | - | 4, 6, 8 |
| watermark | text | No | - | - | - |
| enableTranslation | select | No | true | - | true, false |
Flux 3
flux-3This model is planned for Public API but is not callable yet.This model is planned for Public API but is not callable yet.Video · Flux 3 appears in the coming-soon video catalog with Text to Video and Image to Video labels. Rivya keeps this page as a status reference, not as a promise of controls or runtime behavior.
Base credits
This model is planned for Public API but is not callable yet.
Modes
API input
This model is planned for Public API but is not callable yet.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is planned for Public API but is not callable yet.
Parameters
No extra model parameter is required.
Gemini Omni 1.1 Flash
gemini-omni-flash-1-1Available via APIPartial: Files API neededVideo · Create video from text, reference images, or a source video. Choose 16:9 or 9:16 and 4, 6, 8, or 10 seconds; with video input, the model determines output length.
Base credits
per_video · 4=45 · 6=60 · 8=75 · 10=90 · 4k_4=105 · 4k_6=120 · 4k_8=135 · 4k_10=150 · withVideo=120 · withVideo4k=180 · ⌈total⌉
Modes
text-to-video, image-to-video, video-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image, video · 7 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "gemini-omni-flash-1-1",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"reference_mode": "reference",
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0
}
}Reference rule
Reference assets: Use up to seven images at 20 MB each, or one video up to 95 MB and 30 seconds with up to five images. Select a video segment no longer than 10 seconds. Audio and character asset IDs are not supported. Frames mode accepts one start image or a start/end pair, without other references.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| reference_mode | select | No | reference | - | reference, frames |
| resolution | select | No | 720p | - | 360p, 720p, 1080p, 4k |
| duration | select | No | 4 | - | 4, 6, 8, 10 |
| aspect_ratio | select | No | 16:9 | - | 16:9, 9:16 |
| seed | number | No | - | min 0 / max 2147483647 | - |
| video_start | number | No | - | min 0 / max 30 | - |
| video_ends | number | No | - | min 0 / max 30 | - |
Gemini Omni Video
gemini-omni-videoAvailable via APIPartial: Files API neededVideo · Create video from text, reference images, or a source video. Choose 16:9 or 9:16 and 4, 6, 8, or 10 seconds; with video input, the model determines output length.
Base credits
per_video · 4=45 · 6=60 · 8=75 · 10=90 · 4k_4=105 · 4k_6=120 · 4k_8=135 · 4k_10=150 · withVideo=120 · withVideo4k=180 · ⌈total⌉
Modes
text-to-video, image-to-video, video-to-video
API input
Partial: Files API needed
Inputs
text, file
Prompt limit
20000 characters
Reference media
image, video · 7 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
{
"model": "gemini-omni-video",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0
}
}Reference rule
Reference assets: Use up to seven images at 20 MB each, or one video up to 95 MB and 30 seconds with up to five images. Select a video segment no longer than 10 seconds. Audio and character asset IDs are not supported.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Prompt or URL modes may be callable now. Reference-media modes still need Files API upload support. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 720p, 1080p, 4k |
| duration | select | No | 4 | - | 4, 6, 8, 10 |
| aspect_ratio | select | No | 16:9 | - | 16:9, 9:16 |
| seed | number | No | - | min 0 / max 2147483647 | - |
| video_start | number | No | - | min 0 / max 30 | - |
| video_ends | number | No | - | min 0 / max 30 | - |
OmniHuman 1.5
omnihuman-1-5Available via APIFiles API neededVideo · OmniHuman 1.5 turns exactly one portrait image and one audio clip into an audio-driven character video at 720p or 1080p, with credits based on verified audio duration.
Base credits
per_input_second · default=27 · ⌈total⌉
Modes
image-audio-to-video
API input
Files API needed
Inputs
file
Prompt limit
300 characters
Reference media
image, audio · 2 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
Portrait image and audio: Upload exactly one JPEG, PNG, or WebP portrait up to 10 MB and one MP3, M4A, WAV, AAC, or OGG audio file up to 10 MB and under 60 seconds.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| output_resolution | select | No | 1080 | - | 720, 1080 |
| pe_fast_mode | select | No | false | - | false, true |
| seed | number | No | -1 | - | - |
Volcengine Video Lip Sync
volcengine-video-lip-syncAvailable via APIFiles API neededVideo · Volcengine Video Lip Sync replaces the spoken performance in one existing video with one target vocal track, using Lite or Basic processing and duration-based credits. The output is MP4 at 25 FPS, and its duration follows the target audio.
Base credits
per_input_second · default=8 · ⌈total⌉
Modes
video-audio-to-video
API input
Files API needed
Inputs
file
Prompt limit
-
Reference media
video, audio · 2 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
Source video and target audio: Upload exactly one MP4 or MOV video up to 95 MB and one MP3, M4A, WAV, AAC, or OGG vocal track up to 10 MB.
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
File-based modes need /api/v1/files before they can be shown as complete API-ready examples. Files API
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| mode | select | Yes | lite | - | lite, basic |
| separate_vocal | select | No | false | - | false, true |
| open_scenedet | select | No | false | - | false, true |
| align_audio | select | No | true | - | true, false |
| align_audio_reverse | select | No | false | - | false, true |
| templ_start_seconds | number | No | 0 | min 0 | - |
PixVerse V6
pixverse-v6This request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Video · PixVerse V6 — Temporarily unavailable. This is a temporary pricing and integration-safety hold, not a Coming Soon announcement. The page remains indexable, but generation and callable pricing stay closed until the complete price contract is stable.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Suno Music
suno-musicThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · Suno Music is temporarily unavailable because new generation requirements need additional inputs that the current form does not support. Existing works can still be viewed and downloaded; new tasks remain disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Suno Sounds
suno-soundsAvailable via APIText input readyAudio · Create ambience, loops and short sound sketches from a text description with Suno Sounds.
Base credits
per_request · generate_sounds=2.5 · separate_vocal=10 · ⌈total⌉
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": "V6",
"soundLoop": "false",
"soundTempo": 1,
"soundKey": "Any"
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Parameters
| key | Type | Required | Default | Range | Options |
|---|---|---|---|---|---|
| model | select | No | V6 | - | V6, V6_MINI, V6_WILD |
| 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-lyricsAvailable via APIText input readyAudio · Turn a theme, mood or story into lyrics with Suno Lyrics. Each generation costs 1 credit.
Base credits
per_request · generate_lyrics=0.4 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Parameters
No extra model parameter is required.
ElevenLabs Dialogue V3
elevenlabs-dialogue-v3Available via APIText input readyAudio · ElevenLabs' multi-speaker dialogue model on Rivya. It is built for role-based speech generation, with individual voice assignments, stability controls, and dialogue-ready pacing for podcasts, interviews, and character scenes.
Base credits
per_1000_characters · dialogue_text=14 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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-5Available via APIText input readyAudio · ElevenLabs' fast text-to-speech model on Rivya. With low-latency voice generation and adjustable stability, similarity, style, and speed, it is built for rapid voiceover drafts and interactive TTS projects.
Base credits
per_1000_characters · text=6 · ⌈total⌉
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": "Optional context before this line",
"next_text": "Optional context after this line",
"language_code": "Optional locale code like en or zh"
}
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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-v2Available via APIText input readyAudio · ElevenLabs' multilingual text-to-speech model on Rivya, supporting about 30 languages with auto-detection. It is the stronger option for localization, cross-language delivery, and more natural multilingual voiceovers.
Base credits
per_1000_characters · text=12 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
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 | - | - | - |
ElevenLabs Sound Effect V2
elevenlabs-sound-effect-v2This request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · ElevenLabs Sound Effect V2 is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
ElevenLabs Audio Isolation
elevenlabs-audio-isolationThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · ElevenLabs Audio Isolation is currently unavailable on Rivya. This page is a historical capability reference only; it offers no generation, creates no task, and deducts no credits.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
audio · 1 file(s)
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
audio: audio
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.8 Flash TTS
gemini-3-8-flash-ttsThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · Gemini 3.8 Flash TTS is listed for text-to-speech and dialogue-to-speech work, but it is temporarily unavailable on Rivya because a run's maximum audio-token cost cannot yet be bounded safely before it starts.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.8 Flash-Lite TTS
gemini-3-8-flash-lite-ttsThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · Gemini 3.8 Flash-Lite TTS is listed for text-to-speech and dialogue-to-speech work, but it is temporarily unavailable on Rivya because a run's maximum audio-token cost cannot yet be bounded safely before it starts.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.1 Flash TTS
gemini-3-1-flash-ttsThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · Gemini 3.1 Flash TTS is listed for text-to-speech and dialogue-to-speech work, but it is temporarily unavailable on Rivya because a run's maximum audio-token cost cannot yet be bounded safely before it starts.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 2.5 Pro TTS
gemini-2-5-pro-ttsThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Audio · Gemini 2.5 Pro TTS has a public text-to-speech and dialogue-to-speech listing, while Rivya keeps generation temporarily unavailable until every allowed script can be covered by a safe maximum credit reservation.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT 6.1 Sol
gpt-6-1-sol-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-6 Astra
gpt-6-astra-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT 6 Sol
gpt-6-sol-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT 6 Luna
gpt-6-luna-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.6 Luna
gpt-5-6-luna-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.6 Luna is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.6 Terra
gpt-5-6-terra-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.6 Terra is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.6 Sol
gpt-5-6-sol-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.6 Sol is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.5
gpt-5-5-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.5 is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.4
gpt-5-4-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.4 is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.4 Codex
gpt-5.4-codex-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.4 Codex is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.3 Codex
gpt-5-3-codex-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.3 Codex is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.2
gpt-5-2-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.2 is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.2 Codex
gpt-5-2-codex-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.2 Codex is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5.1 Codex
gpt-5-1-codex-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5.1 Codex is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
GPT-5 Codex
gpt-5-codex-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · GPT-5 Codex is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.8 Flash
gemini-3-8-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.7 Flash
gemini-3-7-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3.7 Flash is listed on Rivya with an integration-safety hold. Its indexable status page tracks the confirmed chat contract while execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.6 Flash
gemini-3-6-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3.6 Flash is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.5 Flash
gemini-3-5-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3.5 Flash is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3.1 Pro
gemini-3-1-pro-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3.1 Pro is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3 Pro
gemini-3-pro-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3 Pro is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 3 Flash
gemini-3-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 3 Flash is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 2.5 Pro
gemini-2-5-pro-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 2.5 Pro is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Gemini 2.5 Flash
gemini-2-5-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Gemini 2.5 Flash is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Claude Opus 5.5
claude-opus-5-5-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Claude Opus 5.5 — This model has been announced. Rivya is verifying its inputs, billing, and content before enabling generation. Please choose an available alternative.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Claude Sonnet 5.5
claude-sonnet-5-5-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Claude Sonnet 5.5 — This model has been announced. Rivya is verifying its inputs, billing, and content before enabling generation. Please choose an available alternative.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Claude Fable 5.1
claude-fable-5-1-chatThis model is planned for Public API but is not callable yet.This model is planned for Public API but is not callable yet.Chat · Claude Fable 5.1 is a coming-soon Chat model. Rivya uses this page to track availability and direct visitors to available chat models without claiming unpublished context, tools, or response behavior.
Base credits
This model is planned for Public API but is not callable yet.
Modes
API input
This model is planned for Public API but is not callable yet.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is planned for Public API but is not callable yet.
Parameters
No extra model parameter is required.
Claude Fable 5
claude-fable-5-chatAvailable via APIText input readyChat · A text-first Claude chat model on Rivya for narrative reframing, audience-aware drafts, and structured editorial work.
Base credits
per_million_tokens · input=800 · output=4000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
Modes
claude-messages
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-fable-5-chat",
"prompt": "A clean editorial product image on a soft studio background"
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Sonnet 5
claude-sonnet-5-chatAvailable via APIText input readyChat · A text-first Claude chat model on Rivya for implementation briefs, requirements review, and concise technical planning.
Base credits
per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
Modes
claude-messages
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-5-chat",
"prompt": "A clean editorial product image on a soft studio background"
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Opus 5
claude-opus-5-chatAvailable via APIText input readyChat · A text-first Claude chat model on Rivya for board-level risk framing, scenario comparison, and decision documentation.
Base credits
per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
Modes
claude-messages
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-5-chat",
"prompt": "A clean editorial product image on a soft studio background"
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Opus 4.8
claude-opus-4-8-chatAvailable via APIText input readyChat · A text-first Claude chat model on Rivya for reviewing dense source packets and producing careful, structured decisions.
Base credits
per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
Modes
claude-messages
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-8-chat",
"prompt": "A clean editorial product image on a soft studio background"
}Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Opus 4.7
claude-opus-4-7-chatAvailable via APIText input readyChat · Anthropic's flagship Claude chat model on Rivya for deep reasoning, careful synthesis, executive writing, and high-impact text work.
Base credits
per_million_tokens · input=285 · output=1430 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Opus 4.6
claude-opus-4-6-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Claude Opus 4.6 is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Claude Sonnet 4.6
claude-sonnet-4-6-chatAvailable via APIText input readyChat · Anthropic's balanced Claude AI chat model on Rivya. It keeps strong long-form reasoning and careful analysis for content, research, and coding projects without jumping to Opus-level spend.
Base credits
per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Opus 4.5
claude-opus-4-5-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Claude Opus 4.5 is listed on Rivya with an integration-safety hold. Its indexable status page remains available while chat execution stays disabled.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Claude Sonnet 4.5
claude-sonnet-4-5-chatAvailable via APIText input readyChat · Anthropic's balanced Claude AI chat model on Rivya. It is strong at nuanced writing, careful analysis, and safety-conscious responses, making it a strong Claude option for content creation and research.
Base credits
per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Claude Haiku 4.5
claude-haiku-4-5-chatAvailable via APIText input readyChat · Anthropic's lightweight Claude AI chat model on Rivya. It is tuned for speed, cost efficiency, and stable day-to-day chat performance in high-frequency projects where you want Claude tone without premium spend.
Base credits
per_million_tokens · input=55 · output=285 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉
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
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
Chat API supports non-streaming and SSE streaming turns in Public API v1. Image attachments are not supported for this chat model.
Parameters
No extra model parameter is required.
Grok 4.7
grok-4-7-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Grok 4.6
grok-4-6-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Grok 4.6 — Temporarily unavailable. Continue with a callable alternative while Grok 4.6 remains on integration-safety hold.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Grok 4.5
grok-4-5-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Grok 4.5 — Temporarily unavailable. Continue with a callable alternative while Grok 4.5 remains on integration-safety hold.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Grok 4.3
grok-4-3-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · Grok 4.3 — Temporarily unavailable. Continue with a callable alternative while Grok 4.3 remains on integration-safety hold.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
Kimi K3
kimi-k3-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
DeepSeek V4.1 Flash
deepseek-v4-1-flash-chatThis request is temporarily unavailable. Please retry shortly.This request is temporarily unavailable. Please retry shortly.Chat · This model is listed but chat is not available yet. Rivya cannot currently determine the maximum credit charge before a conversation starts; use an available alternative in the meantime.
Base credits
This request is temporarily unavailable. Please retry shortly.
Modes
API input
This request is temporarily unavailable. Please retry shortly.
Inputs
-
Prompt limit
-
Reference media
-
Request
POST /api/v1/generations
Auth
Bearer API key
Idempotency-Key
Recommended
Body
No runnable Public API example is shown for this model.
Reference rule
-
Result
The create response returns a public task id. Poll GET /api/v1/generations/{taskId} until the status is succeeded or failed.
Common errors
validation_failed, insufficient_credits, idempotency_conflict, not_found
This model is listed for planning and comparison. Do not call it from Public API v1 until its status changes to Available via API.
Parameters
No extra model parameter is required.
