Rivya AI 文档

模型 API Reference

查询 Rivya API 模型 ID、可用状态、支持模式、参数表、提示词上限、参考素材规则和模型详情链接。

最近审阅于 2026/05/11

这是 Rivya API v1 的模型级调用参考。

下方表格由 /api/v1/models 使用的同一模型目录和 public serializer 生成，不是人工写死的固定模型数量。

如何阅读这份参考

  • 异步图片、视频、音频模型调用 POST /api/v1/generations 时，把模型 id 作为 model。
  • Chat 模型 ID 用于 POST /api/v1/chat/completions。
  • 生成任务提示词放在顶层 prompt 字段。
  • Chat API turn 使用顶层 message 字段。
  • 异步模型专属字段放在 params 内。
  • 接入前先看 api_input_status。available_text 和 available_url_input 不需要文件上传即可测试；partial_requires_files 表示只有部分模式需要 Files API；requires_files_api 表示调用模型前需要先通过 Files API 上传参考素材。
  • 对 Chat 模型，请读取 chat_capabilities，确认非 streaming、SSE streaming、图片 file_id 附件、web search、thoughts 和 reasoning effort 支持情况。
  • 模型详情页提供产品层用法和示例。

请求形态

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

JavaScript 和 Python 示例见 创建生成任务。

Chat 请求形态：

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Chat 示例见 Chat API。

动态模型参考

配合在线调试器使用这份参考

先从 Quickstart 确认调用流程，再在这里核对模型字段，最后到 Developers 调试器运行 mock 或登录后的真实请求。

API Quickstart在线调试器

Z-Image

z-imageAPI 可调用文本输入可用

图片 · 阿里巴巴轻量级文生图模型，支持 5 种宽高比，1 积分即可快速出图，适合概念草图和社交媒体素材。

接入文档模型页面

基础积分

1

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

1000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2API 可调用部分可用：需要 Files API

图片 · Google 新一代图片模型，支持 4K 分辨率、15 种宽高比（含极端 8:1）、Google 搜索增强和最多 14 张参考图——Rivya 上最灵活的图片生成器。

接入文档模型页面

基础积分

5

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image · 14 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 14 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否auto-auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolutionselect否1K-1K, 2K, 4K
output_formatselect否jpg-jpg, png
google_searchselect否false-false, true

Nano Banana Pro

nano-banana-proAPI 可调用部分可用：需要 Files API

图片 · Google 高端图片模型，4K 输出、11 种宽高比、最多 8 张参考图，针对高保真品牌与营销视觉优化，细节和色彩精准度更高。

接入文档模型页面

基础积分

8

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

10000 字符

参考素材

image · 8 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 8 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolutionselect否1K-1K, 2K, 4K
output_formatselect否png-png, jpg

Nano Banana

nano-bananaAPI 可调用部分可用：需要 Files API

图片 · Google 的灵活图片模型，支持文生图、图生图、11 种宽高比、最多 10 张参考图，以及 PNG/JPEG 输出，适合人像、产品构图和更宽画幅的营销视觉。

接入文档模型页面

基础积分

3

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 10 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 10 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
imageSizeselect否1:1-1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_formatselect否png-png, jpeg

GPT Image 2

gpt-image-2API 可调用部分可用：需要 Files API

图片 · Rivya 当前接入的 OpenAI 新一代图片模型，支持文生图、图生图、最多 16 张参考图，以及 1K / 2K / 4K 三档清晰积分。

接入文档模型页面

基础积分

3

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image · 16 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 16 张图片参考素材，用于 GPT Image 2 图生图任务。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolutionselect否1K-1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5API 可调用部分可用：需要 Files API

图片 · OpenAI 图片模型，支持标准/高清两档质量和最多 16 张参考图，擅长理解复杂指令并渲染空间关系准确的连贯场景。

接入文档模型页面

基础积分

4

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

-

参考素材

image · 16 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 16 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
qualityselect否medium-medium, high
aspect_ratioselect否1:1-1:1, 2:3, 3:2

4o Image

4o-imageAPI 可调用文本输入可用

图片 · 4o Image 是 Rivya 里的轻量 OpenAI 文生图入口，表单只保留提示词与 3 种常用比例，适合快速验证图片想法。

接入文档模型页面

基础积分

3

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
sizeselect否1:1-1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteAPI 可调用部分可用：需要 Files API

图片 · 字节跳动更轻量的 Seedream 图片模型，在 Rivya 里对文生图和图像编辑统一按固定 6 积分计费。支持 8 种宽高比、最多 14 张参考图，适合作为 Seedream 家族里更低门槛的一档。

接入文档模型页面

基础积分

6

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

3000 字符

参考素材

image · 14 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 14 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselect否basic-basic, high

Seedream 4.5

seedream-4-5API 可调用部分可用：需要 Files API

图片 · 字节跳动高端图片模型，2K/4K 双档质量、8 种宽高比、最多 14 张参考图，以电影级调色和丰富纹理细节著称，擅长时尚和生活方式视觉。

接入文档模型页面

基础积分

7

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

3000 字符

参考素材

image · 14 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 14 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselect否basic-basic, high

Seedream 4.0

seedream-4-0API 可调用部分可用：需要 Files API

图片 · Seedream 4.0 是 Rivya 里的均衡 ByteDance 图片模型，适合文生图、参考图编辑和明确输出规格的图片项目。

接入文档模型页面

基础积分

6

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 10 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 10 张图片，用于 Seedream 4.0 的图片编辑路径。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolutionselect否1K-1K, 2K, 4K
max_imagesnumber否1min 1 / max 6 / step 1-
seednumber否-min 0 / max 2147483647 / step 1-
nsfw_checkerselect否false-false, true

Seedream 3.0

seedream-3-0API 可调用文本输入可用

图片 · Seedream 3.0 是 Rivya 里的旧线 Seedream 文生图入口，适合轻量中文图片草稿、双语提示词测试和旧版视觉方向对照。

接入文档模型页面

基础积分

5

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scalenumber否2.5min 1 / max 10 / step 0.1-
seednumber否-min 0 / max 2147483647-

Grok Imagine

