↓
Rivya AI Docs

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 id as model in POST /api/v1/generations for asynchronous image, video, and audio models.

  • Use chat model IDs in POST /api/v1/chat/completions.

  • Use top-level prompt for generation prompt text.

  • Use top-level message for Chat API turns.

  • Put asynchronous model-specific fields inside params.

  • Read api_input_status before building an integration. available_text and available_url_input can be tested without file upload; partial_requires_files means only some modes need Files API; requires_files_api means 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, and image_dimensions_token, and pass them as width, height, sizeBytes, and imageDimensionsToken; 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. auto is 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, and video_metadata_token. Pass them as durationSeconds, durationToken, width, height, framesPerSecond, videoBitrateMbps, sizeBytes, and videoMetadataToken; 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_capabilities for non-streaming support, SSE streaming support, image file_id attachments, 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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNoauto-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
resolutionselectNo1K-1K, 2K, 4K
backgroundselectNoauto-auto, transparent, opaque

GPT Image 2.5 Sunburst

gpt-image-2-5-sunburstAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNoauto-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
resolutionselectNo1K-1K, 2K, 4K
backgroundselectNoauto-auto, transparent, opaque

GPT Image 2

gpt-image-2Available via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolutionselectNo1K-1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Available via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
qualityselectNomedium-medium, high
aspect_ratioselectNo1:1-1:1, 2:3, 3:2

Z-Image

z-imageAvailable via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Available via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNoauto-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
resolutionselectNo1K-1K, 2K, 4K
output_formatselectNojpg-jpg, png

Nano Banana 2 Lite

nano-banana-2-liteAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNoauto-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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolutionselectNo1K-1K, 2K, 4K
output_formatselectNopng-png, jpg

Nano Banana

nano-bananaAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
imageSizeselectNo1:1-1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_formatselectNopng-png, jpeg

4o Image

4o-imageAvailable via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
sizeselectNo1:1-1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselectNobasic-basic, high, ultra
output_formatselectNopng-png, jpeg
nsfw_checkerselectNotrue-false, true

Seedream 5.0 Pro

seedream-5-proAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselectNobasic-basic, high
output_formatselectNopng-png, jpeg
nsfw_checkerselectNofalse-false, true

Seedream 5.0 Pro Layer Decomposition

seedream-5-pro-layer-decompositionAvailable via APIFiles API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
sizeselectNoauto-auto, 1K, 1.5K, 2K
output_formatselectNojpeg-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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselectNobasic-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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 2:3, 3:2, 16:9, 9:16, auto

Grok Imagine

grok-imagineAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 2:3, 3:2, 16:9, 9:16
nsfw_checkerselectNofalse-false, true
enable_proselectNofalse-false, true

Flux 2 Pro

flux-2-proAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselectNo1K-1K, 2K
nsfw_checkerselectNofalse-false, true

Flux 2 Flex

flux-2-flexAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselectNo1K-1K, 2K
nsfw_checkerselectNofalse-false, true

Flux Kontext Max

flux-kontext-maxAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselectNojpeg-jpeg, png
enableTranslationselectNotrue-true, false
promptUpsamplingselectNofalse-false, true
safetyTolerancenumberNo2min 0 / max 6-
watermarktextNo---

Flux Kontext Pro

flux-kontext-proAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselectNojpeg-jpeg, png
enableTranslationselectNotrue-true, false
promptUpsamplingselectNofalse-false, true
safetyTolerancenumberNo2min 0 / max 6-
watermarktextNo---

Qwen Image 3.0

qwen-image-3Available via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectYes1K-1K, 2K
image_sizeselectNo16:9-1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_formatselectNopng-png, jpeg
prompt_extendselectNotrue-true, false
nsfw_checkerselectNofalse-false, true
negative_prompttextNo---
seednumberNo1min 0 / max 2147483647 / step 1-

Qwen Image 3.0 Pro

qwen-image-3-proAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectYes1K-1K, 2K
image_sizeselectNo16:9-1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_formatselectNopng-png, jpeg
prompt_extendselectNotrue-true, false
nsfw_checkerselectNofalse-false, true
negative_prompttextNo---
seednumberNo1min 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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
image_sizeselectNo16:9-1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9
output_formatselectNopng-png, jpeg
seednumberNo-min 0-
nsfw_checkerselectNofalse-false, true

