↓
Rivya AI 文档

模型 API 参考

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

最近审阅于 2026年8月29日

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

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

本参考介绍的是已经实现的合同。实际调用仍要求部署已启用 Public API，并且所选模型在请求发出时显示为 API 可用。

如何阅读这份参考

  • 异步图片、视频、音频模型调用 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 上传参考素材。

  • 五个 Image5 模型都需要保留原始模型绑定 Files API 响应中的 width、height、size_bytes 和 image_dimensions_token，并分别以 width、height、sizeBytes 和 imageDimensionsToken 传入；token 缺失或过期时必须重新上传。图层拆分还要求恰好一张图片，并满足其文档规定的几何边界。

  • Grok Imagine Image 2.0 的 1–5 张标准图片编辑参考图都使用相同的已签名图片字段。仅提供提示词的请求使用文本生成图片；已签名参考图会切换到图片编辑。auto 仅用于编辑，而 Segment Map 和 Segment Edit 仍不可用。

  • Video8 视频参考需要保留 duration_seconds、duration_token、video_width、video_height、frames_per_second、video_bitrate_mbps、video_file_size_bytes 和 video_metadata_token，并分别传为 durationSeconds、durationToken、width、height、framesPerSecond、videoBitrateMbps、sizeBytes 和 videoMetadataToken；任一签名 token 缺失或过期时必须重新上传。

  • Wan 3.0 提供互斥的文本、首尾帧和多模态参考场景，并支持 Standard 或 Prime、480P/720P/1080P、六种宽高比、明确的 2–30 秒或智能时长、生成音频和 seed。图片会签名绑定 MIME、宽高和字节数；视频还要求已签名时长与视频元数据；音频时长 token 会绑定 MIME 和字节数。智能时长按 30 秒预留，且不能与参考视频同时使用。文件转视频和链接转视频快捷模式仍不可用。

  • 模型专项 Files API 限制比文件类型默认限制更严格。上传时应传入目标模型 ID，使不支持的类型、MIME、字节数、时长、宽高、帧率和码率在预留积分前失败。

  • 对 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": "claude-sonnet-5-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Chat 示例见 Chat API。

动态模型参考

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

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

API Quickstart在线调试器

GPT Image 2.5 Flare

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

图片 · 使用文字生成图片，或通过最多 16 张参考图编辑图片。支持 1K、2K、4K 分辨率，以及自动、透明和不透明背景。

接入文档模型页面

基础积分

per_image · 1K=3 · 2K=10 · 4K=16 · ⌈total⌉

支持模式

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-5-flare",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "background": "auto"
  }
}

参考素材规则

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

结果读取

创建响应会返回公开任务 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, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9
resolutionselect否1K-1K, 2K, 4K
backgroundselect否auto-auto, transparent, opaque

GPT Image 2.5 Sunburst

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

图片 · 使用文字生成图片，或通过最多 16 张参考图编辑图片。支持 1K、2K、4K 分辨率，以及自动、透明和不透明背景。

接入文档模型页面

基础积分

per_image · 1K=3 · 2K=10 · 4K=16 · ⌈total⌉

支持模式

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-5-sunburst",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "background": "auto"
  }
}

参考素材规则

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

结果读取

创建响应会返回公开任务 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, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9
resolutionselect否1K-1K, 2K, 4K
backgroundselect否auto-auto, transparent, opaque

GPT Image 2

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

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

接入文档模型页面

基础积分

per_image · 1K=3 · 2K=5 · 4K=8 · ⌈total⌉

支持模式

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 张参考图，擅长理解复杂指令并渲染空间关系准确的连贯场景。

接入文档模型页面

基础积分

per_image · medium=4 · high=22 · ⌈total⌉

支持模式

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

Z-Image

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

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

接入文档模型页面

基础积分

per_image · default=0.8 · ⌈total⌉

支持模式

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

图片 · Nano Banana 2 是 Rivya 里的新版 Nano Banana 图片模型，适合品牌视觉、产品图和参考图驱动的创意草稿；当你想要比基础档更新的 Google 图片路径时，可以从这里开始。

接入文档模型页面

基础积分

per_image · 1K=5 · 2K=8 · 4K=12 · ⌈total⌉

支持模式

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

参考素材规则

参考图片: 可上传最多 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

Nano Banana 2 Lite

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

图像 · Nano Banana 2 Lite 是 Rivya 中积分消耗更低的 Nano Banana 选项，适合快速制作产品概念图、社交图片变体和参考图引导的草稿；每次生成固定消耗 3 积分，并提供 15 种宽高比。

接入文档模型页面

基础积分

per_image · default=3 · ⌈total⌉

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image · 10 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "nano-banana-2-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto"
  }
}

参考素材规则

参考图: 最多上传 10 张 JPEG、PNG 或 WebP 图片，每张不超过 30 MB。

结果读取

创建响应会返回公开任务 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, 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-proAPI 可调用部分可用：需要 Files API

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

接入文档模型页面

基础积分

per_image · 1K=8 · 2K=8 · 4K=14 · ⌈total⌉

支持模式

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 输出，适合人像、产品构图和更宽画幅的营销视觉。

接入文档模型页面

基础积分

per_request · text_to_image=3 · image_to_image=3 · ⌈total⌉

支持模式

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

4o Image

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

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

接入文档模型页面

基础积分

per_request · text_to_image=3 · ⌈total⌉

支持模式

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 家族里更低门槛的一档。

接入文档模型页面

基础积分

per_image · default=5.5 · ⌈total⌉

支持模式

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",
    "output_format": "png",
    "nsfw_checker": "true"
  }
}

参考素材规则

参考图片: 可上传最多 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, ultra
output_formatselect否png-png, jpeg
nsfw_checkerselect否true-false, true

Seedream 5.0 Pro

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

图像 · Seedream 5.0 Pro 是 Rivya 面向广告主视觉、编辑类场景和产品构图的多参考图像模型，支持文生图、图生图、1K 或 2K 输出，以及最多 10 张参考图。

接入文档模型页面

基础积分

per_image_plus_reference_image · basic=7 · high=14 · additional_input_image=0.5 · ⌈total⌉

支持模式

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

参考素材规则

参考图: 最多上传 10 张 JPEG、PNG 或 WebP 图片，每张不超过 10 MB。

结果读取

创建响应会返回公开任务 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, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
qualityselect否basic-basic, high
output_formatselect否png-png, jpeg
nsfw_checkerselect否false-false, true

Seedream 5.0 Pro Layer Decomposition