grok-imagineAPI 可调用部分可用：需要 Files API

图片 · xAI 图片模型，创意解读能力强，5 种宽高比，单图生成专注于艺术表达和非常规视觉风格。

接入文档模型页面

基础积分

4

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 2:3, 3:2, 16:9, 9:16
enable_proselect否false-false, true

Flux 2 Pro

flux-2-proAPI 可调用部分可用：需要 Files API

图片 · Black Forest Labs 旗舰 320 亿参数模型，支持文生图和图生图，最多 8 张参考图、2K 分辨率和精准文字渲染，专为产品摄影和品牌视觉打造。

接入文档模型页面

基础积分

5

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 8 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 8 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselect否1K-1K, 2K

Flux 2 Flex

flux-2-flexAPI 可调用部分可用：需要 Files API

图片 · Flux 2 系列的编辑专用变体，专注结构调整和风格迁移，最多 8 张参考图、2K 分辨率——适合在现有视觉基础上迭代优化。

接入文档模型页面

基础积分

14

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 8 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 8 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolutionselect否1K-1K, 2K

Flux Kontext Max

flux-kontext-maxAPI 可调用部分可用：需要 Files API

图片 · Black Forest Labs 的 Flux Kontext 增强模型，面向更复杂的提示词生成和图片编辑任务。当前在 Rivya 里，文生图与图生图继续共用同一条异步项目，并统一按固定 8 积分/次执行平台定价。

接入文档模型页面

基础积分

8

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选水印文本"
  }
}

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于图片编辑项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselect否jpeg-jpeg, png
enableTranslationselect否true-true, false
promptUpsamplingselect否false-false, true
safetyTolerancenumber否2min 0 / max 6-
watermarktext否---

Flux Kontext Pro

flux-kontext-proAPI 可调用部分可用：需要 Files API

图片 · Black Forest Labs 的低门槛 Flux Kontext 选项，当前在 Rivya 上同时承接文生图、图生图和单图改图。按当前平台定价口径，这几个模式都统一按固定 4 积分结算，并继续沿现有异步图片结果链收口。

接入文档模型页面

基础积分

4

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选水印文本"
  }
}

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于图片编辑项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormatselect否jpeg-jpeg, png
enableTranslationselect否true-true, false
promptUpsamplingselect否false-false, true
safetyTolerancenumber否2min 0 / max 6-
watermarktext否---

Qwen2 Image

qwen2-imageAPI 可调用部分可用：需要 Files API

图片 · 阿里 Qwen2 图片模型当前在 Rivya 里按一个固定积分图片项目接入。它安全覆盖文生图与图生图两种模式，只开放两份公开文档共同出现的宽高比子集，并保留 PNG/JPEG 输出、随机种子与简单内容过滤开关。

接入文档模型页面

基础积分

6

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

800 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
image_sizeselect否16:9-1:1, 3:4, 4:3, 9:16, 16:9
output_formatselect否png-png, jpeg
seednumber否-min 0-
nsfw_checkerselect否false-false, true

Qwen Image

qwen-imageAPI 可调用部分可用：需要 Files API

图片 · 阿里巴巴通义千问系列图片模型，提供高清预设尺寸（方形、竖向、横向）和 PNG/JPEG 输出，擅长中文提示词和文化细节的视觉生成。

接入文档模型页面

基础积分

4

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_formatselect否png-png, jpeg

Midjourney

midjourneyAPI 可调用部分可用：需要 Files API

图片 · Midjourney 的 V7 图片模型，支持文生图、图生图、Niji 动漫模式、风格参考和 Omni Reference 一致性控制，仍然是电影感艺术图、插画和风格板的行业标杆。

接入文档模型页面

基础积分

3

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

2000 字符

参考素材

image · 4 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 4 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
speedselect否relaxed-relaxed, fast, turbo
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
versionselect否7-7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundAPI 可调用需要 Files API

图片 · Recraft 在 Rivya 上的去背景模型，适合从一张现有图片里把主体干净分离出来。它更适合透明 cutout、主体分离和下一步设计前的干净源图。

接入文档模型页面

基础积分

1

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

源图片: 这个项目只接受 1 张图。主体边缘越清楚，抠图结果通常越干净。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

不需要额外模型参数。

Recraft Crisp Upscale

recraft-crisp-upscaleAPI 可调用需要 Files API

图片 · Recraft 在 Rivya 上的轻量图片放大模型，适合对一张已经选定的图片做低成本锐化和清晰度补强，而不是直接上更重的交付级放大。

接入文档模型页面

基础积分

1

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

源图片: 这个项目只接受 1 张图，适合先做一次低成本的清晰度补强。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

不需要额外模型参数。

Wan 2.7 Image Pro

wan-2-7-image-proAPI 可调用部分可用：需要 Files API

图片 · 阿里更高阶的 Wan 2.7 图片模型，当前在 Rivya 里作为独立图片模型入口接入文生图与图像编辑，当前每次生成消耗 12 积分。

接入文档模型页面

基础积分

12

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 9 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 9 个图片参考素材，用于图像编辑项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselect否2K-1K, 2K
watermarkselect否false-false, true
seednumber否-min 0 / max 2147483647 / step 1-

Wan 2.7 Image

wan-2-7-imageAPI 可调用部分可用：需要 Files API

图片 · 阿里标准档的 Wan 2.7 图片模型，当前在 Rivya 里作为独立图片模型入口接入文生图与图像编辑，当前每次生成消耗 5 积分。

接入文档模型页面

基础积分

5

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 9 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 9 个图片参考素材，用于图像编辑项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolutionselect否2K-1K, 2K
watermarkselect否false-false, true
seednumber否-min 0 / max 2147483647-

Google Imagen4 Ultra

google-imagen4-ultraAPI 可调用文本输入可用

图片 · Google Imagen4 Ultra 是 Rivya 上更高档的一档 Imagen 文生图模型。当前按固定 12 积分、单张输出项目接入，并开放公开文档里可稳定承接的提示词、反向提示词、宽高比和种子参数。

接入文档模型页面

基础积分

12

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "可选的规避内容",
    "seed": "可选种子值"
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttext否---
seedtext否---