Qwen Image

qwen-imageAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_formatselectNopng-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 needed

Image · 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 needed

Image · 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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselectNo2K-1K, 2K
watermarkselectNofalse-false, true
seednumberNo-min 0 / max 2147483647 / step 1-

Wan 2.7 Image

wan-2-7-imageAvailable via APIPartial: Files API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselectNo2K-1K, 2K
watermarkselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-

Google Imagen4 Ultra

google-imagen4-ultraAvailable via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompttextNo---
seedtextNo---

Google Imagen4

google-imagen4Available via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo1:1-1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompttextNo---
seedtextNo---

Google Imagen4 Fast

google-imagen4-fastAvailable via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
aspect_ratioselectNo16:9-1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompttextNo---
seednumberNo---

Topaz Image Upscaler

topaz-image-upscaleAvailable via APIFiles API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
upscale_factorselectNo2-1, 2, 4

Ideogram V3

ideogram-v3Available via APIText input ready

Image · 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

keyTypeRequiredDefaultRangeOptions
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumberNo---
negative_prompttextNo---

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 needed

Image · 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

keyTypeRequiredDefaultRangeOptions
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_imagesselectNo1-1, 2, 3, 4
seednumberNo---
strengthnumberNo0.8min 0.01 / max 1-
negative_prompttextNo---

Ideogram Character

ideogram-characterAvailable via APIFiles API needed

Image · 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

keyTypeRequiredDefaultRangeOptions
rendering_speedselectNoBALANCED-TURBO, BALANCED, QUALITY
styleselectNoAUTO-AUTO, REALISTIC, FICTION
expand_promptselectNotrue-true, false
image_sizeselectNosquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_imagesselectNo1-1, 2, 3, 4
seednumberNo---
negative_prompttextNo---

Seedance 2.5

seedance-2-5Available via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-480p, 720p, 1080p
aspect_ratioselectNoadaptive-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min -1 / max 30 / step 1-
output_formatselectNomp4-mp4, mov
generate_audioselectNotrue-true, false
return_last_frameselectNofalse-false, true
web_searchselectNofalse-false, true
nsfw_checkerselectNotrue-false, true

Seedance 2.0

seedance-2Available via APIText input ready

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-720p, 1080p, 4K
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min 4 / max 15-
generate_audioselectNotrue-true, false
return_last_frameselectNofalse-false, true
web_searchselectNofalse-false, true
nsfw_checkerselectNofalse-false, true

Seedance 2.0 Fast

seedance-2-fastAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-480p, 720p
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min 4 / max 15-
generate_audioselectNotrue-true, false
return_last_frameselectNofalse-false, true
web_searchselectNofalse-false, true
nsfw_checkerselectNofalse-false, true

Seedance 2.0 Mini

seedance-2-miniAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo720p-480p, 720p
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumberNo5min 4 / max 15 / step 1-
generate_audioselectNotrue-true, false
web_searchselectNofalse-false, true
nsfw_checkerselectNotrue-false, true

Seedance 1.5 Pro

seedance-1-5-proAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-480p, 720p, 1080p
durationnumberNo8min 4 / max 12 / step 1-
generate_audioselectNofalse-false, true
aspectRatioselectNo1:1-1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lensselectNofalse-false, true
nsfw_checkerselectNofalse-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo1080p-720p, 1080p
aspect_ratioselectNo16:9-16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9
durationnumberNo5min 3 / max 15 / step 1-

HappyHorse 1.0

happyhorse-1-0Available via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo1080p-720p, 1080p
aspect_ratioselectNo16:9-16:9, 9:16, 1:1, 4:3, 3:4
durationnumberNo5min 3 / max 15-
seednumberNo0min 0 / max 2147483647-

Wan 3.0 Video

wan-3-0-videoAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
variantselectNostandard-standard, prime
resolutionselectNo1080P-480P, 720P, 1080P
aspect_ratioselectNoadaptive-adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
durationnumberNo5min -1 / max 30 / step 1-
audioselectNotrue-true, false
seednumberNo-min 0 / max 2147483647 / step 1-

Wan 2.7 Video