seedream-5-pro-layer-decompositionAPI 可调用需要 Files API

图像 · Seedream 5.0 Pro Layer Decomposition 可将一张源图拆分为底图与可复用的 PNG 图层，支持用可选提示词或边界框进行引导，并提供 Auto、1K、1.5K 和 2K 尺寸。

接入文档模型页面

基础积分

per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉

支持模式

image-to-layers

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源图: 请只上传一张不超过 30 MB 的 PNG、JPEG、WebP、BMP、TIFF 或 GIF 图片；不支持 HEIC 和 HEIF。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
sizeselect否auto-auto, 1K, 1.5K, 2K
output_formatselect否jpeg-jpeg, png

Seedream 5.0 Flash

seedream-5-flash这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Seedream 5.0 Flash — 该模型已公布。Rivya 正在核验输入规则、计费和内容，完成验证前暂不开放生成。请选择可用的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Seedream 5.0 Flash Layer Decomposition

seedream-5-flash-layer-decomposition这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Seedream 5.0 Flash Layer Decomposition — 该模型已公布。Rivya 正在核验输入规则、计费和内容，完成验证前暂不开放生成。请选择可用的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Seedream 4.5

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

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

接入文档模型页面

基础积分

per_image · default=6.5 · ⌈total⌉

支持模式

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-0这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Seedream 4.0 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 10 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Seedream 3.0

seedream-3-0这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Seedream 3.0 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Grok Imagine Image 2.0

grok-imagine-image-2-0API 可调用部分可用：需要 Files API

图像 · Grok Imagine Image 2.0 支持生成单张图像的文生图和标准图像编辑；编辑请求可使用 1 至 5 张已签名的参考图，并提供 5 种固定宽高比和仅限编辑请求的自动比例。

接入文档模型页面

基础积分

per_image · text_to_image=4 · image_edit=4 · ⌈total⌉

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image · 5 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图: 上传 1 至 5 张 JPEG、PNG 或 WebP 图片，每张不超过 10 MB；每张参考图都必须携带已签名的上传元数据。

结果读取

创建响应会返回公开任务 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, auto

Grok Imagine

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

图片 · xAI 图片模型，创意解读能力强，支持 5 种宽高比；标准文生图每次返回 2 张图，质量档每次返回 4 张图。

接入文档模型页面

基础积分

per_request · standard=4 · standard_output_images=2 · quality=5 · quality_output_images=4 · image_to_image=4 · ⌈total⌉

支持模式

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",
    "nsfw_checker": "false",
    "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
nsfw_checkerselect否false-false, true
enable_proselect否false-false, true

Flux 2 Pro

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

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

接入文档模型页面

基础积分

per_image · 1K=5 · 2K=7 · ⌈total⌉

支持模式

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",
    "nsfw_checker": "false"
  }
}

参考素材规则

参考图片: 可上传最多 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
nsfw_checkerselect否false-false, true

Flux 2 Flex

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

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

接入文档模型页面

基础积分

per_image · 1K=14 · 2K=24 · ⌈total⌉

支持模式

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",
    "nsfw_checker": "false"
  }
}

参考素材规则

参考图片: 可上传最多 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
nsfw_checkerselect否false-false, true

Flux Kontext Max

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

图片 · BFL 当前把 FLUX.1 Kontext [max] 标为上一代，并建议新项目使用 FLUX.2。 Black Forest Labs 的 Flux Kontext 增强模型，面向要求更高的提示词生成和图片编辑任务。Rivya 在同一个模型页提供文生图和图生图，均固定为每次 8 积分。

接入文档模型页面

基础积分

per_image · default=8 · ⌈total⌉

支持模式

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

图片 · BFL 当前把 FLUX.1 Kontext [pro] 标为上一代，并建议新项目使用 FLUX.2。 Black Forest Labs 的低成本 Flux Kontext 模型，适合文生图和单图编辑。Rivya 在同一个模型页提供两种模式，均固定为每次 4 积分。

接入文档模型页面

基础积分

per_image · default=4 · ⌈total⌉

支持模式

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否---

Qwen Image 3.0

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

图像 · Qwen Image 3.0 是 Rivya 中参数配置较丰富的 Qwen 图像模型，适合中文或英文提示词、参考图引导的版式，以及可复现的视觉测试；支持 1K 或 2K 输出、提示词扩写、负面提示词和种子控制。

接入文档模型页面

基础积分

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

800 字符

参考素材

image · 3 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选：填写希望避免的元素或失败情况，最多 5,000 个字符。",
    "seed": 1
  }
}

参考素材规则

参考图: 最多上传 3 张 JPEG、PNG、WebP、BMP、GIF 或 TIFF 图片，每张不超过 10 MB。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
resolutionselect是1K-1K, 2K
image_sizeselect否16:9-1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_formatselect否png-png, jpeg
prompt_extendselect否true-true, false
nsfw_checkerselect否false-false, true
negative_prompttext否---
seednumber否1min 0 / max 2147483647 / step 1-

Qwen Image 3.0 Pro

qwen-image-3-proAPI 可调用部分可用：需要 Files API

图像 · Qwen Image 3.0 Pro 是 Rivya 中独立的 Pro 级 Qwen 图像模型，适合制作精致的广告主视觉、产品场景和海报概念；支持中文或英文提示词、最多 3 张参考图，以及价格不同的 1K 与 2K 档位。

接入文档模型页面

基础积分

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

支持模式

text-to-image, image-to-image

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

800 字符

参考素材

image · 3 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "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": "可选：填写希望避免的元素或失败情况，最多 5,000 个字符。",
    "seed": 1
  }
}

参考素材规则

参考图: 最多上传 3 张 JPEG、PNG、WebP、BMP、GIF 或 TIFF 图片，每张不超过 10 MB。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
resolutionselect是1K-1K, 2K
image_sizeselect否16:9-1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_formatselect否png-png, jpeg
prompt_extendselect否true-true, false
nsfw_checkerselect否false-false, true
negative_prompttext否---
seednumber否1min 0 / max 2147483647 / step 1-

Qwen Image 2.1

qwen2-1-image这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Qwen Image 2.1 — 该模型已公布。Rivya 正在核验输入规则、计费和内容，完成验证前暂不开放生成。请选择可用的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Qwen2 Image

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

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

接入文档模型页面

基础积分

per_image · default=5.6 · ⌈total⌉

支持模式

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, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9
output_formatselect否png-png, jpeg
seednumber否-min 0-
nsfw_checkerselect否false-false, true

Qwen Image

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

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

接入文档模型页面