Google Imagen4

google-imagen4API 可调用文本输入可用

图片 · Google Imagen4 是 Rivya 上标准档的 Imagen 文生图模型。当前按固定 8 积分、单张输出项目接入，并开放公开文档里可稳定承接的提示词、反向提示词、宽高比和种子参数。

接入文档模型页面

基础积分

8

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "可选的规避内容",
    "seed": "可选种子值"
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
aspect_ratioselect否1:1-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttext否---
seedtext否---

Google Imagen4 Fast

google-imagen4-fastAPI 可调用文本输入可用

图片 · Google Imagen4 Fast 是 Rivya 上更轻量的一档 Google Imagen 文生图模型。当前继续按单张输出项目接入，固定 4 积分，并开放公开文档中可稳定承接的提示词、反向提示词、宽高比和种子参数。

接入文档模型页面

基础积分

4

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "可选的规避内容",
    "seed": 0
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
aspect_ratioselect否16:9-1:1, 16:9, 9:16, 3:4, 4:3
negative_prompttext否---
seednumber否-min 0-

Topaz Image Upscaler

topaz-image-upscaleAPI 可调用需要 Files API

图片 · Topaz 在 Rivya 上的交付级图片放大模型，适合构图已经定了，只剩导出尺寸、评审分辨率或印刷清晰度还不够的静帧。

接入文档模型页面

基础积分

5

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

源图片: 上传 1 张你想保留构图的图片。这个入口做的是放大，不是重新创作。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
upscale_factorselect否1-1, 2, 4, 8

Ideogram V3

ideogram-v3API 可调用文本输入可用

图片 · Ideogram V3 是 Rivya 里偏文字渲染、海报版式和设计导向的文生图模型。当前价格为：TURBO 4 积分，BALANCED 7 积分，QUALITY 10 积分。

接入文档模型页面

基础积分

7

支持模式

text-to-image

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "可选的规避内容"
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
rendering_speedselect否BALANCED-TURBO, BALANCED, QUALITY
styleselect否AUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselect否true-true, false
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumber否-min 0-
negative_prompttext否---

Ideogram V3 Reframe

ideogram-v3-reframeAPI 可调用需要 Files API

图片 · Ideogram V3 Reframe 当前在 Rivya 上按渲染速度分档接入单图重构项目。当前价格为：TURBO 4 积分，BALANCED 7 积分，QUALITY 10 积分。

接入文档模型页面

基础积分

7

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 这个项目只接受 1 张图片。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
rendering_speedselect否BALANCED-TURBO, BALANCED, QUALITY
styleselect否AUTO-AUTO, GENERAL, REALISTIC, DESIGN
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumber否-min 0-

Ideogram V3 Remix

ideogram-v3-remixAPI 可调用需要 Files API

图片 · Ideogram V3 Remix 当前在 Rivya 上按渲染速度分档接入单图重混项目。当前价格为：TURBO 4 积分，BALANCED 7 积分，QUALITY 10 积分。

接入文档模型页面

基础积分

7

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 这个项目只接受 1 张图片。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
rendering_speedselect否BALANCED-TURBO, BALANCED, QUALITY
styleselect否AUTO-AUTO, GENERAL, REALISTIC, DESIGN
expand_promptselect否true-true, false
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumber否-min 0-
strengthnumber否0.8min 0.01 / max 1-
negative_prompttext否---

Ideogram Character

ideogram-characterAPI 可调用需要 Files API

图片 · 面向角色一致性的专门入口，把 1 张已经定下来的角色图延展到新场景、新服装和新尺寸。适合你更在意身份保留，而不是开放式图片编辑，并且一次只需要 1 张输出图。

接入文档模型页面

基础积分

18

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

角色参考图: 上传 1 张清晰角色参考图即可。这个入口会忽略多余图片，并把输出固定成单图结果。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
rendering_speedselect否BALANCED-TURBO, BALANCED, QUALITY
styleselect否AUTO-AUTO, REALISTIC, FICTION
expand_promptselect否true-true, false
image_sizeselect否square_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seednumber否-min 0-
negative_prompttext否---

Seedance 2.0

seedance-2API 可调用文本输入可用

视频 · 字节跳动完整版 Seedance 2.0 视频模型，当前在 Rivya 里完整接入了文生视频、首帧/首尾帧驱动，以及多模态参考生视频三类场景。产品层保留了与文档一致的角色拆分，避免把首尾帧和参考图/参考视频/参考音频混成一个模糊上传桶。

接入文档模型页面

基础积分

175

支持模式

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

API 输入状态

文本输入可用

输入类型

text

提示词上限

2500 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
seedance_sceneselect否text-text, frames, reference
resolutionselect否720p-480p, 720p
aspect_ratioselect否16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumber否5min 4 / max 15-
generate_audioselect否true-true, false
return_last_frameselect否false-false, true
web_searchselect否false-false, true
nsfw_checkerselect否false-false, true

Seedance 2.0 Fast

seedance-2-fastAPI 可调用文本输入可用

视频 · 字节跳动更快的 Seedance 2.0 视频模型，当前在 Rivya 里完整接入了文生视频、首帧/首尾帧驱动，以及多模态参考生视频三类场景。为了避免首尾帧和参考图/参考视频/参考音频的角色混淆，产品层保持了与文档一致的显式场景拆分。

接入文档模型页面

基础积分

140

支持模式

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

API 输入状态

文本输入可用

输入类型

text

提示词上限

2500 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
seedance_sceneselect否text-text, frames, reference
resolutionselect否720p-480p, 720p
aspect_ratioselect否16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
durationnumber否5min 4 / max 15-
generate_audioselect否true-true, false
return_last_frameselect否false-false, true
web_searchselect否false-false, true
nsfw_checkerselect否false-false, true

Seedance 1.5 Pro

seedance-1-5-proAPI 可调用部分可用：需要 Files API

视频 · 字节跳动的旗舰视频模型，支持文生视频、图生视频、原生音视频同步、480p–1080p、4–12 秒片段、6 种宽高比、动态/固定镜头控制，以及唇形同步。

接入文档模型页面

基础积分

28

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