wan-2-7-videoAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-720p, 1080p
durationnumberNo5min 0 / max 15-
aspect_ratioselectNo16:9-16:9, 9:16, 1:1, 4:3, 3:4
negative_prompttextNo---
prompt_extendselectNotrue-true, false
watermarkselectNofalse-false, true
audio_settingselectNoauto-auto, origin
seednumberNo-min 0 / max 2147483647-

Wan 2.6

wan-2-6Available via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo1080p-720p, 1080p
durationselectNo5-5, 10, 15
multi_shotsselectNofalse-false, true
nsfw_checkerselectNotrue-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-720p, 1080p
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
enable_prompt_expansionselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-
negative_prompttextNo---

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-480p, 580p, 720p
aspect_ratioselectNo16:9-16:9, 9:16
enable_prompt_expansionselectNofalse-false, true
seednumberNo-min 0 / max 2147483647-
accelerationselectNonone-none, regular
num_framesnumberNo80min 40 / max 120 / step 4-
frames_per_secondnumberNo16min 4 / max 60 / step 1-
negative_prompttextNo---
num_inference_stepsnumberNo27min 2 / max 40 / step 1-
guidance_scalenumberNo3.5min 1 / max 10 / step 0.1-
shiftnumberNo5min 1 / max 10 / step 0.1-
enable_safety_checkerselectNotrue-true, false

Wan Animate Replace

wan-2-2-animate-replaceAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo480p-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
seedance_sceneselectNotext-text, frames, reference
resolutionselectNo2K-768P, 2K
aspect_ratioselectNo16:9-adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
minimax_single_frame_roleselectNofirst-first, last
durationnumberNo6min 4 / max 15 / step 1-

Hailuo 2.3

hailuo-2-3Available via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
qualityselectNostandard-standard, pro
resolutionselectNo768P-768P, 1080P
durationselectNo6-6, 10
nsfw_checkerselectNotrue-false, true

Hailuo Pro

hailuo-proAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
prompt_optimizerselectNotrue-false, true
nsfw_checkerselectNotrue-false, true

Hailuo Standard

hailuo-standardAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo6-6, 10
resolutionselectNo768P-512P, 768P
prompt_optimizerselectNotrue-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
modeselectNopro-std, pro, 4k
multi_shotsselectNofalse-false, true
durationselectNo5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
soundselectNofalse-false, true
aspect_ratioselectNo16:9-16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlAvailable via APIFiles API needed

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

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

keyTypeRequiredDefaultRangeOptions
modeselectNo720p-720p, 1080p
character_orientationselectNovideo-video, image

Kling 3.0 Turbo

kling-3-turboAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-720p, 1080p
durationnumberNo5min 3 / max 15 / step 1-
aspect_ratioselectNo16:9-1:1, 9:16, 16:9

Kling O3

kling-o3Available via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-720p, 1080p, 4k
durationselectNo5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
audioselectNofalse-false, true
aspect_ratioselectNo16:9-16:9, 9:16, 1:1

Kling 2.6

kling-2-6Available via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
soundselectNofalse-false, true
aspect_ratioselectNo1:1-1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
modeselectNo720p-720p, 1080p
character_orientationselectNovideo-video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1 / step 0.1-

Kling V2.1 Master

kling-v2-1-masterAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
aspect_ratioselectNo16:9-16:9, 9:16, 1:1
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1 / step 0.1-

Kling V2.1 Pro

kling-v2-1-proAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1 / step 0.1-

Kling V2.1 Standard

kling-v2-1-standardAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
negative_prompttextNo---
cfg_scalenumberNo0.5min 0 / max 1 / step 0.1-

Kling AI Avatar Pro

kling-ai-avatar-proAvailable via APIFiles API needed

Video · 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 needed

Video · 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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo480p-480p, 720p
seednumberNo-min 10000 / max 1000000-

Runway

runwayAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationselectNo5-5, 10
qualityselectNo720p-720p, 1080p
aspectRatioselectNo16:9-16:9, 4:3, 1:1, 3:4, 9:16
waterMarktextNo---

Runway Aleph

runway-alephAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
aspectRatioselectNo16:9-16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMarktextNo---
seednumberNo---

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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
durationnumberNo8min 1 / max 15 / step 1-
resolutionselectNo480p-480p, 720p
aspect_ratioselectNoauto-auto, 1:1, 16:9, 9:16, 3:2, 2:3
nsfw_checkerselectNotrue-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
upscale_factorselectNo2-1, 2, 4