基础积分

per_output_megapixel · default=4 · ⌈total⌉

支持模式

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

midjourney这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Midjourney 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 4 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: Midjourney 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Recraft Remove Background

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

图片 · Recraft 在 Rivya 上的去背景模型，适合从现有图片中干净地分离主体。它更适合透明背景抠图、主体分离，以及为下一步设计准备干净源图。

接入文档模型页面

基础积分

per_image · default=1 · ⌈total⌉

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源图片: 仅上传 1 张 JPG、PNG 或 WebP 图片，最大 5 MB、16 MP，宽高均须为 256–4096 px。

结果读取

创建响应会返回公开任务 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 上的轻量图片放大模型，适合对一张已经选定的图片做低成本锐化和清晰度补强，而不是直接上更重的交付级放大。

接入文档模型页面

基础积分

per_image · default=0.5 · ⌈total⌉

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源图片: 仅上传 1 张 JPG、PNG 或 WebP 图片，最大 10 MB。

结果读取

创建响应会返回公开任务 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

图片 · 在 Rivya 里，Wan 2.7 Image Pro 当前支持文生图、图生图。这个选项也支持带入最多 9 张参考图片。 每张图片固定 12 积分; 每次请求返回一张图片.

接入文档模型页面

基础积分

per_image · default=12 · ⌈total⌉

支持模式

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 个图片参考素材，用于图像编辑项目。 JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

结果读取

创建响应会返回公开任务 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

图片 · 在 Rivya 里，Wan 2.7 Image 当前支持文生图、图生图。这个选项也支持带入最多 9 张参考图片。 每张图片固定 5 积分; 每次请求返回一张图片.

接入文档模型页面

基础积分

per_image · default=4.8 · ⌈total⌉

支持模式

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 个图片参考素材，用于图像编辑项目。 JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

结果读取

创建响应会返回公开任务 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 积分、单张输出项目接入，并开放公开文档里可稳定承接的提示词、反向提示词、宽高比和种子参数。

接入文档模型页面

基础积分

per_image · default=12 · ⌈total⌉

支持模式

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, auto
negative_prompttext否---
seedtext否---

Google Imagen4

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

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

接入文档模型页面

基础积分

per_request · default=8 · ⌈total⌉

支持模式

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, auto
negative_prompttext否---
seedtext否---

Google Imagen4 Fast

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

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

接入文档模型页面

基础积分

per_request · default=4 · ⌈total⌉

支持模式

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": 1
  }
}

参考素材规则

-

结果读取

创建响应会返回公开任务 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, auto
negative_prompttext否---
seednumber否---

Topaz Image Upscaler

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

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

接入文档模型页面

基础积分

per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉

支持模式

image-to-image

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源图片: 仅限 1 张 JPEG、PNG 或 WebP 图片，最大 10 MB；输出最长边 ≤ 8192 px。

结果读取

创建响应会返回公开任务 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

Ideogram V3

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

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

接入文档模型页面

基础积分

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

支持模式

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": 1,
    "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否---
negative_prompttext否---

Ideogram V3 Reframe

ideogram-v3-reframe这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

图片 · Ideogram V3 Reframe 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: Ideogram V3 Reframe 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Ideogram V3 Remix

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

图片 · Ideogram V3 Remix: 每张图 TURBO 4 / BALANCED 7 / QUALITY 10 积分. 可选 1–4 张输出。总价按单张价格乘以所选张数计算，并向上取整到整数积分。

接入文档模型页面

基础积分

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

支持模式

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
num_imagesselect否1-1, 2, 3, 4
seednumber否---
strengthnumber否0.8min 0.01 / max 1-
negative_prompttext否---

Ideogram Character

ideogram-characterAPI 可调用需要 Files API

图片 · 面向角色一致性的专门入口，把 1 张已经定下来的角色图延展到新场景、新服装和新尺寸。适合你更在意身份保留，而不是开放式图片编辑，并且一次只需要 1 张输出图。 每张图 TURBO 12 / BALANCED 18 / QUALITY 24 积分. 可选 1–4 张输出。总价按单张价格乘以所选张数计算，并向上取整到整数积分。

接入文档模型页面

基础积分

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

支持模式

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
num_imagesselect否1-1, 2, 3, 4
seednumber否---
negative_prompttext否---

Seedance 2.5

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

视频 · Seedance 2.5 是 Rivya 上规模更大的 Seedance 工作流，支持纯提示词视频、首尾帧引导、多模态参考和视频引导转换。相较 Mini，它增加了 1080p 档、最长 30 秒输出、自动时长、MP4 或 MOV 输出，并显著扩大了图片、视频与音频参考容量。

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

30000 字符

参考素材

image, video, audio · 50 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

引导帧或大容量参考素材: 帧场景接受 1 至 2 张 JPEG、PNG、WebP、BMP、GIF 或 TIFF 图片，每张不超过 30 MB。参考场景接受最多 30 张图片、10 段不超过 95 MB 且每段 2-30 秒的 MP4/MOV 视频，以及 10 个不超过 15 MB 且每个 2-30 秒的 MP3/WAV 音频文件；视频与音频总时长分别不得超过 30 秒，全部媒体合计不得超过 50 个文件。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

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

Seedance 2.0

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

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

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

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-720p, 1080p, 4K
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 可调用部分可用：需要 Files API

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

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image, video, audio · 15 个文件

请求

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

参考素材规则

多模态参考: 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.

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

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 Mini

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

视频 · Seedance 2.0 Mini 是 Rivya 上费率较低的 Seedance 多模态工作流，支持纯提示词视频、首帧或首尾帧动画，以及图片、视频或音频混合参考。480p 与 720p 两档覆盖 4 至 15 秒输出，并确保三种输入场景互斥。

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image, video, audio · 15 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

引导帧或多模态参考素材: 帧场景接受 1 至 2 张 JPEG/PNG/WebP/GIF 图片，每张不超过 30 MB。参考场景接受最多 9 张此类图片、3 段不超过 50 MB 且每段 2-15 秒的 MP4/MOV/MKV 视频，以及 3 个不超过 15 MB 且每个 2-15 秒的 MP3/WAV 音频文件；视频与音频总时长分别不得超过 15 秒。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

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 / step 1-
generate_audioselect否true-true, false
web_searchselect否false-false, true
nsfw_checkerselect否true-false, true

Seedance 1.5 Pro

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

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

接入文档模型页面

基础积分

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⌉

支持模式

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",
    "nsfw_checker": "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