2500 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 2 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-480p, 720p, 1080p
durationselect否8-4, 8, 12
generate_audioselect否false-false, true
aspectRatioselect否1:1-1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lensselect否false-false, true

Seedance 1.0 Pro

seedance-1-0-proAPI 可调用部分可用：需要 Files API

视频 · 字节跳动 Seedance 1.0 Pro 模型，当前在 Rivya 里作为 Seedance 1.0 标准 Pro 路径接入文生视频和图生视频。产品面保持与公开 V1 Pro 文档对齐，开放分辨率、时长、锁定镜头、随机种子和安全检查参数。

接入文档模型页面

基础积分

25

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

10000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频模式可上传 1 张图片作为源图。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-480p, 720p, 1080p
durationselect否5-5, 10
aspect_ratioselect否16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixedselect否false-false, true
seednumber否-1min -1 / max 2147483647-
enable_safety_checkerselect否true-true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastAPI 可调用需要 Files API

视频 · 字节跳动快速图生视频模型，将单张参考图动画化为 5 秒或 10 秒片段（720p/1080p）——需要从静态图快速出视频时的最优选择。

接入文档模型页面

基础积分

16

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

10000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 上传 1 张参考图，将静态画面动画化为视频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-720p, 1080p
durationselect否5-5, 10

Seedance 1.0 Lite

seedance-1-0-liteAPI 可调用部分可用：需要 Files API

视频 · 字节跳动 Seedance 1.0 Lite 模型，当前在 Rivya 里作为更轻量的 1.0 路径接入文生视频和图生视频。参数面继续对齐公开 V1 Lite 文档，当前价格也保持在比 Seedance 1.0 Pro 更低的一档。

接入文档模型页面

基础积分

16

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

10000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频模式可上传 1 张源图；如果还想补充可选尾帧，可再上传第 2 张图片。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-480p, 720p, 1080p
durationselect否5-5, 10
aspect_ratioselect否16:9-16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixedselect否false-false, true
seednumber否-1min -1 / max 2147483647-
enable_safety_checkerselect否true-true, false

HappyHorse 1.0

happyhorse-1-0API 可调用部分可用：需要 Files API

视频 · Rivya 上灵活的视频模型，一个公开模型页同时支持文生视频、单图图生视频、多图参考视频和视频编辑。

接入文档模型页面

基础积分

28

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image, video · 10 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 无视频时最多使用 9 张图片；视频编辑时使用 1 段视频加最多 5 张图片参考。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否1080p-720p, 1080p
aspect_ratioselect否16:9-16:9, 9:16, 1:1, 4:3, 3:4
durationnumber否5min 3 / max 15-
audio_settingselect否auto-auto, origin
seednumber否0min 0 / max 2147483647-

Wan 2.7 Video

wan-2-7-videoAPI 可调用部分可用：需要 Files API

视频 · 阿里更新一代 Wan 视频模型，当前在 Rivya 里按分辨率和时长计费。产品层目前统一开放文生视频、图生视频和视频编辑，5 秒 720p 从 80 积分起。

接入文档模型页面

基础积分

80

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image, video · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选的排除内容或失败画面描述。",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

参考素材规则

参考素材: 最多上传 2 个参考素材：图生视频可用最多 2 张图片；视频编辑可用 1 段视频加 1 张可选参考图。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-720p, 1080p
durationselect否5-5, 10, 15
aspect_ratioselect否16:9-16:9, 9:16, 1:1, 4:3, 3:4
negative_prompttext否---
prompt_extendselect否true-true, false
watermarkselect否false-false, true
audio_settingselect否auto-auto, origin
seednumber否-min 0 / max 2147483647-

Wan 2.6

wan-2-6API 可调用部分可用：需要 Files API

视频 · 阿里 Wan 家族在 Rivya 上的三模式重项目：文生视频、图生视频和源视频改写都放在同一条选项上。当前支持 720p / 1080p、5–15 秒，并且一次只承接 1 张图片或 1 段源视频。

接入文档模型页面

基础积分

70

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image, video · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 可上传最多 1 个图片或视频素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-720p, 1080p
durationselect否5-5, 10, 15

Wan 2.5 Video

wan-2-5-videoAPI 可调用部分可用：需要 Files API

视频 · Wan 2.5 当前在 Rivya 上统一承接文生视频与图生视频，当前价格为：`720p_5 = 60`、`720p_10 = 120`、`1080p_5 = 100`、`1080p_10 = 200`。

接入文档模型页面

基础积分

60

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选的排除内容或失败画面描述。",
    "nsfw_checker": "false"
  }
}

参考素材规则

参考图片: 可上传最多 1 张图片，用于图生视频模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-720p, 1080p
durationselect否5-5, 10
aspect_ratioselect否16:9-16:9, 9:16, 1:1
enable_prompt_expansionselect否false-false, true
seednumber否-min 0 / max 2147483647-
negative_prompttext否---
nsfw_checkerselect否false-false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboAPI 可调用部分可用：需要 Files API

视频 · Wan 2.2 A14B Turbo 当前在 Rivya 上统一承接文生视频、图生视频，以及需要 1 张图片加 1 段音频的语音驱动视频。当前价格为：文生/图生 `480p = 8`、`720p = 12`；图片+音频驱动 `480p = 16`、`580p = 20`、`720p = 24`。

接入文档模型页面

基础积分

12

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选的排除内容或失败画面描述。",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

参考素材规则

参考素材: 最多上传 2 个参考素材：文生视频不需要素材；图生视频使用 1 张图片；图片+音频驱动视频使用 1 张图片加 1 段音频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否720p-480p, 580p, 720p
aspect_ratioselect否16:9-16:9, 9:16
enable_prompt_expansionselect否false-false, true
seednumber否-min 0 / max 2147483647-
accelerationselect否none-none, regular
num_framesnumber否80min 40 / max 120 / step 1-
frames_per_secondnumber否16min 4 / max 60 / step 1-
negative_prompttext否---
num_inference_stepsnumber否27min 2 / max 40 / step 1-
guidance_scalenumber否3.5min 1 / max 10 / step 0.1-
shiftnumber否5min 1 / max 10 / step 0.1-
enable_safety_checkerselect否true-true, false