Veo3.1 Quality

veo3-1-qualityAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
generationTypeselectNoFIRST_AND_LAST_FRAMES_2_VIDEO-FIRST_AND_LAST_FRAMES_2_VIDEO
aspectRatioselectNo16:9-16:9, 9:16, Auto
resolutionselectNo720p-720p, 1080p, 4k
durationselectNo8-4, 6, 8
watermarktextNo---
enableTranslationselectNotrue-true, false

Veo3.1 Fast

veo3-1-fastAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
generationTypeselectNoTEXT_2_VIDEO-TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatioselectNo16:9-16:9, 9:16, Auto
resolutionselectNo720p-720p, 1080p, 4k
durationselectNo8-4, 6, 8
watermarktextNo---
enableTranslationselectNotrue-true, false

Veo3.1 Lite

veo3-1-liteAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
generationTypeselectNoFIRST_AND_LAST_FRAMES_2_VIDEO-FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatioselectNo16:9-16:9, 9:16, Auto
resolutionselectNo720p-720p, 1080p, 4k
durationselectNo8-4, 6, 8
watermarktextNo---
enableTranslationselectNotrue-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 needed

Video · 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

keyTypeRequiredDefaultRangeOptions
reference_modeselectNoreference-reference, frames
resolutionselectNo720p-360p, 720p, 1080p, 4k
durationselectNo4-4, 6, 8, 10
aspect_ratioselectNo16:9-16:9, 9:16
seednumberNo-min 0 / max 2147483647-
video_startnumberNo-min 0 / max 30-
video_endsnumberNo-min 0 / max 30-

Gemini Omni Video

gemini-omni-videoAvailable via APIPartial: Files API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
resolutionselectNo720p-720p, 1080p, 4k
durationselectNo4-4, 6, 8, 10
aspect_ratioselectNo16:9-16:9, 9:16
seednumberNo-min 0 / max 2147483647-
video_startnumberNo-min 0 / max 30-
video_endsnumberNo-min 0 / max 30-

OmniHuman 1.5

omnihuman-1-5Available via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
output_resolutionselectNo1080-720, 1080
pe_fast_modeselectNofalse-false, true
seednumberNo-1--

Volcengine Video Lip Sync

volcengine-video-lip-syncAvailable via APIFiles API needed

Video · 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

keyTypeRequiredDefaultRangeOptions
modeselectYeslite-lite, basic
separate_vocalselectNofalse-false, true
open_scenedetselectNofalse-false, true
align_audioselectNotrue-true, false
align_audio_reverseselectNofalse-false, true
templ_start_secondsnumberNo0min 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 ready

Audio · 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

keyTypeRequiredDefaultRangeOptions
modelselectNoV6-V6, V6_MINI, V6_WILD
soundLoopselectNofalse-false, true
soundTemponumberNo-min 1 / max 300 / step 1-
soundKeyselectNoAny-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 ready

Audio · 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 ready

Audio · 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

keyTypeRequiredDefaultRangeOptions
default_voiceselectNoAdam-Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stabilityselectNo0.5-0, 0.5, 1
language_codetextNo---

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Available via APIText input ready

Audio · 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

keyTypeRequiredDefaultRangeOptions
voiceselectYesTX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumberNo0.5min 0 / max 1 / step 0.05-
similarity_boostnumberNo0.75min 0 / max 1 / step 0.05-
stylenumberNo0min 0 / max 1 / step 0.05-
speednumberNo1min 0.7 / max 1.2 / step 0.05-
timestampsselectNofalse-false, true
previous_texttextNo---
next_texttextNo---
language_codetextNo---

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Available via APIText input ready

Audio · 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

keyTypeRequiredDefaultRangeOptions
voiceselectYesTX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumberNo0.5min 0 / max 1 / step 0.05-
similarity_boostnumberNo0.75min 0 / max 1 / step 0.05-
stylenumberNo0min 0 / max 1 / step 0.05-
speednumberNo1min 0.7 / max 1.2 / step 0.05-
timestampsselectNofalse-false, true
previous_texttextNo---
next_texttextNo---

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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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 ready

Chat · 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.