durationnumber否8min 4 / max 12 / step 1-
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
nsfw_checkerselect否false-false, true

Seedance 1.0 Pro

seedance-1-0-pro这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Seedance 1.0 Pro 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Seedance 1.0 Pro Fast

seedance-1-0-pro-fast这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Seedance 1.0 Pro Fast 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Seedance 1.0 Lite

seedance-1-0-lite这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Seedance 1.0 Lite 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

HappyHorse 1.1

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

视频 · HappyHorse 1.1 是一款灵活的 AI 视频模型，可生成纯提示词视频、单图动画和多图参考视频，支持 720p 或 1080p 分辨率，输出时长为 3 至 15 秒。

接入文档模型页面

基础积分

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

4999 字符

参考素材

image · 9 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

首帧图片或参考图片: 上传一张 JPEG、PNG 或 WebP 图片制作首帧动画，或上传 2 至 9 张图片生成参考引导视频。每个文件最大为 20 MB。

结果读取

创建响应会返回公开任务 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, 4:5, 5:4, 9:21, 21:9
durationnumber否5min 3 / max 15 / step 1-

HappyHorse 1.0

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

视频 · HappyHorse 1.0 在 Rivya 的同一模型页中支持文生视频、单图图生视频和多图参考视频。

接入文档模型页面

基础积分

per_output_second · 720p=28 · 1080p=48 · ⌈total⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image · 9 个文件

请求

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,
    "seed": 0
  }
}

参考素材规则

参考素材: 图生视频必须使用 1 张图片，参考视频可使用 2 到 9 张图片。图片须为 JPEG、PNG 或 WebP，且不超过 10 MB；单图模式要求宽和高均不低于 300 像素，参考模式要求短边不低于 400 像素。

结果读取

创建响应会返回公开任务 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-
seednumber否0min 0 / max 2147483647-

Wan 3.0 Video

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

视频 · Wan 3.0 Video 将标准版与 Prime 档位、文生视频、首尾帧引导和已签名多模态参考整合到同一模型。它支持 480P、720P 或 1080P 输出，可选明确的 2–30 秒或智能时长，并可接收由图片、视频和音频组成的参考素材包。

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image, video, audio · 20 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

引导帧或已签名多模态参考: 首尾帧场景接收一张必需首帧图片和一张可选尾帧图片。参考场景最多接收 10 张 JPEG、无透明通道 PNG、WebP 或 BMP 图片，单张 20 MB；5 段 MP4/MOV 视频，单段 95 MB、1–15 秒；以及 5 段 MP3/WAV 音频，单段 15 MB、1–15 秒；视频和音频各自合计最多 15 秒。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
seedance_sceneselect否text-text, frames, reference
variantselect否standard-standard, prime
resolutionselect否1080P-480P, 720P, 1080P
aspect_ratioselect否adaptive-adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
durationnumber否5min -1 / max 30 / step 1-
audioselect否true-true, false
seednumber否-min 0 / max 2147483647 / step 1-

Wan 2.7 Video

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

视频 · 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.

接入文档模型页面

基础积分

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

支持模式

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": "negative_prompt ≤ 500",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

参考素材规则

参考素材: 参考素材: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

结果读取

创建响应会返回公开任务 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
durationnumber否5min 0 / max 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 2.6 支持不附媒体的文字生成视频、恰好 1 张图片的图片生成视频，以及使用 1–3 个视频的视频编辑；图片与视频不能混用。 文字和图片输入支持 5、10 或 15 秒；视频输入只支持 5 或 10 秒。

接入文档模型页面

基础积分

per_video · 720p_5=70 · 720p_10=140 · 720p_15=210 · 1080p_5=104.5 · 1080p_10=209.5 · 1080p_15=315 · ⌈total⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

5000 字符

参考素材

image, video · 3 个文件

请求

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": "1080p",
    "duration": "5",
    "multi_shots": "false",
    "nsfw_checker": "true"
  }
}

参考素材规则

参考素材: 请使用恰好 1 张 JPG/PNG/WebP 图片（至少 256×256、最大 10 MB）或 1–3 个 MP4/MOV 视频（每个最大 10 MB）。

结果读取

创建响应会返回公开任务 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
durationselect否5-5, 10, 15
multi_shotsselect否false-false, true
nsfw_checkerselect否true-false, true

Wan 2.6 Flash