Wan 动画替换

wan-2-2-animate-replaceAPI 可调用URL 输入可用

视频 · Wan 在 Rivya 上的角色替换视频模型，适合把已有视频里出现的人物或主体换掉。它适合动作已经对了，只需要 1 条公开源视频 URL、1 条公开替换图 URL 和分辨率档位的情况。

接入文档模型页面

基础积分

20

支持模式

video-to-video

API 输入状态

URL 输入可用

输入类型

url

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型支持通过模型参数传入公开 URL。

参数

key类型必填默认值范围枚举值
video_urltext否---
image_urltext否---
resolutionselect否480p-480p, 580p, 720p

Hailuo 2.3

hailuo-2-3API 可调用需要 Files API

视频 · MiniMax 的图生视频模型，支持 Standard/Pro 双档质量、768P/1080P 分辨率、6 秒或 10 秒片段，以更顺滑的运动和自然过渡著称。

接入文档模型页面

基础积分

25

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
qualityselect否standard-standard, pro
resolutionselect否768P-768P, 1080P
durationselect否6-6, 10

Hailuo Pro

hailuo-proAPI 可调用部分可用：需要 Files API

视频 · MiniMax 旧版 Hailuo Pro 视频模型，当前按固定 Pro 档位接入，统一支持文生视频和图生视频。图生侧可上传 1 到 2 张参考图，第二张会作为尾帧图参与生成，当前每次生成消耗 57 积分。

接入文档模型页面

基础积分

57

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

1500 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会作为尾帧图参与生成。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
prompt_optimizerselect否false-false, true

Hailuo Standard

hailuo-standardAPI 可调用部分可用：需要 Files API

视频 · MiniMax 旧线 Hailuo Standard 视频模型，支持文生视频和图生视频。图生侧可上传 1 到 2 张参考图，第二张会作为尾帧图参与生成。

接入文档模型页面

基础积分

30

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

1500 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会作为尾帧图参与生成。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
durationselect否6-6, 10
resolutionselect否512P-512P, 768P
prompt_optimizerselect否false-false, true

Kling 3.0

kling-3-0API 可调用部分可用：需要 Files API

视频 · 快手的高端视频模型，支持文生视频、图生视频、Standard (720P) / Pro (1080P) 双档、单/多镜头结构、3–15 秒时长、可选音频，以及最多 2 张参考图。

接入文档模型页面

基础积分

90

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

2000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 图生视频最多上传 2 张参考图。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
modeselect否pro-std, pro
multi_shotsselect否false-false, true
durationselect否5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
soundselect否false-false, true
aspect_ratioselect否16:9-16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlAPI 可调用需要 Files API

视频 · 更新一代的 Kling 动作控制项目，用 1 张参考图加 1 段动作视频驱动同一主体，并多了背景来源选择。适合你不仅要做动作迁移，还要决定最终场景更像视频环境还是参考图世界。

接入文档模型页面

基础积分

27

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

2500 字符

参考素材

image, video · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图 + 动作视频: 固定上传 1 张角色图和 1 段动作视频。只有当你需要同时控制角色朝向和背景来源时，才优先选 3.0。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
modeselect否pro-std, pro
character_orientationselect否video-video, image
background_sourceselect否input_video-input_video, input_image

Kling 2.6

kling-2-6API 可调用部分可用：需要 Files API

视频 · 快手视频模型，可选音频生成、5/10 秒片段、3 种宽高比，擅长人物运动和表情丰富的角色动画，物理效果自然。

接入文档模型页面

基础积分

55

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

1000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
soundselect否false-false, true
aspect_ratioselect否1:1-1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlAPI 可调用需要 Files API

视频 · 更偏轻量和低成本的 Kling 动作迁移项目，用 1 张参考图加 1 段动作视频驱动同一主体。适合想先做便宜一档的 motion-control 测试，又不需要 Kling 3.0 那组额外场景控制时使用。

接入文档模型页面

基础积分

16

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

2500 字符

参考素材

image, video · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图 + 动作视频: 固定上传 1 张角色图和 1 段动作视频，两个素材都最好能清楚看到头部、肩膀和躯干。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
modeselect否720p-720p, 1080p
character_orientationselect否video-video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proAPI 可调用部分可用：需要 Files API

视频 · 快手可灵 V2.5 Turbo Pro 视频模型，当前同时支持文生和图生。当前价格为：5 秒 42 积分，10 秒 84 积分。

接入文档模型页面

基础积分

42

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

2500 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "描述你不希望在视频里出现的内容",
    "cfg_scale": 0.5
  }
}

参考素材规则

参考图片: 可选上传最多 2 张图片切换到图生视频模式；第 2 张图会映射到尾帧。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
aspect_ratioselect否16:9-16:9, 9:16, 1:1
negative_prompttext否---
cfg_scalenumber否0.5min 0 / max 1-

Kling V2.1 Master

kling-v2-1-masterAPI 可调用部分可用：需要 Files API

视频 · 快手可灵旧版 V2.1 Master 视频模型，当前同时支持文生和图生。当前价格为：5 秒 160 积分，10 秒 320 积分。

接入文档模型页面

基础积分

160

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "描述你不希望在视频里出现的内容",
    "cfg_scale": 0.5
  }
}

参考素材规则

参考图片: 可选上传 1 张图片切换到图生视频模式；不上传图片时继续走文生视频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
aspect_ratioselect否16:9-16:9, 9:16, 1:1
negative_prompttext否---
cfg_scalenumber否0.5min 0 / max 1-

Kling V2.1 Pro

kling-v2-1-proAPI 可调用需要 Files API

视频 · 快手可灵旧版 V2.1 Pro 图生视频模型，支持首图与可选尾帧双图。当前价格为：5 秒 50 积分，10 秒 100 积分。

接入文档模型页面

基础积分

50

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会映射到尾帧图。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
negative_prompttext否---
cfg_scalenumber否0.5min 0 / max 1-

Kling V2.1 Standard

kling-v2-1-standardAPI 可调用需要 Files API

视频 · 快手可灵旧版 V2.1 Standard 图生视频模型，当前价格为：5 秒 25 积分，10 秒 50 积分。

接入文档模型页面

基础积分

25

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

参考图片: 图生视频最多可上传 1 张图片作为首帧参考。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
negative_prompttext否---
cfg_scalenumber否0.5min 0 / max 1-

Kling AI Avatar Pro

kling-ai-avatar-proAPI 可调用需要 Files API

视频 · 快手可灵 AI Avatar Pro 高质量数字人口播模型，固定使用 1 张人物图和 1 段音频生成口型同步视频。Rivya 当前按固定 16 积分 / 次接入。

接入文档模型页面

基础积分

16

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

人物图与音频: 需要同时上传 1 张人物图和 1 段音频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

不需要额外模型参数。

Kling AI Avatar Standard

kling-ai-avatar-standardAPI 可调用需要 Files API

视频 · 快手可灵 AI Avatar Standard 数字人口播模型，固定使用 1 张人物图和 1 段音频生成口型同步视频。Rivya 当前按固定 8 积分 / 次接入。

接入文档模型页面

基础积分

8

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

人物图与音频: 需要同时上传 1 张人物图和 1 段音频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

不需要额外模型参数。

Infinitalk

infinitalkAPI 可调用需要 Files API

视频 · Infinitalk 是一个基于图片和音频生成数字人口播视频的模型。当前价格按分辨率和音频时长计算：480p = 3 积分 / 秒，720p = 12 积分 / 秒。

接入文档模型页面

基础积分

3

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

人物图与音频: 需要同时上传 1 张人物图和 1 段音频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
resolutionselect否480p-480p, 720p
seednumber否-min 10000 / max 1000000-

Runway

runwayAPI 可调用部分可用：需要 Files API

视频 · Runway 是一个支持文生视频和图生视频的独立视频模型。当前公开价格只明确覆盖 6 个生成档位，因此 Rivya 先按可确认的 `720p_5 = 12`、`720p_10 = 30`、`1080p_5 = 30` 接入。

接入文档模型页面

基础积分

12

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

1800 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "留空表示不添加水印"
  }
}

参考素材规则

参考图片: 可选上传 1 张图片切换到图生视频；不上传图片时继续走文生视频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
durationselect否5-5, 10
qualityselect否720p-720p, 1080p
aspectRatioselect否16:9-16:9, 4:3, 1:1, 3:4, 9:16
waterMarktext否---

Runway Aleph

runway-alephAPI 可调用需要 Files API

视频 · 面向已有源视频的视频改写项目。适合运动和镜头基础来自你的输入素材，而视觉方向由提示词决定，当前固定 90 积分。

接入文档模型页面

基础积分

90

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

video, image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

输入素材: 上传你要给 Aleph 改写的源视频。只有在需要额外约束风格或主体方向时，再补 1 张静态参考图。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否16:9-16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMarktext否---
seednumber否-min 0 / max 2147483647-

Luma Modify Video

luma-modify-videoAPI 可调用需要 Files API

视频 · 独立的 source-video 改写入口，用来把一条现有视频推向新的视觉方向。适合你要的是 prompt 驱动改写，而不是单纯提高清晰度。

接入文档模型页面

基础积分

30

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

video · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

输入视频: 上传 1 段你想改写的短视频。这个入口会重写素材，而不是只做清晰度增强。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
watermarktext否---

Grok Imagine Video

grok-imagine-videoAPI 可调用部分可用：需要 Files API

视频 · xAI 视频模型，Fun/Normal/Spicy 三种创意模式和 5 种宽高比，独特风格预设覆盖从趣味到电影到前卫的不同创意调性。

接入文档模型页面

基础积分

10

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
modeselect否normal-fun, normal, spicy
durationnumber否6min 6 / max 30 / step 1-
resolutionselect否480p-480p, 720p
aspect_ratioselect否2:3-1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proAPI 可调用部分可用：需要 Files API

视频 · Sora 2 高端版，Standard/High 双档质量、10/15 秒片段、水印移除，细节、光影和运动保真度更高，适合专业视频制作。

接入文档模型页面

基础积分

75

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

10000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
sizeselect否--standard, high
n_framesselect否10-10, 15
aspect_ratioselect否landscape-landscape, portrait
remove_watermarkselect否false-false, true
upload_methodselect否s3-s3, oss

Sora 2

sora-2API 可调用部分可用：需要 Files API

视频 · OpenAI 的视频模型，支持文生视频、图生视频、同步音频、真实物理模拟、10/15 秒片段、横向/竖向输出，以及可选水印移除。

接入文档模型页面

基础积分

6

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

10000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
n_framesselect否10-10, 15
aspect_ratioselect否landscape-landscape, portrait
remove_watermarkselect否false-false, true
upload_methodselect否s3-s3, oss

Sora Watermark Remover

sora-watermark-removerAPI 可调用URL 输入可用

视频 · Rivya 上面向公开 Sora 分享链接的去水印后处理模型。它适合 Sora 视频已经生成完成，剩下只是去水印，并顺手决定结果走 S3 还是 OSS。

接入文档模型页面

基础积分

3

支持模式

video-to-video

API 输入状态

URL 输入可用

输入类型

url

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型支持通过模型参数传入公开 URL。

参数

key类型必填默认值范围枚举值
video_urltext是---
upload_methodselect是s3-s3, oss

Topaz Video Upscaler

topaz-video-upscaleAPI 可调用需要 Files API

视频 · Topaz 在 Rivya 上的交付级视频放大模型，适合镜头、动作和节奏都已经定了，只剩导出分辨率和最终清晰度还不够的成片。

接入文档模型页面

基础积分

12

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

video · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

源视频: 上传 1 个你想保留内容不变的源视频。这个入口做的是交付前提清，不是画面改写。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

key类型必填默认值范围枚举值
upscale_factorselect否2-1, 2, 4

Veo3.1 Quality

veo3-1-qualityAPI 可调用部分可用：需要 Files API

视频 · Google Veo 3.1 品质优先版，适合高规格的文生视频与图片驱动生成。更高保真的画面、更稳的运动真实感，以及默认带背景音频，使它成为 Rivya 上更高阶的 Veo 选项。