wan-2-6-flash这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Wan 2.6 Flash / 暂时不可用 — 这是暂时的定价与接入安全暂停，不是 Coming Soon。页面保持可索引，但在完整价格合同稳定前，生成入口和可调用报价都保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

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`。

接入文档模型页面

基础积分

per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

800 字符

参考素材

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

参考素材规则

参考图片: 可上传最多 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否---

Wan 2.2 A14B Turbo

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

视频 · 文字和图片输入支持 480p 或 720p（5 秒分别为 40、80 积分）。图片加音频还支持 580p；其 480p / 580p / 720p 按输出每秒 12 / 18 / 24 积分计费。

接入文档模型页面

基础积分

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⌉

支持模式

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 4-
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 可调用需要 Files API

视频 · 如果源视频的动作和镜头已经符合要求，只需要更换画面主体，Wan 动画替换最合适；如果整条视频都需要重新设计，就该回到提示词驱动生成；如果要做的不只是主体替换，而是更广泛的视频编辑，则应该选择功能更完整的编辑项目。

接入文档模型页面

基础积分

per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

video, image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

video: video, image

结果读取

创建响应会返回公开任务 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, 580p, 720p

Wan Animate 2

wan-animate-2这个模型已规划接入 Public API，但目前还不能调用。这个模型已规划接入 Public API，但目前还不能调用。

视频 · Wan Animate 2 是 Coming Soon 的视频生视频条目。公开角色动画定位并不构成 Rivya 可调用合同或定价。

模型页面

基础积分

这个模型已规划接入 Public API，但目前还不能调用。

支持模式

API 输入状态

这个模型已规划接入 Public API，但目前还不能调用。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型已规划接入 Public API，但目前还不能调用。

参数

不需要额外模型参数。

MiniMax H3

minimax-h3API 可调用部分可用：需要 Files API

视频 · MiniMax H3 是 Rivya 上支持 768P 或 2K 的视频模型，可用于纯提示词生成、首尾帧动画和多模态参考创作。参考路径可组合图片、MP4 或 MOV 视频，以及 MP3 或 WAV 音频；积分公式还会分别计入已验证的输入视频时长和超过前 5 张的图片。

接入文档模型页面

基础积分

per_input_and_output_second · 768P=8 · 2K=13 · additional_image_after_five=4 · ⌈total⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

7000 字符

参考素材

image, video, audio · 15 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

引导帧或多模态参考素材: 帧场景接受 1 至 2 张 JPEG、PNG 或 WebP 图片，每张不超过 30 MB。参考场景接受最多 9 张此类图片、3 段不超过 50 MB 且每段 2-15 秒的 MP4/MOV 视频，以及 3 个不超过 15 MB 且每个 2-15 秒的 MP3/WAV 音频文件；视频与音频总时长分别不得超过 15 秒，全部媒体合计不得超过 15 个文件，且音频不能单独使用。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
seedance_sceneselect否text-text, frames, reference
resolutionselect否2K-768P, 2K
aspect_ratioselect否16:9-adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
minimax_single_frame_roleselect否first-first, last
durationnumber否6min 4 / max 15 / step 1-

Hailuo 2.3

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

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

接入文档模型页面

基础积分

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⌉

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 可上传最多 1 个图片参考素材，用于对应的生成模式。 JPG / PNG / WebP · ≤ 10 MB · 1 image.

结果读取

创建响应会返回公开任务 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
nsfw_checkerselect否true-false, true

Hailuo Pro

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

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

接入文档模型页面

基础积分

per_video · 1080P_6=57 · ⌈total⌉

支持模式

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": "true",
    "nsfw_checker": "true"
  }
}

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会作为尾帧图参与生成。 · JPG / PNG / WebP · ≤ 10 MB

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

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

Hailuo Standard

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

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

接入文档模型页面

基础积分

per_video · text_6=30 · text_10=50 · image_512P_6=12 · image_512P_10=20 · image_768P_10=50 · ⌈total⌉

支持模式

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": "768P",
    "prompt_optimizer": "true"
  }
}

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会作为尾帧图参与生成。 JPG / PNG / WebP · ≤ 10 MB.

结果读取

创建响应会返回公开任务 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否768P-512P, 768P
prompt_optimizerselect否true-false, true

Kling 4.0

kling-4-0这个模型已规划接入 Public API，但目前还不能调用。这个模型已规划接入 Public API，但目前还不能调用。

视频 · Kling 4.0 — 即将推出. Kling 4.0 目前只是即将推出的检索页；当前创作请使用可用的替代模型。

模型页面

基础积分

这个模型已规划接入 Public API，但目前还不能调用。

支持模式

API 输入状态

这个模型已规划接入 Public API，但目前还不能调用。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型已规划接入 Public API，但目前还不能调用。

参数

不需要额外模型参数。

Kling 4.0 Flash

kling-4-0-flash这个模型已规划接入 Public API，但目前还不能调用。这个模型已规划接入 Public API，但目前还不能调用。

视频 · Kling 4.0 Flash — 即将推出. Kling 4.0 Flash 目前只是即将推出的检索页；当前创作请使用可用的替代模型。

模型页面

基础积分

这个模型已规划接入 Public API，但目前还不能调用。

支持模式

API 输入状态

这个模型已规划接入 Public API，但目前还不能调用。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型已规划接入 Public API，但目前还不能调用。

参数

不需要额外模型参数。

Kling 3.0

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

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

接入文档模型页面

基础积分

per_output_second · 720p_without_audio=14 · 720p_with_audio=20 · 1080p_without_audio=18 · 1080p_with_audio=27 · 4K=67 · ⌈total⌉

支持模式

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-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, 4k
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

视频 · 严格的 1 图 + 1 动作视频项目，身份和动作来源划分很清楚 Standard (720P) 20 × 经验证动作视频秒数；Pro (1080P) 27 × 秒数

接入文档模型页面

基础积分

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

2500 字符

参考素材

image, video · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图 + 动作视频: 严格的 1 图 + 1 动作视频项目，身份和动作来源划分很清楚 Standard (720P) 20 × 经验证动作视频秒数；Pro (1080P) 27 × 秒数

结果读取

创建响应会返回公开任务 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 3.0 Turbo

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

视频 · Kling 3.0 Turbo 是 Rivya 上专注于纯提示词生成和单张静态图片动画的 Kling 视频模型。两种路径均支持 720p 与 1080p 输出，时长可设为 3 至 15 秒之间的整数；画幅比例仅适用于文生视频。

接入文档模型页面

基础积分

per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

2500 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "kling-3-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

参考素材规则

可选的起始图片: 图生视频必须上传恰好 1 张不超过 10 MB 的 JPEG 或 PNG 图片；文生视频不使用上传素材。

结果读取

创建响应会返回公开任务 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
durationnumber否5min 3 / max 15 / step 1-
aspect_ratioselect否16:9-1:1, 9:16, 16:9

Kling O3

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

视频 · 当前开放可完整验证的单镜头文字生成，以及单张首帧或首尾帧两图生成。

接入文档模型页面

基础积分

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⌉

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

3072 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 图生视频最多上传 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-720p, 1080p, 4k
durationselect否5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
audioselect否false-false, true
aspect_ratioselect否16:9-16:9, 9:16, 1:1

Kling 2.6

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

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

接入文档模型页面

基础积分

per_video · 5s_without_audio=55 · 5s_with_audio=110 · 10s_without_audio=110 · 10s_with_audio=220 · ⌈total⌉

支持模式

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 个图片参考素材，用于对应的生成模式。 JPEG/PNG ≤ 10 MB.

结果读取

创建响应会返回公开任务 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 那组额外场景控制时使用。

接入文档模型页面

基础积分

per_output_second · 720p=11 · 1080p=18 · ⌈total⌉

支持模式

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 积分。

接入文档模型页面

基础积分

per_video · 5s=42 · 10s=84 · ⌈total⌉

支持模式

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 张图会映射到尾帧。 JPEG/PNG ≤ 10 MB.

结果读取

创建响应会返回公开任务 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 / step 0.1-

Kling V2.1 Master

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

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

接入文档模型页面

基础积分

per_video · 5s=160 · 10s=320 · ⌈total⌉

支持模式

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 张图片切换到图生视频模式；不上传图片时继续走文生视频。 JPEG/PNG ≤ 10 MB.

结果读取

创建响应会返回公开任务 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 / step 0.1-

Kling V2.1 Pro

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

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

接入文档模型页面

基础积分

per_video · 5s=50 · 10s=100 · ⌈total⌉

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频最多可上传 2 张图片，第 2 张会映射到尾帧图。 JPEG/PNG ≤ 10 MB.

结果读取

创建响应会返回公开任务 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 / step 0.1-

Kling V2.1 Standard

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

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

接入文档模型页面

基础积分

per_video · 5s=25 · 10s=50 · ⌈total⌉

支持模式

image-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

5000 字符

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考图片: 图生视频最多可上传 1 张图片作为首帧参考。 JPEG/PNG ≤ 10 MB.

结果读取

创建响应会返回公开任务 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 / step 0.1-

Kling AI Avatar Pro

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

视频 · 快手可灵 AI Avatar Pro 高质量数字人口播模型，使用 1 张人物图和 1 段音频生成口型同步视频。Rivya 按经验证的音频时长以 16 积分 / 秒计费，音频最长 300 秒，总积分向上取整。

接入文档模型页面

基础积分

per_input_second · default=16 · ⌈total⌉

支持模式

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 积分 / 秒计费，音频最长 300 秒，总积分向上取整。

接入文档模型页面

基础积分

per_input_second · default=8 · ⌈total⌉

支持模式

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 积分 / 秒。

接入文档模型页面

基础积分

per_input_second · 480p=3 · 720p=12 · ⌈total⌉

支持模式

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

接入文档模型页面

基础积分

per_video · 720p_5s=12 · 720p_10s=30 · 1080p_5s=30 · ⌈total⌉

支持模式

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 积分。

接入文档模型页面

基础积分

per_video · default=90 · ⌈total⌉

支持模式

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否---

Luma Modify Video

luma-modify-video这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Luma Modify Video 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

video · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

video: video

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Grok Imagine Video 1.5 Preview

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

视频 · Grok Imagine Video 1.5 Preview 支持 1～15 秒、480p 或 720p、最多 7 张参考图，以及最长 4096 字符的提示词。

接入文档模型页面

基础积分

per_output_second · 480p=2.4 · 720p=4.5 · ⌈total⌉

支持模式

text-to-video, image-to-video

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

4096 字符

参考素材

image · 7 个文件

请求

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": {
    "duration": 8,
    "resolution": "480p",
    "aspect_ratio": "auto",
    "nsfw_checker": "true"
  }
}

参考素材规则

参考图片: 最多 7 张 JPEG、PNG 或 WebP 图片，每张不超过 20MB。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
durationnumber否8min 1 / max 15 / step 1-
resolutionselect否480p-480p, 720p
aspect_ratioselect否auto-auto, 1:1, 16:9, 9:16, 3:2, 2:3
nsfw_checkerselect否true-true, false

Sora 2 Pro

sora-2-pro这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Sora 2 Pro 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Sora 2

sora-2这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Sora 2 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

image · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

image: image

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Sora Watermark Remover

sora-watermark-remover这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · Sora Watermark Remover 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Topaz Video Upscaler

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

视频 · 仅接收 1 个已上传视频，不使用提示词；放大倍率为 1x、2x 或 4x，默认 2x。

接入文档模型页面

基础积分

per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉

支持模式

video-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

video · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源视频: Rivya 接受 1 个不超过 10MB 的 MP4、MOV 或 MKV 文件；上游接口允许 50MB，因此站内采用更严格的限制。

结果读取

创建响应会返回公开任务 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

视频 · 720p 扣 225 积分，1080p 扣 233 积分（232.5 向上取整），4K 扣 285；Extend 扣 225，符合条件的 1080p／4K 结果操作扣 8／60。 音频能力仍属实验性且不保证可用；交付前必须逐条人工检查。 升分辨率操作只接受本人成功的 720p 基础任务或 Extend 结果；直接生成的 1080p／4K 结果不能再次处理。

接入文档模型页面

基础积分

per_video · generate_720p=225 · generate_1080p=232.5 · generate_4K=285 · extend_quality=225 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支持模式

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": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "可选水印文本",
    "enableTranslation": "true"
  }
}

参考素材规则

参考图片: 上传 1 张图时以它为起始画面，上传 2 张图时以前后帧方式生成过渡视频。 JPEG / PNG · 1–2 · 10 MB.

结果读取

创建响应会返回公开任务 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
aspectRatioselect否16:9-16:9, 9:16, Auto
resolutionselect否720p-720p, 1080p, 4k
durationselect否8-4, 6, 8
watermarktext否---
enableTranslationselect否true-true, false

Veo3.1 Fast

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

视频 · 支持纯文本、首尾帧和 1～3 张参考图生成，可直接选择 720p／1080p／4K 和 4／6／8 秒。 音频能力仍属实验性且不保证可用；交付前必须逐条人工检查。

接入文档模型页面

基础积分

per_video · generate_720p=30 · generate_1080p=37.5 · generate_4K=90 · extend_fast=30 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支持模式

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": "TEXT_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "可选水印文本",
    "enableTranslation": "true"
  }
}

参考素材规则

参考图片: 参考图模式接受 1～3 张已验证的 JPEG 或 PNG，每张不超过 10 MB，只支持 16:9／9:16，且时长必须为 8 秒。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
generationTypeselect否TEXT_2_VIDEO-TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatioselect否16:9-16:9, 9:16, Auto
resolutionselect否720p-720p, 1080p, 4k
durationselect否8-4, 6, 8
watermarktext否---
enableTranslationselect否true-true, false

Veo3.1 Lite

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

视频 · 支持纯文本、首尾帧和 1～3 张参考图生成，可直接选择 720p／1080p／4K 和 4／6／8 秒。 音频能力仍属实验性且不保证可用；交付前必须逐条人工检查。

接入文档模型页面

基础积分

per_video · generate_720p=15 · generate_1080p=22.5 · generate_4K=75 · extend_lite=15 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支持模式

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

参考素材规则

参考图片: 参考图模式接受 1～3 张已验证的 JPEG 或 PNG，每张不超过 10 MB，只支持 16:9／9:16，且时长必须为 8 秒。

结果读取

创建响应会返回公开任务 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
resolutionselect否720p-720p, 1080p, 4k
durationselect否8-4, 6, 8
watermarktext否---
enableTranslationselect否true-true, false

Flux 3

flux-3这个模型已规划接入 Public API，但目前还不能调用。这个模型已规划接入 Public API，但目前还不能调用。

视频 · Flux 3 出现在即将推出的视频目录中，并带有“文生视频”和“图生视频”标签。Rivya 将本页作为状态参考，不把尚未公布的控制项或运行行为写成承诺。

模型页面

基础积分

这个模型已规划接入 Public API，但目前还不能调用。

支持模式

API 输入状态

这个模型已规划接入 Public API，但目前还不能调用。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型已规划接入 Public API，但目前还不能调用。

参数

不需要额外模型参数。

Gemini Omni 1.1 Flash

gemini-omni-flash-1-1API 可调用部分可用：需要 Files API

视频 · 用文字、参考图或源视频生成视频。支持 16:9、9:16 和 4、6、8、10 秒；有视频输入时，输出时长由模型决定。

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image, video · 7 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 最多七张图片，每张 20 MB；或一个不超过 95 MB、30 秒的视频搭配最多五张图。视频截取片段不得超过 10 秒。不支持音频或角色素材 ID。 首尾帧模式只接受一张起始图或一对首尾图，不能混用其他参考素材。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
reference_modeselect否reference-reference, frames
resolutionselect否720p-360p, 720p, 1080p, 4k
durationselect否4-4, 6, 8, 10
aspect_ratioselect否16:9-16:9, 9:16
seednumber否-min 0 / max 2147483647-
video_startnumber否-min 0 / max 30-
video_endsnumber否-min 0 / max 30-

Gemini Omni Video

gemini-omni-videoAPI 可调用部分可用：需要 Files API

视频 · 用文字、参考图或源视频生成视频。支持 16:9、9:16 和 4、6、8、10 秒；有视频输入时，输出时长由模型决定。

接入文档模型页面

基础积分

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⌉

支持模式

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

API 输入状态

部分可用：需要 Files API

输入类型

text, file

提示词上限

20000 字符

参考素材

image, video · 7 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

参考素材: 最多七张图片，每张 20 MB；或一个不超过 95 MB、30 秒的视频搭配最多五张图。视频截取片段不得超过 10 秒。不支持音频或角色素材 ID。

结果读取

创建响应会返回公开任务 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, 4k
durationselect否4-4, 6, 8, 10
aspect_ratioselect否16:9-16:9, 9:16
seednumber否-min 0 / max 2147483647-
video_startnumber否-min 0 / max 30-
video_endsnumber否-min 0 / max 30-

OmniHuman 1.5

omnihuman-1-5API 可调用需要 Files API

视频 · OmniHuman 1.5 可将恰好一张肖像图片和一段音频转换为音频驱动的角色视频，支持 720p 或 1080p 输出，积分按验签后的音频时长计算。

接入文档模型页面

基础积分

per_input_second · default=27 · ⌈total⌉

支持模式

image-audio-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

300 字符

参考素材

image, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

肖像图片和音频: 上传恰好一张 JPEG、PNG 或 WebP 肖像，大小不超过 10 MB，以及一个 MP3、M4A、WAV、AAC 或 OGG 音频文件，大小不超过 10 MB 且时长小于 60 秒。

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

参数

key类型必填默认值范围枚举值
output_resolutionselect否1080-720, 1080
pe_fast_modeselect否false-false, true
seednumber否-1--

Volcengine Video Lip Sync

volcengine-video-lip-syncAPI 可调用需要 Files API

视频 · Volcengine Video Lip Sync 可让一个现有视频中的说话动作改为跟随一条目标人声轨道，支持 Lite 或 Basic 处理模式，并按时长计费。 输出为 25 FPS 的 MP4，时长跟随目标音频。

接入文档模型页面

基础积分

per_input_second · default=8 · ⌈total⌉

支持模式

video-audio-to-video

API 输入状态

需要 Files API

输入类型

file

提示词上限

-

参考素材

video, audio · 2 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

源视频和目标音频: 上传恰好一个 MP4 或 MOV 视频，大小不超过 95 MB，以及一条 MP3、M4A、WAV、AAC 或 OGG 人声轨道，大小不超过 10 MB。

结果读取

创建响应会返回公开任务 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是lite-lite, basic
separate_vocalselect否false-false, true
open_scenedetselect否false-false, true
align_audioselect否true-true, false
align_audio_reverseselect否false-false, true
templ_start_secondsnumber否0min 0-

PixVerse V6

pixverse-v6这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

视频 · PixVerse V6 — 暂时不可用. 这是暂时的定价与接入安全暂停，不是 Coming Soon。页面保持可索引，但在完整价格合同稳定前，生成入口和可调用报价都保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Suno Music

suno-music这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · Suno Music 暂时不可用：新的生成规则要求额外输入，当前表单尚未适配。已有作品仍可查看和下载；新任务保持停用。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Suno Sounds

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

音频 · 用 Suno Sounds 将文字描述转为氛围音、循环音效和简短声音草稿。

接入文档模型页面

基础积分

per_request · generate_sounds=2.5 · separate_vocal=10 · ⌈total⌉

支持模式

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": "V6",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

参数

key类型必填默认值范围枚举值
modelselect否V6-V6, V6_MINI, V6_WILD
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 将主题、情绪或故事转化为歌词，每次生成消耗 1 积分。

接入文档模型页面

基础积分

per_request · generate_lyrics=0.4 · ⌈total⌉

支持模式

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 上的多角色对白模型，适合生成带有说话人切换节奏的对话音频，用于播客、访谈和角色对白。

接入文档模型页面

基础积分

per_1000_characters · dialogue_text=14 · ⌈total⌉

支持模式

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 上的快速文本转语音模型，低延迟语音生成并支持稳定性、相似度、风格和速度调节，适合快节奏配音和口播试稿。

接入文档模型页面

基础积分

per_1000_characters · text=6 · ⌈total⌉

支持模式

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 种语言自动检测，更适合全球内容本地化和跨语言配音。

接入文档模型页面

基础积分

per_1000_characters · text=12 · ⌈total⌉

支持模式

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否---

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · ElevenLabs Sound Effect V2 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供音效生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

ElevenLabs Audio Isolation

elevenlabs-audio-isolation这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · ElevenLabs Audio Isolation 当前无法在 Rivya 使用。本页仅保留历史能力参考，不提供生成、不创建任务，也不扣除积分。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

audio · 1 个文件

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

audio: audio

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.8 Flash TTS

gemini-3-8-flash-tts这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · Gemini 3.8 Flash TTS 已公开列入文本转语音和对白转语音范围，但 Rivya 当前暂不开放使用，因为在任务开始前还无法可靠确定音频输出 Token 的最高成本。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.8 Flash-Lite TTS

gemini-3-8-flash-lite-tts这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · Gemini 3.8 Flash-Lite TTS 已公开列入文本转语音和对白转语音范围，但 Rivya 当前暂不开放使用，因为在任务开始前还无法可靠确定音频输出 Token 的最高成本。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.1 Flash TTS

gemini-3-1-flash-tts这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · Gemini 3.1 Flash TTS 已公开列入文本转语音和对白转语音范围，但 Rivya 当前暂不开放使用，因为在任务开始前还无法可靠确定音频输出 Token 的最高成本。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 2.5 Pro TTS

gemini-2-5-pro-tts这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

音频 · Gemini 2.5 Pro TTS 已有公开的文本转语音和对白转语音说明；在能够为所有允许的脚本可靠预留最高积分成本之前，Rivya 会保持暂时不可用状态。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT 6.1 Sol

gpt-6-1-sol-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-6 Astra

gpt-6-astra-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT 6 Sol

gpt-6-sol-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT 6 Luna

gpt-6-luna-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.6 Luna

gpt-5-6-luna-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.6 Luna 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.6 Terra

gpt-5-6-terra-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.6 Terra 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.6 Sol

gpt-5-6-sol-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.6 Sol 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.5

gpt-5-5-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.5 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.4

gpt-5-4-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.4 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.4 Codex

gpt-5.4-codex-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.4 Codex 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.3 Codex

gpt-5-3-codex-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.3 Codex 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.2

gpt-5-2-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.2 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.2 Codex

gpt-5-2-codex-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.2 Codex 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5.1 Codex

gpt-5-1-codex-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5.1 Codex 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

GPT-5 Codex

gpt-5-codex-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · GPT-5 Codex 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.8 Flash

gemini-3-8-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.7 Flash

gemini-3-7-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3.7 Flash 当前在 Rivya 处于接入安全暂停状态。可索引状态页保留已确认的对话合同，但执行入口继续关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.6 Flash

gemini-3-6-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3.6 Flash 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.5 Flash

gemini-3-5-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3.5 Flash 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3.1 Pro

gemini-3-1-pro-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3.1 Pro 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3 Pro

gemini-3-pro-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3 Pro 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 3 Flash

gemini-3-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 3 Flash 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 2.5 Pro

gemini-2-5-pro-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 2.5 Pro 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Gemini 2.5 Flash

gemini-2-5-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Gemini 2.5 Flash 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Claude Opus 5.5

claude-opus-5-5-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Claude Opus 5.5 — 该模型已公布。Rivya 正在核验输入规则、计费和内容，完成验证前暂不开放生成。请选择可用的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Claude Sonnet 5.5

claude-sonnet-5-5-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Claude Sonnet 5.5 — 该模型已公布。Rivya 正在核验输入规则、计费和内容，完成验证前暂不开放生成。请选择可用的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Claude Fable 5.1

claude-fable-5-1-chat这个模型已规划接入 Public API，但目前还不能调用。这个模型已规划接入 Public API，但目前还不能调用。

对话 · Claude Fable 5.1 是一款即将推出的 Chat 模型。Rivya 通过本页记录可用状态并提供现有对话模型，不会声称尚未公布的上下文、工具或响应行为。

模型页面

基础积分

这个模型已规划接入 Public API，但目前还不能调用。

支持模式

API 输入状态

这个模型已规划接入 Public API，但目前还不能调用。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型已规划接入 Public API，但目前还不能调用。

参数

不需要额外模型参数。

Claude Fable 5

claude-fable-5-chatAPI 可调用文本输入可用

对话 · Rivya 上以文本为主的 Claude 对话模型，适合叙事重构、面向特定读者的草稿和结构化编辑工作。

接入文档模型页面

基础积分

per_million_tokens · input=800 · output=4000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

claude-messages

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "claude-fable-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 5

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

对话 · Rivya 上以文本为主的 Claude 对话模型，适合实施简报、需求审阅和精炼的技术规划。

接入文档模型页面

基础积分

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

claude-messages

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "claude-sonnet-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 Opus 5

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

对话 · Rivya 上以文本为主的 Claude 对话模型，适合董事会层面的风险梳理、情景比较和决策记录。

接入文档模型页面

基础积分

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

claude-messages

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "claude-opus-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 Opus 4.8

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

对话 · Rivya 上以文本为主的 Claude 对话模型，适合审阅高密度资料包并形成谨慎、结构化的决策结论。

接入文档模型页面

基础积分

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

claude-messages

API 输入状态

文本输入可用

输入类型

text

提示词上限

20000 字符

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

{
  "model": "claude-opus-4-8-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.7

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

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

接入文档模型页面

基础积分

per_million_tokens · input=285 · output=1430 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

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-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Claude Opus 4.6 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Claude Sonnet 4.6

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

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

接入文档模型页面

基础积分

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

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-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Claude Opus 4.5 已收录在 Rivya，但当前处于接入安全暂停状态；可索引的状态页会继续保留，对话调用仍保持关闭。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Claude Sonnet 4.5

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

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

接入文档模型页面

基础积分

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

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 对话模型，强调速度、成本效率和稳定的日常对话表现，适合高频使用场景。

接入文档模型页面

基础积分

per_million_tokens · input=55 · output=285 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支持模式

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 模型不支持图片附件。

参数

不需要额外模型参数。

Grok 4.7

grok-4-7-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Grok 4.6

grok-4-6-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Grok 4.6 — 暂时不可用. Grok 4.6 仍处于接入安全暂停时，先使用可调用替代继续工作。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Grok 4.5

grok-4-5-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Grok 4.5 — 暂时不可用. Grok 4.5 仍处于接入安全暂停时，先使用可调用替代继续工作。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Grok 4.3

grok-4-3-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · Grok 4.3 — 暂时不可用. Grok 4.3 仍处于接入安全暂停时，先使用可调用替代继续工作。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

Kimi K3

kimi-k3-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

DeepSeek V4.1 Flash

deepseek-v4-1-flash-chat这个请求暂时不可用，请稍后重试。这个请求暂时不可用，请稍后重试。

对话 · 该模型已收录，但暂未开放对话。目前还无法在对话开始前确定最大积分消耗，你可以先使用下方已开放的替代模型。

模型页面

基础积分

这个请求暂时不可用，请稍后重试。

支持模式

API 输入状态

这个请求暂时不可用，请稍后重试。

输入类型

-

提示词上限

-

参考素材

-

请求

POST /api/v1/generations

鉴权

Bearer API Key

Idempotency-Key

建议使用

请求体

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

参考素材规则

-

结果读取

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

常见错误

validation_failed, insufficient_credits, idempotency_conflict, not_found

这个模型只用于规划和对比。状态变为 API 可调用前，不要通过 Public API v1 调用它。

参数

不需要额外模型参数。

相关页面

API 模型列表

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

创建生成任务

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

目录

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