接入文档模型页面

基础积分

150

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "可选水印文本",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

参考素材规则

参考图片: 可上传最多 2 张图片，用于当前支持的图片驱动项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否16:9-16:9, 9:16, Auto
watermarktext否---
seedsnumber否-min 10000 / max 99999 / step 1-
enableTranslationselect否true-true, false

Veo3.1 Fast

veo3-1-fastAPI 可调用部分可用：需要 Files API

视频 · Google Veo 3.1 快速版，三模式支持：文生视频、图生视频、参考图生视频。最多 3 张参考图、原生音频，以及按模式区分的宽高比控制，适合快速试用电影感片段。

接入文档模型页面

基础积分

20

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 3 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "可选水印文本",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

参考素材规则

参考图片: 可上传最多 3 个图片参考素材，用于图生视频和参考图生视频。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
generationTypeselect否FIRST_AND_LAST_FRAMES_2_VIDEO-FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatioselect否16:9-16:9, 9:16, Auto
watermarktext否---
seedsnumber否-min 10000 / max 99999 / step 1-
enableTranslationselect否true-true, false

Veo3.1 Lite

veo3-1-liteAPI 可调用部分可用：需要 Files API

视频 · Google Veo 3.1 的最低成本档。Rivya 当前只开放最小稳定子集：文生视频和图生视频，固定 `10` 积分 / 次。

接入文档模型页面

基础积分

10

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "可选水印文本",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

参考素材规则

参考图片: 可上传最多 2 个图片参考素材，用于当前支持的图片驱动项目。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

提示词或 URL 模式可能已经可调用；参考素材模式仍需要 Files API 上传支持。 Files API

参数

key类型必填默认值范围枚举值
aspectRatioselect否16:9-16:9, 9:16, Auto
watermarktext否---
seedsnumber否-min 10000 / max 99999 / step 1-
enableTranslationselect否true-true, false

Suno Music

suno-musicAPI 可调用文本输入可用

音频 · Suno Music 是 Rivya 里的文本生成音乐模型，适合把一句简短需求直接变成有人声或纯音乐的歌曲草稿。它保持固定 `12` 积分入口，并在成功结果后继续提供 `Extend Music`。

接入文档模型页面

基础积分

12

支持模式

text-to-audio

API 输入状态

文本输入可用

输入类型

text

提示词上限

500 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
modelselect否V4_5-V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumentalselect否false-false, true

Suno Sounds

suno-soundsAPI 可调用文本输入可用

音频 · Suno Sounds 是 Rivya 里的轻量文本生成声音模型，适合做环境循环、背景音和短声音草稿。它保持公开定价固定 `3` 积分 / 次，并支持从成功结果继续做 `Vocal Separation`。

接入文档模型页面

基础积分

3

支持模式

text-to-audio

API 输入状态

文本输入可用

输入类型

text

提示词上限

500 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
modelselect否V5-V5, V5_5
soundLoopselect否false-false, true
soundTemponumber否-min 1 / max 300 / step 1-
soundKeyselect否Any-Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsAPI 可调用文本输入可用

音频 · Suno Lyrics 是 Rivya 里的歌词生成模型，适合把一个主题、情绪或故事线直接变成歌曲文本，每次生成消耗 `1` 积分。

接入文档模型页面

基础积分

1

支持模式

text-to-audio

API 输入状态

文本输入可用

输入类型

text

提示词上限

200 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

不需要额外模型参数。

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3API 可调用文本输入可用

音频 · ElevenLabs 在 Rivya 上的多角色对白模型，适合生成带有说话人切换节奏的对话音频，用于播客、访谈和角色对白。

接入文档模型页面

基础积分

14

支持模式

dialogue-to-audio

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
default_voiceselect否Adam-Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stabilityselect否0.5-0, 0.5, 1
language_codetext否---

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5API 可调用文本输入可用

音频 · ElevenLabs 在 Rivya 上的快速文本转语音模型，低延迟语音生成并支持稳定性、相似度、风格和速度调节，适合快节奏配音和口播试稿。

接入文档模型页面

基础积分

6

支持模式

text-to-speech

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选：上一段上下文",
    "next_text": "可选：下一段上下文",
    "language_code": "可选：如 en 或 zh"
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
voiceselect是TX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumber否0.5min 0 / max 1 / step 0.05-
similarity_boostnumber否0.75min 0 / max 1 / step 0.05-
stylenumber否0min 0 / max 1 / step 0.05-
speednumber否1min 0.7 / max 1.2 / step 0.05-
timestampsselect否false-false, true
previous_texttext否---
next_texttext否---
language_codetext否---

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2API 可调用文本输入可用

音频 · ElevenLabs 在 Rivya 上的多语言文本转语音模型，支持约 30 种语言自动检测，更适合全球内容本地化和跨语言配音。

接入文档模型页面

基础积分

12

支持模式

text-to-speech

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
voiceselect是TX3LPaxmHKxFdv7VOQHJ-TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stabilitynumber否0.5min 0 / max 1 / step 0.05-
similarity_boostnumber否0.75min 0 / max 1 / step 0.05-
stylenumber否0min 0 / max 1 / step 0.05-
speednumber否1min 0.7 / max 1.2 / step 0.05-
timestampsselect否false-false, true
previous_texttext否---
next_texttext否---
language_codetext否---

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2API 可调用文本输入可用

音频 · ElevenLabs 在 Rivya 上的文本生成音效模型，适合做短音效、转场声和可循环环境底音。你可以生成 0.5–22 秒音频片段，并控制提示词影响强度、循环模式和 19 种输出格式。

接入文档模型页面

基础积分

3

支持模式

text-to-audio

API 输入状态

文本输入可用

输入类型

text

提示词上限

5000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
loopselect否false-false, true
duration_secondsnumber否3min 0.5 / max 22 / step 0.5-
prompt_influencenumber否0.3min 0 / max 1 / step 0.05-
output_formatselect否mp3_44100_128-mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationAPI 可调用需要 Files API

音频 · ElevenLabs 在 Rivya 上的音频清理与人声分离模型，上传现有录音即可做人声分离、降噪和 spoken audio 清理。

接入文档模型页面

基础积分

12

支持模式

audio-to-audio

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

audio · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

这个模型不展示可运行 Public API 示例。

参考素材规则

源音频: 上传一个音频文件，Rivya 会执行分离与净化。

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

基于文件的模式需要 /api/v1/files 完成后，才能展示为完整 API-ready 示例。 Files API

参数

不需要额外模型参数。

GPT-5.5

gpt-5-5-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上的高阶 GPT 对话模型，适合复杂推理、图像辅助分析、研究整合和结构化写作。

接入文档模型页面

基础积分

5

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.4

gpt-5-4-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上更高阶的 AI 对话模型，支持更完整的结构化输入、推理强度控制与工具型对话，适合复杂分析和多步骤任务。

接入文档模型页面

基础积分

4

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.4 Codex

gpt-5.4-codex-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上更高阶的 Codex AI 编码模型，延续代码生成、结构化推理和工具协作能力，更适合仓库级开发项目。

接入文档模型页面

基础积分

4

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.3 Codex

gpt-5-3-codex-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上更强的 Codex AI 编码模型，把更先进的代码生成和更深的 agentic reasoning 合在一起，适合最高要求的开发项目。

接入文档模型页面

基础积分

4

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.2

gpt-5-2-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上的旗舰 AI 对话模型，支持高级推理、最多 6 张图片的视觉理解和 20K 字符上下文，适合研究、规划、写作和带图分析。

接入文档模型页面

基础积分

3

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.2 Codex

gpt-5-2-codex-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上更进阶的 Codex AI 编码模型，复杂工程任务推理更强，更适合长链路 agentic coding、架构判断和更大规模的重构工作。

接入文档模型页面

基础积分

4

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5.1 Codex

gpt-5-1-codex-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上升级版的 Codex AI 编码模型，代码准确性和推理更强，继续支持长输出和仓库级项目，更适合多文件重构与更稳的代码修改。

接入文档模型页面

基础积分

3

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

GPT-5 Codex

gpt-5-codex-chatAPI 可调用文本输入可用

对话 · OpenAI 在 Rivya 上的 GPT-5 Codex 代码专用模型，适合调试、实现规划、模块改造和面向真实代码库的技术问题求解，也支持视觉理解。

接入文档模型页面

基础积分

3

支持模式

responses

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Gemini 3.1 Pro

gemini-3-1-pro-chatAPI 可调用文本输入可用

对话 · Google 在 Rivya 上最新最强的 Gemini AI 对话模型，具备顶级推理、视觉理解和指令遵循能力，更适合高要求分析和创意任务。

接入文档模型页面

基础积分

3

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Gemini 3 Pro

gemini-3-pro-chatAPI 可调用文本输入可用

对话 · Google 在 Rivya 上更高深度的 Gemini AI 对话模型，推理强于 Gemini 2.5 Pro，并支持视觉理解，更适合研究整理、技术写作和更审慎的多模态分析。

接入文档模型页面

基础积分

2

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Gemini 3 Flash

gemini-3-flash-chatAPI 可调用文本输入可用

对话 · Google 在 Rivya 上新一代快速 AI 对话模型，Token 成本比 Gemini 2.5 Flash 更低、推理更强，更适合高频多模态对话、截图分流和大吞吐助手项目。

接入文档模型页面

基础积分

1

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Gemini 2.5 Pro

gemini-2-5-pro-chatAPI 可调用文本输入可用

对话 · Google 在 Rivya 上更进阶的 Gemini AI 对话模型，推理能力强于 Flash，并支持视觉理解和 20K 上下文，更适合研究整理、文档分析和结构化写作。

接入文档模型页面

基础积分

2

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Gemini 2.5 Flash

gemini-2-5-flash-chatAPI 可调用文本输入可用

对话 · Google 在 Rivya 上速度最快、成本最低的 AI 对话模型，1 积分/次，支持最多 6 张图片的视觉理解，适合快速问答、一轮摘要、截图分流和日常 AI 辅助。

接入文档模型页面

基础积分

1

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text, file

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 图片附件必须使用 Files API 返回的 file_id。

参数

不需要额外模型参数。

Claude Opus 4.7

claude-opus-4-7-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上的旗舰 Claude 对话模型，适合深度推理、谨慎整合、管理层写作和高影响文本任务。

接入文档模型页面

基础积分

8

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

Claude Opus 4.6

claude-opus-4-6-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上旗舰级的 Claude AI 对话模型，强调深度推理、复杂分析和高质量写作，适合关键任务和高要求场景。

接入文档模型页面

基础积分

8

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

Claude Sonnet 4.6

claude-sonnet-4-6-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上均衡型的 Claude AI 对话模型，延续长文理解和审慎分析能力，适合内容、研究和代码协作，又不用一开始就上 Opus 档位。

接入文档模型页面

基础积分

4

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

Claude Opus 4.5

claude-opus-4-5-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上旗舰级的 Claude AI 对话模型，深度推理、复杂分析和专家级写作表现卓越，是关键任务的高端选择。

接入文档模型页面

基础积分

8

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

Claude Sonnet 4.5

claude-sonnet-4-5-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上均衡型的 Claude AI 对话模型，擅长细腻写作、审慎分析和更克制的响应，适合内容创作和研究。

接入文档模型页面

基础积分

4

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

Claude Haiku 4.5

claude-haiku-4-5-chatAPI 可调用文本输入可用

对话 · Anthropic 在 Rivya 上轻量型的 Claude AI 对话模型，强调速度、成本效率和稳定的日常对话表现，适合高频使用场景。

接入文档模型页面

基础积分

2

支持模式

chat-completion

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId}，直到状态变为 succeeded 或 failed。

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。

参数

不需要额外模型参数。

相关页面

创建生成任务

使用 model、prompt、params、Idempotency-Key 和公共响应字段提交 Rivya API 异步生成任务。

API 模型列表

查询 Rivya API 模型，理解模型 ID、分类、提示词上限、参考素材、可用状态和 Files API 依赖。

目录

如何阅读这份参考
请求形态
动态模型参考
相关页面