模型 API 参考
查询 Rivya API 模型 ID、可用状态、支持模式、参数表、提示词上限、参考素材规则和模型详情链接。
最近审阅于 2026年11月11日
这是 Rivya API v1 的模型级调用参考。
下方表格由 /api/v1/models 使用的同一模型目录和 public serializer 生成,不是人工写死的固定模型数量。
本参考介绍的是已经实现的合同。实际调用仍要求部署已启用 Public API,并且所选模型在请求发出时显示为 API 可用。
Suno Speech:场景与指定脚本
Suno Speech: prompt 在简单模式(params.customMode="false")中是场景描述,在高级模式("true")中是朗读脚本。tone、variety、vocalGender、backgroundMusic 只用于高级模式;简单模式须省略。不要在 params 中另传 script 或 prompt。
提示词单位与完整图层结果
读取 GET /api/v1/models 时,请将 prompt_length_unit 与 max_prompt_length 一起使用。utf8_bytes 计算原文的 UTF-8 字节,包含空格和换行;utf16_code_units 计算 JavaScript 的 UTF-16 代码单元。上限为 null 不代表文字不限长或可以不填。Gemini TTS 使用字节单位。
已完成的图层拆分结果可在完整的 result.urls 之外提供 result.layers。请保留每层返回的 z_index、URL、尺寸、名称、说明和边界框,索引零是底图。TypeScript SDK 已提供这些字段。参考文件必须按所选模型上传,并传回原始签名元数据;单独声明尺寸或时长不能代替核验。
如何阅读这份参考
生成与聊天需要部署已开启公开 API、账户有调用资格、Key 有效且未过期,并分别具有 generations:create 或 chat:create;目录列出不授予调用资格,模型还须在请求校验时可用。模型列表公开无需 Key,模型支持范围以 Rivya 的模式与输入为准。详见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 上传参考素材。对
seedream-5-pro,seedream-5-pro-layer-decomposition,nano-banana-2-lite,qwen-image-3,qwen-image-3-pro,保留该模型原始文件上传响应,并在params.referenceMediaItems中映射:mime_type→mimeType,width→width,height→height,size_bytes→sizeBytes,image_dimensions_token→imageDimensionsToken。必需 token 缺失或过期须重新上传;图层拆分须恰好一张图片,签名尺寸满足模型像素与宽高比限制。Grok Imagine Image 2.0 的 1–5 张标准图片编辑参考图都使用相同的已签名图片字段。仅提供提示词的请求使用文本生成图片;已签名参考图会切换到图片编辑。
auto仅用于编辑,而 Segment Map 和 Segment Edit 仍不可用。部分视频模式要求已签名时长与视频元数据。在
params.referenceMediaItems中映射原始目标签名响应:mime_type→mimeType,duration_seconds→durationSeconds,duration_token→durationToken,video_width→width,video_height→height,frames_per_second→framesPerSecond,video_bitrate_mbps→videoBitrateMbps,video_file_size_bytes→sizeBytes,video_metadata_token→videoMetadataToken。任一必需 token 缺失或过期须重新上传;只有公开视频 URL 不能提供签名元数据。Wan 3.0 提供互斥的文本、首尾帧和多模态参考场景,并支持 Standard 或 Prime、480P/720P/1080P、六种宽高比、明确的 2–30 秒或智能时长、生成音频和 seed。图片会签名绑定 MIME、宽高和字节数;视频还要求已签名时长与视频元数据;音频时长 token 会绑定 MIME 和字节数。智能时长按 30 秒预留,且不能与参考视频同时使用。文件转视频和链接转视频快捷模式仍不可用。
模型限制可能与文件类别默认值不同,不一定更严格。上传时指定目标模型,按适用条件校验文件种类、MIME、大小、时长、尺寸、帧率及码率。上传不创建生成任务或预留生成积分;上传后仍须检查模式要求、必填组合和参数范围。模型 API 指南解释请求细节,产品详情页提供工作区用法和示例。
对 Chat 模型,请读取
chat_capabilities,确认非 streaming、SSE streaming、图片file_id附件、web search、thoughts 和 reasoning effort 支持情况。模型详情页提供产品层用法和示例。
Wan 3.0 的场景与选项值为:seedance_scene: text / frames / reference; variant: standard / prime; resolution: 480P / 720P / 1080P; aspect_ratio: adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16. 场景互斥,音频参考须同时有图片或视频。请求细节见Wan 3.0 API 指南。
请求形态
{
"model": "z-image",
"prompt": "A ceramic mug on a light gray background, lit from the side",
"params": {
"aspect_ratio": "1:1"
}
}JavaScript 和 Python 示例见 创建生成任务。
Chat 请求形态:
{
"model": "claude-sonnet-5-chat",
"message": "Write a plan with three steps for launching a new product photo campaign"
}Chat 示例见 Chat API。
动态模型参考
配合在线调试器使用这份参考
先从 Quickstart 确认调用流程,再在这里核对模型字段,最后到 Developers 调试器运行 mock 或登录后的真实请求。
GPT Image 2.6 Flare
gpt-image-2-6-flare这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。图片 · Flare 注重快速图像迭代:先把文字需求变成草图,再结合图像输入逐步修改。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 Image 2.6 Sunburst
gpt-image-2-6-sunburst这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。图片 · Sunburst 侧重根据文字与图像输入完成细致构图和图像编辑。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 Image 2.6 Economy
gpt-image-2-6-economyAPI 可调用部分可用:需要 Files API图片 · 通过文字或参考图生成、编辑一张 1K PNG 图片。参考图可选。Rivya 暂不支持动态 GIF 输出。
基础积分
积分费率: 5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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-6-economy",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "auto",
"background": "auto",
"output_format": "png"
}
}参考素材规则
参考图片: 最多添加 16 张 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_ratio | select | 否 | auto | - | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 21:9, 4:3 |
| background | select | 否 | auto | - | auto, transparent, opaque |
| output_format | select | 否 | png | - | png |
GPT Image 2.5 Flare
gpt-image-2-5-flareAPI 可调用部分可用:需要 Files API图片 · 使用文字生成图片,或通过最多 16 张参考图编辑图片。支持 1K、2K、4K 分辨率,以及自动、透明和不透明背景。
基础积分
积分费率: 3–16 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | auto | - | auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9 |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| background | select | 否 | auto | - | auto, transparent, opaque |
GPT Image 2.5 Sunburst
gpt-image-2-5-sunburstAPI 可调用部分可用:需要 Files API图片 · 使用文字生成图片,或通过最多 16 张参考图编辑图片。支持 1K、2K、4K 分辨率,以及自动、透明和不透明背景。
基础积分
积分费率: 3–16 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | auto | - | auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 27:16, 16:27, 9:8, 8:9 |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| background | select | 否 | auto | - | auto, transparent, opaque |
GPT Image 2
gpt-image-2API 可调用部分可用:需要 Files API图片 · Rivya 当前接入的 OpenAI 新一代图片模型,支持文生图、图生图、最多 16 张参考图,以及 1K / 2K / 4K 三档清晰积分。
基础积分
积分费率: 3–8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | auto, 1:1, 9:16, 16:9, 4:3, 3:4 |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
GPT Image 1.5
gpt-image-1-5API 可调用部分可用:需要 Files API图片 · OpenAI 图片模型,支持标准/高清两档质量和最多 16 张参考图,擅长理解复杂指令并渲染空间关系准确的连贯场景。
基础积分
积分费率: 4–22 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| quality | select | 否 | medium | - | medium, high |
| aspect_ratio | select | 否 | 1:1 | - | 1:1, 2:3, 3:2 |
基础积分
积分费率: 0.8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
1000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "z-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "1:1"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16 |
基础积分
积分费率: 3–8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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-1",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "auto",
"resolution": "1K",
"output_format": "jpg"
}
}参考素材规则
参考图片: 最多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_ratio | select | 否 | auto | - | 1:1, 2:3, 3:2, 1:4, 4:1, 3:4, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9, auto |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| output_format | select | 否 | jpg | - | png, jpg |
Nano Banana 2
nano-banana-2API 可调用部分可用:需要 Files API图片 · Nano Banana 2 是 Rivya 里的新版 Nano Banana 图片模型,适合品牌视觉、产品图和参考图驱动的创意草稿;当你想要比基础档更新的 Google 图片路径时,可以从这里开始。
基础积分
积分费率: 5–12 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "auto",
"resolution": "1K",
"output_format": "jpg"
}
}参考素材规则
参考图片: 可上传最多 10 个图片参考素材,用于对应的生成模式。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | auto | - | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8 |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| output_format | select | 否 | jpg | - | jpg, png |
Nano Banana 2 Lite
nano-banana-2-liteAPI 可调用部分可用:需要 Files API图像 · Nano Banana 2 Lite 是 Rivya 中积分消耗更低的 Nano Banana 选项,适合快速制作产品概念图、社交图片变体和参考图引导的草稿;每次生成固定消耗 3 积分,并提供 15 种宽高比。
基础积分
积分费率: 3 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 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 张参考图,针对高保真品牌与营销视觉优化,细节和色彩精准度更高。
基础积分
积分费率: 8–14 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| output_format | select | 否 | png | - | png, jpg |
Nano Banana
nano-bananaAPI 可调用部分可用:需要 Files API图片 · Google 的灵活图片模型,支持文生图、图生图、11 种宽高比、最多 10 张参考图,以及 PNG/JPEG 输出,适合人像、产品构图和更宽画幅的营销视觉。
基础积分
积分费率: 3 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "nano-banana",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| imageSize | select | 否 | 1:1 | - | 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto |
| output_format | select | 否 | png | - | png, jpeg |
4o Image
4o-imageAPI 可调用文本输入可用图片 · 4o Image 是 Rivya 里的轻量 OpenAI 文生图入口,表单只保留提示词与 3 种常用比例,适合快速验证图片想法。
基础积分
积分费率: 3 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
-
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "4o-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"size": "1:1"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| size | select | 否 | 1:1 | - | 1:1, 3:2, 2:3 |
Seedream 5.5 文生图
seedream-5-5-text-to-imageAPI 可调用文本输入可用图片 · 使用 Seedream 5.5 将文字生成一张图片,可选 1K、1.5K 或 2K。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedream-5-5-text-to-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "1:1",
"size": "2K",
"output_format": "png",
"background": "auto"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
| size | select | 否 | 2K | - | 1K, 1.5K, 2K |
| output_format | select | 否 | png | - | png, jpeg |
| background | select | 否 | auto | - | auto, transparent, opaque |
Seedream 5.5 图生图
seedream-5-5-image-to-imageAPI 可调用需要 Files API图片 · 使用 1–10 张参考图和文字指令,通过 Seedream 5.5 编辑图片。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
image-to-image
API 输入状态
需要 Files API
输入类型
file
提示词上限
5000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考文件: 上传每张不超过 10 MB 的 JPEG、PNG 或 WebP,输入 5–5000 个字符。可选 1K、1.5K、2K,以及 PNG 或 JPEG。支持自动比例;透明背景须选 PNG。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | auto | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9, auto |
| size | select | 否 | 2K | - | 1K, 1.5K, 2K |
| output_format | select | 否 | png | - | png, jpeg |
| background | select | 否 | auto | - | auto, transparent, opaque |
Seedream 5.5 图层拆分
seedream-5-5-layer-decompositionAPI 可调用需要 Files API图片 · 将一张图片拆为底图和透明 PNG 图层,分别用于后续编辑。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
image-to-layers
API 输入状态
需要 Files API
输入类型
file
提示词上限
2000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考文件: 上传一张不超过 10 MB 的 JPEG、PNG 或 WebP。可选指令最多 2000 个字符。输出上限为 2–100 张,包含底图,默认 30 张;自动尺寸按 2K 预算。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| size | select | 否 | auto | - | auto, 1K, 1.5K, 2K |
| output_format | select | 否 | png | - | png, jpeg |
| max_images | number | 否 | 30 | min 2 / max 100 / step 1 | - |
| text_recognition | select | 否 | false | - | false, true |
Seedream 5.0 Lite
seedream-5-liteAPI 可调用部分可用:需要 Files API图片 · 字节跳动更轻量的 Seedream 图片模型,在 Rivya 里对文生图和图像编辑统一按固定 6 积分计费。支持 8 种宽高比、最多 14 张参考图,适合作为 Seedream 家族里更低门槛的一档。
基础积分
积分费率: 5.5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
2995 字符
参考素材
image · 14 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedream-5-lite",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
| quality | select | 否 | basic | - | basic, high, ultra |
| output_format | select | 否 | png | - | png, jpeg |
| nsfw_checker | select | 否 | true | - | false, true |
Seedream 5.0 Pro
seedream-5-proAPI 可调用部分可用:需要 Files API图像 · Seedream 5.0 Pro 是 Rivya 面向广告主视觉、编辑类场景和产品构图的多参考图像模型,支持文生图、图生图、1K 或 2K 输出,以及最多 10 张参考图。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
| quality | select | 否 | basic | - | basic, high |
| output_format | select | 否 | png | - | png, jpeg |
| nsfw_checker | select | 否 | 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 尺寸。
基础积分
积分费率: 7–14 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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 图片;不支持 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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| size | select | 否 | auto | - | auto, 1K, 1.5K, 2K |
| output_format | select | 否 | jpeg | - | jpeg, png |
Seedream 5.0 Flash
seedream-5-flashAPI 可调用部分可用:需要 Files API图片 · 生成或编辑 1K、1.5K 或 2K 的 PNG 或 JPEG 图片。最多添加 10 张 JPEG、PNG 或 WebP 参考图,每张不超过 30 MB。提示词须为 4–5000 个字符。
基础积分
积分费率: 3.24 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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-flash",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "1:1",
"size": "1K",
"output_format": "png"
}
}参考素材规则
参考图片: 生成或编辑 1K、1.5K 或 2K 的 PNG 或 JPEG 图片。最多添加 10 张 JPEG、PNG 或 WebP 参考图,每张不超过 30 MB。提示词须为 4–5000 个字符。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
| size | select | 否 | 1K | - | 1K, 1.5K, 2K |
| output_format | select | 否 | png | - | png, jpeg |
Seedream 5.0 Flash Layer Decomposition
seedream-5-flash-layer-decompositionAPI 可调用需要 Files API图片 · 将一张不超过 30 MB 的 PNG 或 JPEG 图片拆分成图层,可选 1K、1.5K 或 2K。提示词可选;填写时须为 4–5000 个字符。
基础积分
积分费率: 3.24 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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 图片拆分成图层,可选 1K、1.5K 或 2K。提示词可选;填写时须为 4–5000 个字符。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| size | select | 否 | 1K | - | 1K, 1.5K, 2K |
| output_format | select | 否 | png | - | png, jpeg |
Seedream 4.5
seedream-4-5API 可调用部分可用:需要 Files API图片 · 字节跳动高端图片模型,2K/4K 双档质量、8 种宽高比、最多 14 张参考图,以电影级调色和丰富纹理细节著称,擅长时尚和生活方式视觉。
基础积分
积分费率: 6.5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
| quality | select | 否 | basic | - | basic, high |
Seedream 4.0
seedream-4-0API 可调用部分可用:需要 Files API图片 · 一次生成或编辑最多6张图片,可选1K、2K或4K。最多上传10张JPEG、PNG或WebP参考图,每张不超过10MB。预扣按请求的最大图片数量计算。
基础积分
积分费率: 5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedream-4-0",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"image_size": "square_hd",
"image_resolution": "1K",
"max_images": 1,
"seed": 0,
"nsfw_checker": "false"
}
}参考素材规则
参考图片: 一次生成或编辑最多6张图片,可选1K、2K或4K。最多上传10张JPEG、PNG或WebP参考图,每张不超过10MB。预扣按请求的最大图片数量计算。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| image_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9 |
| image_resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| max_images | number | 否 | 1 | min 1 / max 6 / step 1 | - |
| seed | number | 否 | - | min 0 / max 1000000 / step 1 | - |
| nsfw_checker | select | 否 | false | - | false, true |
基础积分
积分费率: 3.5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedream-3-0",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"image_size": "square_hd",
"guidance_scale": 2.5,
"seed": 0
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| image_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| guidance_scale | number | 否 | 2.5 | min 1 / max 10 / step 0.1 | - |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
Grok Imagine Image 2.0
grok-imagine-image-2-0API 可调用部分可用:需要 Files API图像 · Grok Imagine Image 2.0 支持生成单张图像的文生图和标准图像编辑;编辑请求可使用 1 至 5 张已签名的参考图,并提供 5 种固定宽高比和仅限编辑请求的自动比例。
基础积分
积分费率: 4 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
8000 字符
参考素材
image · 5 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "grok-imagine-image-2-0",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 2:3, 3:2, 16:9, 9:16, auto |
Grok Imagine
grok-imagineAPI 可调用部分可用:需要 Files API图片 · xAI 图片模型,创意解读能力强,支持 5 种宽高比;标准文生图每次返回 2 张图,质量档每次返回 4 张图。
基础积分
积分费率: 4–5 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 2:3, 3:2, 16:9, 9:16 |
| nsfw_checker | select | 否 | false | - | false, true |
| enable_pro | select | 否 | false | - | false, true |
基础积分
积分费率: 1.6–6.5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "flux-3",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "1:1",
"resolution": "1K",
"output_format": "png"
}
}参考素材规则
参考图片: 最多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_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21 |
| resolution | select | 否 | 1K | - | 1K, 2K, 4K |
| output_format | select | 否 | png | - | png, jpeg, webp |
Flux 2 Pro
flux-2-proAPI 可调用部分可用:需要 Files API图片 · Black Forest Labs 旗舰 320 亿参数模型,支持文生图和图生图,最多 8 张参考图、2K 分辨率和精准文字渲染,专为产品摄影和品牌视觉打造。
基础积分
积分费率: 5–7 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 |
| resolution | select | 否 | 1K | - | 1K, 2K |
| nsfw_checker | select | 否 | false | - | false, true |
Flux 2 Flex
flux-2-flexAPI 可调用部分可用:需要 Files API图片 · Flux 2 系列的编辑专用变体,专注结构调整和风格迁移,最多 8 张参考图、2K 分辨率——适合在现有视觉基础上迭代优化。
基础积分
积分费率: 14–24 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 |
| resolution | select | 否 | 1K | - | 1K, 2K |
| nsfw_checker | select | 否 | 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 积分。
基础积分
积分费率: 8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
-
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "flux-kontext-max",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| outputFormat | select | 否 | jpeg | - | jpeg, png |
| enableTranslation | select | 否 | true | - | true, false |
| promptUpsampling | select | 否 | false | - | false, true |
| safetyTolerance | number | 否 | 2 | min 0 / max 6 | - |
| watermark | text | 否 | - | - | - |
Flux Kontext Pro
flux-kontext-proAPI 可调用部分可用:需要 Files API图片 · BFL 当前把 FLUX.1 Kontext [pro] 标为上一代,并建议新项目使用 FLUX.2。 Black Forest Labs 的低成本 Flux Kontext 模型,适合文生图和单图编辑。Rivya 在同一个模型页提供两种模式,均固定为每次 4 积分。
基础积分
积分费率: 4 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
-
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "flux-kontext-pro",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspectRatio | select | 否 | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| outputFormat | select | 否 | jpeg | - | jpeg, png |
| enableTranslation | select | 否 | true | - | true, false |
| promptUpsampling | select | 否 | false | - | false, true |
| safetyTolerance | number | 否 | 2 | min 0 / max 6 | - |
| watermark | text | 否 | - | - | - |
Qwen Image 3.0
qwen-image-3API 可调用部分可用:需要 Files API图像 · Qwen Image 3.0 是 Rivya 中参数配置较丰富的 Qwen 图像模型,适合中文或英文提示词、参考图引导的版式,以及可复现的视觉测试;支持 1K 或 2K 输出、提示词扩写、负面提示词和种子控制。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 是 | 1K | - | 1K, 2K |
| image_size | select | 否 | 16:9 | - | 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 |
| output_format | select | 否 | png | - | png, jpeg |
| prompt_extend | select | 否 | true | - | true, false |
| nsfw_checker | select | 否 | false | - | false, true |
| negative_prompt | text | 否 | - | - | - |
| seed | number | 否 | 1 | min 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 档位。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 是 | 1K | - | 1K, 2K |
| image_size | select | 否 | 16:9 | - | 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 |
| output_format | select | 否 | png | - | png, jpeg |
| prompt_extend | select | 否 | true | - | true, false |
| nsfw_checker | select | 否 | false | - | false, true |
| negative_prompt | text | 否 | - | - | - |
| seed | number | 否 | 1 | min 0 / max 2147483647 / step 1 | - |
Qwen Image 2.1
qwen2-1-imageAPI 可调用部分可用:需要 Files API图片 · 生成或编辑一张 1K 或 2K 图片。最多添加 10 张 JPEG、PNG 或 WebP 参考图,每张不超过 30 MB、2500 万像素。透明背景须选 PNG 或 WebP。此处暂不支持蒙版。
基础积分
积分费率: 4–8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "qwen2-1-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"params": {
"aspect_ratio": "1:1",
"resolution": "1K",
"output_format": "png",
"background": "opaque",
"enhance_prompt": "true",
"seed": 0
}
}参考素材规则
参考图片: 生成或编辑一张 1K 或 2K 图片。最多添加 10 张 JPEG、PNG 或 WebP 参考图,每张不超过 30 MB、2500 万像素。透明背景须选 PNG 或 WebP。此处暂不支持蒙版。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| aspect_ratio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21 |
| resolution | select | 否 | 1K | - | 1K, 2K |
| output_format | select | 否 | png | - | png, webp, jpeg |
| background | select | 否 | opaque | - | opaque, transparent |
| enhance_prompt | select | 否 | true | - | true, false |
| seed | number | 否 | - | min 0 / max 2147483647 / step 1 | - |
Qwen2 Image
qwen2-imageAPI 可调用部分可用:需要 Files API图片 · 阿里 Qwen2 图片模型当前在 Rivya 里按一个固定积分图片项目接入。它安全覆盖文生图与图生图两种模式,只开放两份公开文档共同出现的宽高比子集,并保留 PNG/JPEG 输出、随机种子与简单内容过滤开关。
基础积分
积分费率: 5.6 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
800 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "qwen2-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_size | select | 否 | 16:9 | - | 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9 |
| output_format | select | 否 | png | - | png, jpeg |
| seed | number | 否 | - | min 0 | - |
| nsfw_checker | select | 否 | false | - | false, true |
Qwen Image
qwen-imageAPI 可调用部分可用:需要 Files API图片 · 阿里巴巴通义千问系列图片模型,提供高清预设尺寸(方形、竖向、横向)和 PNG/JPEG 输出,擅长中文提示词和文化细节的视觉生成。
基础积分
积分费率: 4 / 百万输出像素 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "qwen-image",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| output_format | select | 否 | png | - | png, jpeg |
Qwen Image Edit
qwen-image-editAPI 可调用需要 Files API图片 · 在Rivya,可用最多2000字符的提示词编辑一张不超过10 MB、16 MP的JPEG、PNG或WebP图片,返回一张1024 × 1024 PNG图片。
基础积分
积分费率: 5 / 百万输出像素 任务最终消耗向上取整到整数积分。
支持模式
image-to-image
API 输入状态
需要 Files API
输入类型
file
提示词上限
2000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考图片: 在Rivya,可用最多2000字符的提示词编辑一张不超过10 MB、16 MP的JPEG、PNG或WebP图片,返回一张1024 × 1024 PNG图片。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| image_size | select | 否 | square_hd | - | square_hd |
| output_format | select | 否 | png | - | png |
Midjourney
midjourney这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。图片 · Midjourney 是图像模型家族,不同版本的参考图行为不同。Rivya 的这个历史入口当前暂停。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
image · 4 个文件
请求
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 调用它。
参数
不需要额外模型参数。
Recraft Remove Background
recraft-remove-backgroundAPI 可调用需要 Files API图片 · Recraft 在 Rivya 上的去背景模型,适合从现有图片中干净地分离主体。它更适合透明背景抠图、主体分离,以及为下一步设计准备干净源图。
基础积分
积分费率: 1 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
image-to-image
API 输入状态
需要 Files API
输入类型
file
提示词上限
-
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
源图片: 仅上传 1 张 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 上的轻量图片放大模型,适合对一张已经选定的图片做低成本锐化和清晰度补强,而不是直接上更重的交付级放大。
基础积分
积分费率: 0.5 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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 积分; 每次请求返回一张图片.
基础积分
积分费率: 12 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image, image-to-image
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 9 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "wan-2-7-image-pro",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8 |
| resolution | select | 否 | 2K | - | 1K, 2K |
| watermark | select | 否 | false | - | false, true |
| seed | number | 否 | - | min 0 / max 2147483647 / step 1 | - |
Wan 2.7 Image
wan-2-7-imageAPI 可调用部分可用:需要 Files API图片 · 在 Rivya 里,Wan 2.7 Image 当前支持文生图、图生图。这个选项也支持带入最多 9 张参考图片。 每张图片固定 5 积分; 每次请求返回一张图片.
基础积分
积分费率: 4.8 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8 |
| resolution | select | 否 | 2K | - | 1K, 2K |
| watermark | select | 否 | false | - | false, true |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
Google Imagen4 Ultra
google-imagen4-ultraAPI 可调用文本输入可用图片 · Google Imagen4 Ultra 是 Rivya 上更高档的一档 Imagen 文生图模型。当前按固定 12 积分、单张输出项目接入,并开放公开文档里可稳定承接的提示词、反向提示词、宽高比和种子参数。
基础积分
积分费率: 12 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "google-imagen4-ultra",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 16:9, 9:16, 3:4, 4:3, auto |
| negative_prompt | text | 否 | - | max 5000 | - |
| seed | text | 否 | - | max 500 | - |
Google Imagen4
google-imagen4API 可调用文本输入可用图片 · Google Imagen4 是 Rivya 上标准档的 Imagen 文生图模型。当前按固定 8 积分、单张输出项目接入,并开放公开文档里可稳定承接的提示词、反向提示词、宽高比和种子参数。
基础积分
积分费率: 8 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "google-imagen4",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 1:1 | - | 1:1, 16:9, 9:16, 3:4, 4:3, auto |
| negative_prompt | text | 否 | - | max 5000 | - |
| seed | text | 否 | - | max 500 | - |
Google Imagen4 Fast
google-imagen4-fastAPI 可调用文本输入可用图片 · Google Imagen4 Fast 是 Rivya 上更轻量的一档 Google Imagen 文生图模型。当前继续按单张输出项目接入,固定 4 积分,并开放公开文档中可稳定承接的提示词、反向提示词、宽高比和种子参数。
基础积分
积分费率: 4 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "google-imagen4-fast",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_ratio | select | 否 | 16:9 | - | 1:1, 16:9, 9:16, 3:4, 4:3, auto |
| negative_prompt | text | 否 | - | max 5000 | - |
| seed | number | 否 | - | - | - |
Topaz Image Upscaler
topaz-image-upscaleAPI 可调用需要 Files API图片 · Topaz 在 Rivya 上的交付级图片放大模型,适合构图已经定了,只剩导出尺寸、评审分辨率或印刷清晰度还不够的静帧。
基础积分
积分费率: 10–20 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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;输出最长边 ≤ 4096 px。 这是Rivya当前支持的输出范围。
结果读取
创建响应会返回公开任务 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_factor | select | 否 | 2 | - | 1, 2, 4 |
Ideogram V3
ideogram-v3API 可调用文本输入可用图片 · Ideogram V3 是 Rivya 里偏文字渲染、海报版式和设计导向的文生图模型。当前价格为:TURBO 4 积分,BALANCED 7 积分,QUALITY 10 积分。
基础积分
积分费率: 3.5–10 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
text-to-image
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "ideogram-v3",
"prompt": "浅灰色背景上的一个产品瓶,柔和的光线从左侧照来。",
"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_speed | select | 否 | BALANCED | - | TURBO, BALANCED, QUALITY |
| style | select | 否 | AUTO | - | AUTO, GENERAL, REALISTIC, DESIGN |
| expand_prompt | select | 否 | true | - | true, false |
| image_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| seed | number | 否 | - | - | - |
| negative_prompt | text | 否 | - | max 5000 | - |
Ideogram V3 Reframe
ideogram-v3-reframe这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。图片 · Ideogram V3 Reframe 扩展图像画布,并保留居中的原始像素。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 调用它。
参数
不需要额外模型参数。
Ideogram V3 Remix
ideogram-v3-remixAPI 可调用需要 Files API图片 · Ideogram V3 Remix: 每张图 TURBO 4 / BALANCED 7 / QUALITY 10 积分. 可选 1–4 张输出。总价按单张价格乘以所选张数计算,并向上取整到整数积分。
基础积分
积分费率: 3.5–10 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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_speed | select | 否 | BALANCED | - | TURBO, BALANCED, QUALITY |
| style | select | 否 | AUTO | - | AUTO, GENERAL, REALISTIC, DESIGN |
| expand_prompt | select | 否 | true | - | true, false |
| image_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| num_images | select | 否 | 1 | - | 1, 2, 3, 4 |
| seed | number | 否 | - | - | - |
| strength | number | 否 | 0.8 | min 0.01 / max 1 | - |
| negative_prompt | text | 否 | - | max 5000 | - |
Ideogram Character
ideogram-characterAPI 可调用需要 Files API图片 · 面向角色一致性的专门入口,把 1 张已经定下来的角色图延展到新场景、新服装和新尺寸。适合你更在意身份保留,而不是开放式图片编辑,并且一次只需要 1 张输出图。 每张图 TURBO 12 / BALANCED 18 / QUALITY 24 积分. 可选 1–4 张输出。总价按单张价格乘以所选张数计算,并向上取整到整数积分。
基础积分
积分费率: 12–24 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
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_speed | select | 否 | BALANCED | - | TURBO, BALANCED, QUALITY |
| style | select | 否 | AUTO | - | AUTO, REALISTIC, FICTION |
| expand_prompt | select | 否 | true | - | true, false |
| image_size | select | 否 | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| num_images | select | 否 | 1 | - | 1, 2, 3, 4 |
| seed | number | 否 | - | - | - |
| negative_prompt | text | 否 | - | max 5000 | - |
基础积分
积分费率: 1.5–12 / 张图片 任务最终消耗向上取整到整数积分。
支持模式
image-to-image
API 输入状态
需要 Files API
输入类型
file
提示词上限
-
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考文件: 支持不超过 20 MB 的 JPEG、PNG、WebP、HEIC、BMP 或 GIF;GIF 只处理首帧。输出最多 67,108,864 像素,任一边不超过 16,384 像素。
结果读取
创建响应会返回公开任务 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_factor | select | 否 | 2 | - | 1, 2, 4, 8 |
MiniMax H3 Image
minimax-h3-image这个模型已规划接入 Public API,但目前还不能调用。这个模型已规划接入 Public API,但目前还不能调用。图片 · MiniMax H3 Image 预告:文字生图与参考图编辑是不同操作,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,但目前还不能调用。
参数
不需要额外模型参数。
Seedance 2.5
seedance-2-5API 可调用部分可用:需要 Files API视频 · Seedance 2.5 是 Rivya 上规模更大的 Seedance 工作流,支持纯提示词视频、首尾帧引导、多模态参考和视频引导转换。相较 Mini,它增加了 1080p 档、最长 30 秒输出、自动时长、MP4 或 MOV 输出,并显著扩大了图片、视频与音频参考容量。
基础积分
积分费率: 17–158 / 1 秒视频总时长(输入 + 输出) 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video, reference-to-video, video-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
20480 字符
参考素材
image, video, audio · 50 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedance-2-5",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 图片,每张不超过 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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| omni_reference_task_type | select | 否 | auto | - | auto, reference, edit, extend |
| seedance_scene | select | 否 | text | - | text, frames, reference |
| resolution | select | 否 | 720p | - | 480p, 720p, 1080p |
| aspect_ratio | select | 否 | adaptive | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
| duration | number | 否 | 5 | min -1 / max 30 / step 1 | - |
| output_format | select | 否 | mp4 | - | mp4, mov |
| generate_audio | select | 否 | true | - | true, false |
| return_last_frame | select | 否 | false | - | false, true |
| web_search | select | 否 | false | - | false, true |
| nsfw_checker | select | 否 | true | - | false, true |
Seedance 2.0
seedance-2API 可调用部分可用:需要 Files API视频 · 字节跳动完整版 Seedance 2.0 视频模型,当前在 Rivya 里完整接入了文生视频、首帧/首尾帧驱动,以及多模态参考生视频三类场景。产品层保留了与文档一致的角色拆分,避免把首尾帧和参考图/参考视频/参考音频混成一个模糊上传桶。
基础积分
积分费率: 41–208 / 1 秒视频总时长(输入 + 输出) 任务最终消耗向上取整到整数积分。
支持模式
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",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"seedance_scene": "text",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": "true",
"return_last_frame": "false",
"web_search": "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. At 720p, reference inputs may use images or audio but not video; choose 1080p or 4K when including a reference video.
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| seedance_scene | select | 否 | text | - | text, frames, reference |
| resolution | select | 否 | 720p | - | 720p, 1080p, 4K |
| aspect_ratio | select | 否 | 16:9 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
| duration | number | 否 | 5 | min 4 / max 15 | - |
| generate_audio | select | 否 | true | - | true, false |
| return_last_frame | select | 否 | false | - | false, true |
| web_search | select | 否 | false | - | false, true |
Seedance 2.0 Fast
seedance-2-fastAPI 可调用部分可用:需要 Files API视频 · 字节跳动更快的 Seedance 2.0 视频模型,当前在 Rivya 里完整接入了文生视频、首帧/首尾帧驱动,以及多模态参考生视频三类场景。为了避免首尾帧和参考图/参考视频/参考音频的角色混淆,产品层保持了与文档一致的显式场景拆分。
基础积分
积分费率: 6.8–24.8 / 1 秒视频总时长(输入 + 输出) 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_scene | select | 否 | text | - | text, frames, reference |
| resolution | select | 否 | 720p | - | 480p, 720p |
| aspect_ratio | select | 否 | 16:9 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
| duration | number | 否 | 5 | min 4 / max 15 | - |
| generate_audio | select | 否 | true | - | true, false |
| return_last_frame | select | 否 | false | - | false, true |
| web_search | select | 否 | false | - | false, true |
| nsfw_checker | select | 否 | false | - | false, true |
Seedance 2.0 Mini
seedance-2-miniAPI 可调用部分可用:需要 Files API视频 · Seedance 2.0 Mini 是 Rivya 上费率较低的 Seedance 多模态工作流,支持纯提示词视频、首帧或首尾帧动画,以及图片、视频或音频混合参考。480p 与 720p 两档覆盖 4 至 15 秒输出,并确保三种输入场景互斥。
基础积分
积分费率: 2.4–8.2 / 1 秒视频总时长(输入 + 输出) 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_scene | select | 否 | text | - | text, frames, reference |
| resolution | select | 否 | 720p | - | 480p, 720p |
| aspect_ratio | select | 否 | 16:9 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive |
| duration | number | 否 | 5 | min 4 / max 15 / step 1 | - |
| generate_audio | select | 否 | true | - | true, false |
| web_search | select | 否 | false | - | false, true |
| nsfw_checker | select | 否 | true | - | false, true |
Seedance 1.5 Pro
seedance-1-5-proAPI 可调用部分可用:需要 Files API视频 · 支持文生视频、图生视频和原生音视频同步的 Seedance 视频模型,提供 480p–1080p、4–12 秒片段、6 种宽高比、动态或固定镜头控制,以及唇形同步。
基础积分
积分费率: 1.75–15 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 480p, 720p, 1080p |
| duration | number | 否 | 8 | min 4 / max 12 / step 1 | - |
| generate_audio | select | 否 | false | - | false, true |
| aspectRatio | select | 否 | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 |
| fixed_lens | select | 否 | false | - | false, true |
| nsfw_checker | select | 否 | false | - | false, true |
Seedance 1.0 Pro
seedance-1-0-proAPI 可调用部分可用:需要 Files API视频 · 通过文字或一张图片生成5秒或10秒视频,可选480p、720p或1080p。每张JPEG、PNG或WebP图片不超过10MB。
基础积分
积分费率: 14–140 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
10000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedance-1-0-pro",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"camera_fixed": "false",
"seed": -1,
"enable_safety_checker": "true"
}
}参考素材规则
参考图片: 通过文字或一张图片生成5秒或10秒视频,可选480p、720p或1080p。每张JPEG、PNG或WebP图片不超过10MB。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 480p, 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| camera_fixed | select | 否 | false | - | false, true |
| seed | number | 否 | -1 | min -1 / max 2147483647 | - |
| enable_safety_checker | select | 否 | true | - | true, false |
Seedance 1.0 Pro Fast
seedance-1-0-pro-fastAPI 可调用需要 Files API视频 · 须上传一张不超过10MB的JPEG、PNG或WebP图片,生成5秒或10秒视频,可选720p或1080p。
基础积分
积分费率: 16–72 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
image-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
10000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考图片: 须上传一张不超过10MB的JPEG、PNG或WebP图片,生成5秒或10秒视频,可选720p或1080p。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10 |
Seedance 1.0 Lite
seedance-1-0-liteAPI 可调用部分可用:需要 Files API视频 · 通过文字或一张图片生成5秒或10秒视频,可选480p、720p或1080p。Lite还可添加一张尾帧图。每张JPEG、PNG或WebP图片不超过10MB。
基础积分
积分费率: 10–100 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
10000 字符
参考素材
image · 2 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "seedance-1-0-lite",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"camera_fixed": "false",
"seed": -1,
"enable_safety_checker": "true"
}
}参考素材规则
参考图片: 通过文字或一张图片生成5秒或10秒视频,可选480p、720p或1080p。Lite还可添加一张尾帧图。每张JPEG、PNG或WebP图片不超过10MB。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 480p, 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 9:21 |
| camera_fixed | select | 否 | false | - | false, true |
| seed | number | 否 | -1 | min -1 / max 2147483647 | - |
| enable_safety_checker | select | 否 | true | - | true, false |
HappyHorse 1.1
happyhorse-1-1API 可调用部分可用:需要 Files API视频 · HappyHorse 1.1 是一款灵活的 AI 视频模型,可生成纯提示词视频、单图动画和多图参考视频,支持 720p 或 1080p 分辨率,输出时长为 3 至 15 秒。
基础积分
积分费率: 22.5–29 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 1080p | - | 720p, 1080p |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
| duration | number | 否 | 5 | min 3 / max 15 / step 1 | - |
HappyHorse 1.0
happyhorse-1-0API 可调用部分可用:需要 Files API视频 · HappyHorse 1.0 在 Rivya 的同一模型页中支持文生视频、单图图生视频和多图参考视频。
基础积分
积分费率: 28–48 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 1080p | - | 720p, 1080p |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4 |
| duration | number | 否 | 5 | min 3 / max 15 | - |
| seed | number | 否 | 0 | min 0 / max 2147483647 | - |
Wan 3.0 Video
wan-3-0-videoAPI 可调用部分可用:需要 Files API视频 · Wan 3.0 Video 将标准版与 Prime 档位、文生视频、首尾帧引导和已签名多模态参考整合到同一模型。它支持 480P、720P 或 1080P 输出,可选明确的 2–30 秒或智能时长,并可接收由图片、视频和音频组成的参考素材包。
基础积分
积分费率: 8–50.4 / 1 秒视频总时长(输入 + 输出) 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_scene | select | 否 | text | - | text, frames, reference |
| variant | select | 否 | standard | - | standard, prime |
| resolution | select | 否 | 1080P | - | 480P, 720P, 1080P |
| aspect_ratio | select | 否 | adaptive | - | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 |
| duration | number | 否 | 5 | min -1 / max 30 / step 1 | - |
| audio | select | 否 | true | - | true, false |
| seed | number | 否 | - | 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.
基础积分
积分费率: 16–24 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p |
| duration | number | 否 | 5 | min 0 / max 15 | - |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4 |
| negative_prompt | text | 否 | - | max 500 | - |
| prompt_extend | select | 否 | true | - | true, false |
| watermark | select | 否 | false | - | false, true |
| audio_setting | select | 否 | auto | - | auto, origin |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
Wan 2.6
wan-2-6API 可调用部分可用:需要 Files API视频 · Wan 2.6 支持不附媒体的文字生成视频、恰好 1 张图片的图片生成视频,以及使用 1–3 个视频的视频编辑;图片与视频不能混用。 文字和图片输入支持 5、10 或 15 秒;视频输入只支持 5 或 10 秒。
基础积分
积分费率: 70–315 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 1080p | - | 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10, 15 |
| multi_shots | select | 否 | false | - | false, true |
| nsfw_checker | select | 否 | true | - | false, true |
Wan 2.6 Flash
wan-2-6-flashAPI 可调用需要 Files API视频 · 通过 1 张图片或 1–3 段参考视频生成视频,每个文件不超过 10 MB。可选 720p 或 1080p,并可开启音频生成。图片输入支持 5/10/15 秒,视频输入支持 5/10 秒。
基础积分
积分费率: 20–180 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
image-to-video, video-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
1500 字符
参考素材
image, video · 3 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考图片或视频: 通过 1 张图片或 1–3 段参考视频生成视频,每个文件不超过 10 MB。可选 720p 或 1080p,并可开启音频生成。图片输入支持 5/10/15 秒,视频输入支持 5/10 秒。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 1080p | - | 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10, 15 |
| audio | select | 否 | false | - | false, true |
| multi_shots | select | 否 | false | - | false, true |
Wan 2.5 Video
wan-2-5-videoAPI 可调用部分可用:需要 Files API视频 · Wan 2.5 当前在 Rivya 上统一承接文生视频与图生视频,当前价格为:`720p_5 = 60`、`720p_10 = 120`、`1080p_5 = 100`、`1080p_10 = 200`。
基础积分
积分费率: 60–200 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p |
| duration | select | 否 | 5 | - | 5, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1 |
| enable_prompt_expansion | select | 否 | false | - | false, true |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
| negative_prompt | text | 否 | - | max 500 | - |
Wan 2.2 A14B Turbo
wan-2-2-a14b-turboAPI 可调用部分可用:需要 Files API视频 · 文字和图片输入支持 480p 或 720p(5 秒分别为 40、80 积分)。图片加音频还支持 580p;其 480p / 580p / 720p 按输出每秒 12 / 18 / 24 积分计费。
基础积分
积分费率: 12–80 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 480p, 580p, 720p |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16 |
| enable_prompt_expansion | select | 否 | false | - | false, true |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
| acceleration | select | 否 | none | - | none, regular |
| num_frames | number | 否 | 80 | min 40 / max 120 / step 4 | - |
| frames_per_second | number | 否 | 16 | min 4 / max 60 / step 1 | - |
| negative_prompt | text | 否 | - | - | - |
| num_inference_steps | number | 否 | 27 | min 2 / max 40 / step 1 | - |
| guidance_scale | number | 否 | 3.5 | min 1 / max 10 / step 0.1 | - |
| shift | number | 否 | 5 | min 1 / max 10 / step 0.1 | - |
| enable_safety_checker | select | 否 | true | - | true, false |
Wan 动画替换
wan-2-2-animate-replaceAPI 可调用需要 Files API视频 · 如果源视频的动作和镜头已经符合要求,只需要更换画面主体,Wan 动画替换最合适;如果整条视频都需要重新设计,就该回到提示词驱动生成;如果要做的不只是主体替换,而是更广泛的视频编辑,则应该选择功能更完整的编辑项目。
基础积分
积分费率: 6–12.5 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 480p | - | 480p, 580p, 720p |
Wan Animate 2
wan-animate-2这个模型已规划接入 Public API,但目前还不能调用。这个模型已规划接入 Public API,但目前还不能调用。视频 · Wan Animate 2 是 Rivya 的动画模型预告,与既有 Wan 2.2 操作不同,目前无法生成。
基础积分
这个模型已规划接入 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 张的图片。
基础积分
积分随输入和参数变化,请在生成前查看预计消耗。 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_scene | select | 否 | text | - | text, frames, reference |
| resolution | select | 否 | 2K | - | 768P, 2K |
| aspect_ratio | select | 否 | 16:9 | - | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| minimax_single_frame_role | select | 否 | first | - | first, last |
| duration | number | 否 | 6 | min 4 / max 15 / step 1 | - |
Hailuo 2.3
hailuo-2-3API 可调用需要 Files API视频 · MiniMax 的图生视频模型,支持 Standard/Pro 双档质量、768P/1080P 分辨率、6 秒或 10 秒片段,以更顺滑的运动和自然过渡著称。
基础积分
积分费率: 25–80 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| quality | select | 否 | standard | - | standard, pro |
| resolution | select | 否 | 768P | - | 768P, 1080P |
| duration | select | 否 | 6 | - | 6, 10 |
| nsfw_checker | select | 否 | true | - | false, true |
Hailuo Pro
hailuo-proAPI 可调用部分可用:需要 Files API视频 · MiniMax 当前 Hailuo Pro 视频模型,当前按固定 Pro 档位接入,统一支持文生视频和图生视频。图生侧可上传 1 到 2 张参考图,第二张会作为尾帧图参与生成,当前每次生成消耗 57 积分。 Fixed output: 1080P · 6s · 57 credits.
基础积分
积分费率: 57 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
1500 字符
参考素材
image · 2 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "hailuo-pro",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_optimizer | select | 否 | true | - | false, true |
| nsfw_checker | select | 否 | true | - | false, true |
Hailuo Standard
hailuo-standardAPI 可调用部分可用:需要 Files API视频 · MiniMax 旧线 Hailuo Standard 视频模型,支持文生视频和图生视频。图生侧可上传 1 到 2 张参考图,第二张会作为尾帧图参与生成。
基础积分
积分费率: 12–50 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"duration": "6",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 6 | - | 6, 10 |
| resolution | select | 否 | 768P | - | 512P, 768P |
| prompt_optimizer | select | 否 | true | - | false, true |
Kling 4.0
kling-4-0API 可调用部分可用:需要 Files API视频 · 选择首帧模式,通过文字或一张首帧图生成视频;选择参考模式,可使用文字或最多 10 张参考图。时长为 3–30 秒,分辨率为 720p / 1080p。用 @first_frame 或 @image_1、@image_2 引用已提供的图片。此处暂不支持参考视频、命名主体、音色以及中间帧或尾帧。
基础积分
积分费率: 28.5–42.5 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
8000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "kling-4-0",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"kling4_scene": "keyframe",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}
}参考素材规则
参考图片: 选择首帧模式,通过文字或一张首帧图生成视频;选择参考模式,可使用文字或最多 10 张参考图。时长为 3–30 秒,分辨率为 720p / 1080p。用 @first_frame 或 @image_1、@image_2 引用已提供的图片。此处暂不支持参考视频、命名主体、音色以及中间帧或尾帧。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| kling4_scene | select | 否 | keyframe | - | keyframe, reference |
| resolution | select | 否 | 720p | - | 720p, 1080p |
| duration | number | 否 | 5 | min 3 / max 30 / step 1 | - |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1, 21:9 |
Kling 4.0 Flash
kling-4-0-flashAPI 可调用部分可用:需要 Files API视频 · 选择首帧模式,通过文字或一张首帧图生成视频;选择参考模式,可使用文字或最多 10 张参考图。时长为 3–20 秒,分辨率为 720p。用 @first_frame 或 @image_1、@image_2 引用已提供的图片。此处暂不支持参考视频、命名主体、音色以及中间帧或尾帧。
基础积分
积分费率: 17 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
8000 字符
参考素材
image · 10 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "kling-4-0-flash",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"kling4_scene": "keyframe",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}
}参考素材规则
参考图片: 选择首帧模式,通过文字或一张首帧图生成视频;选择参考模式,可使用文字或最多 10 张参考图。时长为 3–20 秒,分辨率为 720p。用 @first_frame 或 @image_1、@image_2 引用已提供的图片。此处暂不支持参考视频、命名主体、音色以及中间帧或尾帧。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| kling4_scene | select | 否 | keyframe | - | keyframe, reference |
| resolution | select | 否 | 720p | - | 720p |
| duration | number | 否 | 5 | min 3 / max 20 / step 1 | - |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1, 21:9 |
Kling 3.0
kling-3-0API 可调用部分可用:需要 Files API视频 · 快手的高端视频模型,支持文生视频、图生视频、Standard (720P)、Pro (1080P) 和 4K 三档、单/多镜头结构、3–15 秒时长、可选音频,以及最多 2 张参考图。
基础积分
积分费率: 15.1–75.5 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| mode | select | 否 | pro | - | std, pro, 4k |
| multi_shots | select | 否 | false | - | false, true |
| duration | select | 否 | 5 | - | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
| sound | select | 否 | false | - | false, true |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1 |
Kling 3.0 motion-control
kling-3-0-motion-controlAPI 可调用需要 Files API视频 · 严格的 1 图 + 1 动作视频项目,身份和动作来源划分很清楚 Standard (720P) 22.7 × 经验证动作视频秒数;Pro (1080P) 30.2 × 秒数
基础积分
积分费率: 22.7–30.2 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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) 22.7 × 经验证动作视频秒数;Pro (1080P) 30.2 × 秒数
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| mode | select | 否 | 720p | - | 720p, 1080p |
| character_orientation | select | 否 | video | - | video, image |
Kling 3.0 Turbo
kling-3-turboAPI 可调用部分可用:需要 Files API视频 · Kling 3.0 Turbo 是 Rivya 上专注于纯提示词生成和单张静态图片动画的 Kling 视频模型。两种路径均支持 720p 与 1080p 输出,时长可设为 3 至 15 秒之间的整数;画幅比例仅适用于文生视频。
基础积分
积分费率: 20.2–25.2 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p |
| duration | number | 否 | 5 | min 3 / max 15 / step 1 | - |
| aspect_ratio | select | 否 | 16:9 | - | 1:1, 9:16, 16:9 |
基础积分
积分费率: 15.1–75.5 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p, 4k |
| duration | select | 否 | 5 | - | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
| audio | select | 否 | false | - | false, true |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1 |
Kling 2.6
kling-2-6API 可调用部分可用:需要 Files API视频 · 快手视频模型,可选音频生成、5/10 秒片段、3 种宽高比,擅长人物运动和表情丰富的角色动画,物理效果自然。
基础积分
积分费率: 63–252 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| sound | select | 否 | false | - | false, true |
| aspect_ratio | select | 否 | 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 那组额外场景控制时使用。
基础积分
积分费率: 12.6–20.2 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| mode | select | 否 | 720p | - | 720p, 1080p |
| character_orientation | select | 否 | video | - | video, image |
Kling V2.5 Turbo Pro
kling-v2-5-turbo-proAPI 可调用部分可用:需要 Files API视频 · 快手可灵 V2.5 Turbo Pro 视频模型,当前同时支持文生和图生。当前价格为:5 秒 63 积分,10 秒 126 积分。
基础积分
积分费率: 63–126 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1 |
| negative_prompt | text | 否 | - | max 2500 | - |
| cfg_scale | number | 否 | 0.5 | min 0 / max 1 / step 0.1 | - |
Kling V2.1 Master
kling-v2-1-masterAPI 可调用部分可用:需要 Files API视频 · 快手可灵旧版 V2.1 Master 视频模型,当前同时支持文生和图生。当前价格为:5 秒 252 积分,10 秒 504 积分。
基础积分
积分费率: 252–504 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, 1:1 |
| negative_prompt | text | 否 | - | max 500 | - |
| cfg_scale | number | 否 | 0.5 | min 0 / max 1 / step 0.1 | - |
Kling V2.1 Pro
kling-v2-1-proAPI 可调用需要 Files API视频 · 快手可灵旧版 V2.1 Pro 图生视频模型,支持首图与可选尾帧双图。当前价格为:5 秒 88 积分,10 秒 176 积分。
基础积分
积分费率: 88–176 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| negative_prompt | text | 否 | - | max 500 | - |
| cfg_scale | number | 否 | 0.5 | min 0 / max 1 / step 0.1 | - |
Kling V2.1 Standard
kling-v2-1-standardAPI 可调用需要 Files API视频 · 快手可灵旧版 V2.1 Standard 图生视频模型,当前价格为:5 秒 51 积分,10 秒 101 积分。
基础积分
积分费率: 50.5–101 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| negative_prompt | text | 否 | - | max 500 | - |
| cfg_scale | number | 否 | 0.5 | min 0 / max 1 / step 0.1 | - |
Kling AI Avatar Pro
kling-ai-avatar-proAPI 可调用需要 Files API视频 · 快手可灵 AI Avatar Pro 高质量数字人口播模型,使用 1 张人物图和 1 段音频生成口型同步视频。Rivya 按经验证的音频时长以 20.2 积分 / 秒计费,音频最长 300 秒,总积分向上取整。
基础积分
积分费率: 20.2 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
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 按经验证的音频时长以 10.1 积分 / 秒计费,音频最长 300 秒,总积分向上取整。
基础积分
积分费率: 10.1 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
image-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
5000 字符
参考素材
image, audio · 2 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
人物图与音频: 需要同时上传 1 张人物图和 1 段音频。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
不需要额外模型参数。
Infinitalk
infinitalkAPI 可调用需要 Files API视频 · Infinitalk 是一个基于图片和音频生成数字人口播视频的模型。当前价格按分辨率和音频时长计算:480p = 3 积分 / 秒,720p = 12 积分 / 秒。
基础积分
积分费率: 3–12 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 480p | - | 480p, 720p |
| seed | number | 否 | - | min 10000 / max 1000000 | - |
Runway
runwayAPI 可调用部分可用:需要 Files API视频 · Runway 是一个支持文生视频和图生视频的独立视频模型。当前公开价格只明确覆盖 3 个生成档位,因此 Rivya 先按可确认的 `720p_5 = 12`、`720p_10 = 30`、`1080p_5 = 30` 接入。
基础积分
积分费率: 12–30 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | select | 否 | 5 | - | 5, 10 |
| quality | select | 否 | 720p | - | 720p, 1080p |
| aspectRatio | select | 否 | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16 |
| waterMark | text | 否 | - | - | - |
Runway Aleph
runway-aleph这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。视频 · Runway Aleph 编辑已有视频,与仅根据文字生成新片段不同。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 调用它。
参数
不需要额外模型参数。
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视频 · 通过文字或一张参考图生成 1–15 秒视频,可选 480p、720p 或 1080p。提示词最多 4096 个字符。
基础积分
积分费率: 2.4–8 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
4096 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "grok-imagine-video",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"duration": 8,
"resolution": "480p",
"aspect_ratio": "auto",
"nsfw_checker": "true"
}
}参考素材规则
参考图片: 可选添加 1 张 JPEG、PNG 或 WebP 图片,大小不超过 20 MB。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| duration | number | 否 | 8 | min 1 / max 15 / step 1 | - |
| resolution | select | 否 | 480p | - | 480p, 720p, 1080p |
| aspect_ratio | select | 否 | auto | - | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4 |
| nsfw_checker | select | 否 | true | - | true, false |
Grok Imagine Video Original
grok-imagine-video-originalAPI 可调用部分可用:需要 Files API视频 · 通过文字或参考图生成 6–30 秒的 480p、720p 或 1080p 视频。480p/720p 最多添加 7 张参考图,1080p 最多 1 张;每张须为 JPEG、PNG 或 WebP,不超过 10 MB。音频与视频一同生成,无法关闭。Rivya 使用 Normal 模式。
基础积分
积分费率: 2.4–8 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 7 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "grok-imagine-video-original",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"resolution": "480p",
"duration": 6,
"aspect_ratio": "2:3"
}
}参考素材规则
参考图片: 通过文字或参考图生成 6–30 秒的 480p、720p 或 1080p 视频。480p/720p 最多添加 7 张参考图,1080p 最多 1 张;每张须为 JPEG、PNG 或 WebP,不超过 10 MB。音频与视频一同生成,无法关闭。Rivya 使用 Normal 模式。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 480p | - | 480p, 720p, 1080p |
| duration | number | 否 | 6 | min 6 / max 30 / step 1 | - |
| aspect_ratio | select | 否 | 2:3 | - | 2:3, 3:2, 1:1, 16:9, 9:16 |
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这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。视频 · 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这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。视频 · 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。
基础积分
积分费率: 8–14 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
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_factor | select | 否 | 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 结果不能再次处理。
基础积分
积分费率: 225–285 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| generationType | select | 否 | FIRST_AND_LAST_FRAMES_2_VIDEO | - | FIRST_AND_LAST_FRAMES_2_VIDEO |
| aspectRatio | select | 否 | 16:9 | - | 16:9, 9:16, Auto |
| resolution | select | 否 | 720p | - | 720p, 1080p, 4k |
| duration | select | 否 | 8 | - | 4, 6, 8 |
| watermark | text | 否 | - | - | - |
| enableTranslation | select | 否 | true | - | true, false |
Veo3.1 Fast
veo3-1-fastAPI 可调用部分可用:需要 Files API视频 · 支持纯文本、首尾帧和 1~3 张参考图生成,可直接选择 720p/1080p/4K 和 4/6/8 秒。 音频能力仍属实验性且不保证可用;交付前必须逐条人工检查。
基础积分
积分费率: 30–90 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| generationType | select | 否 | TEXT_2_VIDEO | - | TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO |
| aspectRatio | select | 否 | 16:9 | - | 16:9, 9:16, Auto |
| resolution | select | 否 | 720p | - | 720p, 1080p, 4k |
| duration | select | 否 | 8 | - | 4, 6, 8 |
| watermark | text | 否 | - | - | - |
| enableTranslation | select | 否 | true | - | true, false |
Veo3.1 Lite
veo3-1-liteAPI 可调用部分可用:需要 Files API视频 · 支持纯文本、首尾帧和 1~3 张参考图生成,可直接选择 720p/1080p/4K 和 4/6/8 秒。 音频能力仍属实验性且不保证可用;交付前必须逐条人工检查。
基础积分
积分费率: 15–75 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| generationType | select | 否 | FIRST_AND_LAST_FRAMES_2_VIDEO | - | FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO |
| aspectRatio | select | 否 | 16:9 | - | 16:9, 9:16, Auto |
| resolution | select | 否 | 720p | - | 720p, 1080p, 4k |
| duration | select | 否 | 8 | - | 4, 6, 8 |
| watermark | text | 否 | - | - | - |
| enableTranslation | select | 否 | true | - | true, false |
基础积分
积分费率: 7.2–62.4 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
image-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
20000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考图片: 上传一张JPEG、PNG或WebP起始图,不超过50 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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 540p, 720p, 1080p, 2k, 4k |
| duration | number | 否 | 5 | min 3 / max 16 / step 1 | - |
| audio | select | 否 | true | - | true, false |
Gemini Omni 1.2 Flash
gemini-omni-flash-1-2API 可调用部分可用:需要 Files API视频 · 通过文字、参考图或首尾帧生成视频,也可编辑一段已有短视频。
基础积分
积分费率: 4–22 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
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-2",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"omni_scene": "reference",
"resolution": "720p",
"duration": 8,
"aspect_ratio": "16:9",
"seeds": 10000
}
}参考素材规则
参考文件: 可选 360p、720p、1080p、4k。文字、参考图或单首帧支持 3–15 秒,首尾帧支持 3–10 秒。视频编辑使用一段最长 15 秒的上传视频,时长随原视频,不发送时长控制字段。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| omni_scene | select | 否 | reference | - | reference, frames, edit |
| resolution | select | 否 | 720p | - | 360p, 720p, 1080p, 4k |
| duration | number | 否 | 8 | min 3 / max 15 / step 1 | - |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16, auto |
| seeds | number | 否 | - | min 10000 / max 99999 / step 1 | - |
Gemini Omni 1.1 Flash
gemini-omni-flash-1-1API 可调用部分可用:需要 Files API视频 · 用文字、参考图或源视频生成视频。支持 16:9、9:16 和 4、6、8、10 秒;有视频输入时,输出时长由模型决定。
基础积分
积分费率: 45–180 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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_mode | select | 否 | reference | - | reference, frames |
| resolution | select | 否 | 720p | - | 360p, 720p, 1080p, 4k |
| duration | select | 否 | 4 | - | 4, 6, 8, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16 |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
| video_start | number | 否 | - | min 0 / max 30 | - |
| video_ends | number | 否 | - | min 0 / max 30 | - |
Gemini Omni Video
gemini-omni-videoAPI 可调用部分可用:需要 Files API视频 · 用文字、参考图或源视频生成视频。支持 16:9、9:16 和 4、6、8、10 秒;有视频输入时,输出时长由模型决定。
基础积分
积分费率: 45–180 / 段视频 任务最终消耗向上取整到整数积分。
支持模式
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": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 720p | - | 720p, 1080p, 4k |
| duration | select | 否 | 4 | - | 4, 6, 8, 10 |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 9:16 |
| seed | number | 否 | - | min 0 / max 2147483647 | - |
| video_start | number | 否 | - | min 0 / max 30 | - |
| video_ends | number | 否 | - | min 0 / max 30 | - |
OmniHuman 2.0
omnihuman-2-0API 可调用需要 Files API视频 · 通过一张图片和 4–300 秒音频生成由音频驱动的视频。提示词可选,最多 300 个字符。
基础积分
积分费率: 14 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
image-audio-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
300 字符
参考素材
image, audio · 2 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
图片与音频: 上传 1 张小于 30 MB 的 JPEG、PNG 或 WebP 图片,以及 1 个小于 15 MB 的 MP3 或 WAV 音频。音频须为 4–300 秒。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| enable_watermark | select | 否 | true | - | true, false |
OmniHuman 1.5
omnihuman-1-5API 可调用需要 Files API视频 · OmniHuman 1.5 可将恰好一张肖像图片和一段音频转换为音频驱动的角色视频,支持 720p 或 1080p 输出,积分按验签后的音频时长计算。
基础积分
积分费率: 27 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
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_resolution | select | 否 | 1080 | - | 720, 1080 |
| pe_fast_mode | select | 否 | false | - | false, true |
| seed | number | 否 | -1 | - | - |
Volcengine Video Lip Sync
volcengine-video-lip-syncAPI 可调用需要 Files API视频 · Volcengine Video Lip Sync 可让一个现有视频中的说话动作改为跟随一条目标人声轨道,支持 Lite 或 Basic 处理模式,并按时长计费。 输出为 25 FPS 的 MP4,时长跟随目标音频。
基础积分
积分费率: 8 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| mode | select | 是 | lite | - | lite, basic |
| separate_vocal | select | 否 | false | - | false, true |
| open_scenedet | select | 否 | false | - | false, true |
| align_audio | select | 否 | true | - | true, false |
| align_audio_reverse | select | 否 | false | - | false, true |
| templ_start_seconds | number | 否 | 0 | min 0 | - |
PixVerse V6
pixverse-v6API 可调用部分可用:需要 Files API视频 · 通过文字、1–2 张首尾帧图或最多 7 张参考图生成 1–15 秒视频。可选 360p、540p、720p 或 1080p,并可开启音频生成。
基础积分
积分费率: 4–18.4 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video, reference-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 7 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "pixverse-v6",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"pixverse_scene": "text",
"quality": "720p",
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio_switch": "false",
"generate_multi_clip_switch": "false",
"seed": 0
}
}参考素材规则
参考图片: 通过文字、1–2 张首尾帧图或最多 7 张参考图生成 1–15 秒视频。可选 360p、540p、720p 或 1080p,并可开启音频生成。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| pixverse_scene | select | 否 | text | - | text, image, reference |
| quality | select | 否 | 720p | - | 360p, 540p, 720p, 1080p |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 |
| duration | number | 否 | 5 | min 1 / max 15 / step 1 | - |
| generate_audio_switch | select | 否 | false | - | false, true |
| generate_multi_clip_switch | select | 否 | false | - | false, true |
| seed | number | 否 | - | min 0 / max 2147483647 / step 1 | - |
PixVerse V6 Max
pixverse-v6-maxAPI 可调用部分可用:需要 Files API视频 · 通过文字或一张图片生成 1–15 秒视频。可选 360p、540p、720p 或 1080p,并可开启音频生成。
基础积分
积分费率: 4.8–22.4 / 秒输出 任务最终消耗向上取整到整数积分。
支持模式
text-to-video, image-to-video
API 输入状态
部分可用:需要 Files API
输入类型
text, file
提示词上限
5000 字符
参考素材
image · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "pixverse-v6-max",
"prompt": "镜头缓慢环绕摄影棚桌面上的一个产品瓶。",
"params": {
"quality": "720p",
"duration": 5,
"generate_audio_switch": "false",
"aspect_ratio": "16:9",
"seed": 0
}
}参考素材规则
首帧图片: 可选上传 1 张 JPEG、PNG 或 WebP 图片,不超过 20 MB,每边最多 10000 像素。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
提示词或 URL 模式可能已经可调用;参考素材模式仍需要 Files API 上传支持。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| quality | select | 否 | 720p | - | 360p, 540p, 720p, 1080p |
| duration | number | 否 | 5 | min 1 / max 15 / step 1 | - |
| generate_audio_switch | select | 否 | false | - | false, true |
| aspect_ratio | select | 否 | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 |
| seed | number | 否 | - | min 0 / max 2147483647 / step 1 | - |
基础积分
积分费率: 1.5–6 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
video-to-video
API 输入状态
需要 Files API
输入类型
file
提示词上限
-
参考素材
video · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
参考文件: 支持不超过 50 MB、60 秒的 MP4、MOV 或 WebM。画面按比例适配所选输出框,不裁剪;较大源视频可能缩小。保留原有声音、帧率和帧数。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| resolution | select | 否 | 2K | - | 1080P, 2K, 4K |
Suno Music
suno-musicAPI 可调用文本输入可用音频 · 以自定义模式创作音乐。标题(最多 80 字符)和音乐风格(最多 1000 字符)必填。人声歌曲须输入最多 5000 字符的歌词;纯器乐请留空歌词。可选 V6、V6 Mini 或 V6 Wild,目标时长为 10–360 秒。
基础积分
积分费率: 12 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-audio
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "suno-music",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"model": "V6",
"instrumental": "false",
"duration": 30,
"title": "Suno Music",
"style": "原声民谣、轻柔节奏、温暖人声"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| model | select | 否 | V6 | - | V6, V6_MINI, V6_WILD |
| instrumental | select | 否 | true | - | true, false |
| title | text | 是 | - | - | - |
| style | text | 是 | - | - | - |
| duration | number | 否 | 30 | min 10 / max 360 / step 1 | - |
基础积分
积分费率: 2.5 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-audio
API 输入状态
文本输入可用
输入类型
text
提示词上限
500 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "suno-sounds",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| model | select | 否 | V6 | - | V6, V6_MINI, V6_WILD |
| soundLoop | select | 否 | false | - | false, true |
| soundTempo | number | 否 | - | min 1 / max 300 / step 1 | - |
| soundKey | select | 否 | 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 |
基础积分
积分费率: 0.4 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-audio
API 输入状态
文本输入可用
输入类型
text
提示词上限
200 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "suno-lyrics",
"prompt": "欢迎。接下来为你简要介绍这款产品。"
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
不需要额外模型参数。
Suno Speech
suno-speechAPI 可调用文本输入可用音频 · Suno Speech 根据场景或脚本生成有语气、节奏与情绪的口播。简单模式根据场景编写内容;高级模式朗读你提供的脚本。
基础积分
积分费率: 12 / 次请求 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "suno-speech",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"customMode": "false"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| customMode | select | 否 | false | - | false, true |
| tone | text | 否 | - | max 1000 | - |
| variety | number | 否 | - | min 0 / max 4 / step 1 | - |
| vocalGender | select | 否 | f | - | f, m |
| backgroundMusic | select | 否 | false | - | false, true |
ElevenLabs Dialogue V3
elevenlabs-dialogue-v3API 可调用文本输入可用音频 · ElevenLabs 在 Rivya 上的多角色对白模型,适合生成带有说话人切换节奏的对话音频,用于播客、访谈和角色对白。
基础积分
积分费率: 14 / 1,000 字符 任务最终消耗向上取整到整数积分。
支持模式
dialogue-to-audio
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "elevenlabs-dialogue-v3",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"default_voice": "Adam",
"stability": "0.5",
"dialogue": [
{
"voice": "Adam",
"text": "欢迎观看我们的产品演示。"
},
{
"voice": "Alice",
"text": "一起来看看它是如何运作的。"
}
]
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| default_voice | select | 否 | Adam | - | Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will |
| stability | select | 否 | 0.5 | - | 0, 0.5, 1 |
| language_code | text | 否 | - | - | - |
ElevenLabs Turbo 2.5
elevenlabs-turbo-2-5API 可调用文本输入可用音频 · ElevenLabs 在 Rivya 上的快速文本转语音模型,低延迟语音生成并支持稳定性、相似度、风格和速度调节,适合快节奏配音和口播试稿。
基础积分
积分费率: 6 / 1,000 字符 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "elevenlabs-turbo-2-5",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice | select | 是 | TX3LPaxmHKxFdv7VOQHJ | - | TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8 |
| stability | number | 否 | 0.5 | min 0 / max 1 / step 0.05 | - |
| similarity_boost | number | 否 | 0.75 | min 0 / max 1 / step 0.05 | - |
| style | number | 否 | 0 | min 0 / max 1 / step 0.05 | - |
| speed | number | 否 | 1 | min 0.7 / max 1.2 / step 0.05 | - |
| timestamps | select | 否 | false | - | false, true |
| previous_text | text | 否 | - | - | - |
| next_text | text | 否 | - | - | - |
| language_code | text | 否 | - | - | - |
ElevenLabs Multilingual V2
elevenlabs-multilingual-v2API 可调用文本输入可用音频 · ElevenLabs 在 Rivya 上的多语言文本转语音模型,支持约 30 种语言自动检测,更适合全球内容本地化和跨语言配音。
基础积分
积分费率: 12 / 1,000 字符 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
5000 字符
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "elevenlabs-multilingual-v2",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"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 | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice | select | 是 | TX3LPaxmHKxFdv7VOQHJ | - | TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8 |
| stability | number | 否 | 0.5 | min 0 / max 1 / step 0.05 | - |
| similarity_boost | number | 否 | 0.75 | min 0 / max 1 / step 0.05 | - |
| style | number | 否 | 0 | min 0 / max 1 / step 0.05 | - |
| speed | number | 否 | 1 | min 0.7 / max 1.2 / step 0.05 | - |
| timestamps | select | 否 | false | - | false, true |
| previous_text | text | 否 | - | - | - |
| next_text | text | 否 | - | - | - |
ElevenLabs Sound Effect V2
elevenlabs-sound-effect-v2这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。音频 · ElevenLabs Sound Effects 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这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。音频 · 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-ttsAPI 可调用文本输入可用音频 · 使用 Gemini 3.8 Flash TTS 将短文稿转为语音。选择一种预设音色,生成单人朗读音频。
基础积分
基础费率(积分/百万 token):输入 70,输出 1,260 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
最多 1,024 个 UTF-8 字节
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "gemini-3-8-flash-tts",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"voice_name": "Zephyr"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice_name | select | 否 | Zephyr | - | Zephyr, Puck, Kore |
Gemini 3.8 Flash-Lite TTS
gemini-3-8-flash-lite-ttsAPI 可调用文本输入可用音频 · 使用 Gemini 3.8 Flash-Lite TTS 将短文稿转为语音。选择一种预设音色,生成单人朗读音频。
基础积分
基础费率(积分/百万 token):输入 70,输出 840 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
最多 1,024 个 UTF-8 字节
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "gemini-3-8-flash-lite-tts",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"voice_name": "Zephyr"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice_name | select | 否 | Zephyr | - | Zephyr, Puck, Kore |
Gemini 3.1 Flash TTS
gemini-3-1-flash-ttsAPI 可调用文本输入可用音频 · 使用 Gemini 3.1 Flash TTS 将短文稿转为语音。选择一种预设音色,生成单人朗读音频。
基础积分
基础费率(积分/百万 token):输入 140,输出 2,800 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
最多 1,024 个 UTF-8 字节
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "gemini-3-1-flash-tts",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"voice_name": "Zephyr"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice_name | select | 否 | Zephyr | - | Zephyr, Puck, Kore |
Gemini 2.5 Pro TTS
gemini-2-5-pro-ttsAPI 可调用文本输入可用音频 · 使用 Gemini 2.5 Pro TTS 将短文稿转为语音。选择一种预设音色,生成单人朗读音频。
基础积分
基础费率(积分/百万 token):输入 140,输出 2,800 任务最终消耗向上取整到整数积分。
支持模式
text-to-speech
API 输入状态
文本输入可用
输入类型
text
提示词上限
最多 1,024 个 UTF-8 字节
参考素材
-
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
{
"model": "gemini-2-5-pro-tts",
"prompt": "欢迎。接下来为你简要介绍这款产品。",
"params": {
"voice_name": "Zephyr"
}
}参考素材规则
-
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
参数
| key | 类型 | 必填 | 默认值 | 范围 | 枚举值 |
|---|---|---|---|---|---|
| voice_name | select | 否 | Zephyr | - | Zephyr, Puck, Kore |
Nemotron 3.5 Transcribe
nemotron-3-5-transcribeAPI 可调用需要 Files API音频 · 转写一个最长 60 分钟、不超过 95 MB 的 MP3 或 WAV 文件,结果以文字返回。此处暂不支持逐词时间戳、翻译或视频输入。
基础积分
积分费率: 0.005 / 秒输入 任务最终消耗向上取整到整数积分。
支持模式
audio-to-text
API 输入状态
需要 Files API
输入类型
file
提示词上限
-
参考素材
audio · 1 个文件
请求
POST /api/v1/generations
鉴权
Bearer API Key
Idempotency-Key
建议使用
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
音频: 转写一个最长 60 分钟、不超过 95 MB 的 MP3 或 WAV 文件,结果以文字返回。此处暂不支持逐词时间戳、翻译或视频输入。
结果读取
创建响应会返回公开任务 ID。继续轮询 GET /api/v1/generations/{taskId},直到状态变为 succeeded 或 failed。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, not_found
基于文件的模式需要 /api/v1/files 完成后,才能展示为完整 API-ready 示例。 Files API
参数
不需要额外模型参数。
GPT 6.1 Sol
gpt-6-1-sol-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 120,输出 600 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-6-1-sol-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT 6.1 Terra
gpt-6-1-terra-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 60,输出 300 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-6-1-terra-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT 6 Astra
gpt-6-astra-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 560,输出 2,800 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-6-astra-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 120,输出 600 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-6-sol-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 6,输出 30 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-6-luna-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT-5.6 Luna
gpt-5-6-luna-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 11.2,输出 67.2 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-5-6-luna-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT-5.6 Terra
gpt-5-6-terra-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 112,输出 672 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-5-6-terra-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT-5.6 Sol
gpt-5-6-sol-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 280,输出 1,680 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-5-6-sol-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 140,输出 840 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-5-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT-5.4
gpt-5-4-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
GPT-5.4 Codex
gpt-5.4-codex-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
GPT-5.3 Codex
gpt-5-3-codex-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
GPT-5.2
gpt-5-2-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。 完整响应准备好后,答案会一次显示。
基础积分
基础费率(积分/百万 token):输入 87.5,输出 700 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gpt-5-2-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
GPT-5.2 Codex
gpt-5-2-codex-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
GPT-5.1 Codex
gpt-5-1-codex-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
GPT-5 Codex
gpt-5-codex-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Gemini 4 Argon
gemini-4-argon-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 160,输出 800 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-4-argon-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 4 Carbon
gemini-4-carbon-chatAPI 可调用文本输入可用对话 · 使用 Gemini 4 Carbon 进行纯文本对话,核验完整响应后一次交付答案。
基础积分
基础费率(积分/百万 token):输入 160,输出 800 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-4-carbon-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 3.8 Flash
gemini-3-8-flash-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 45,输出 225 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-3-8-flash-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 3.7 Flash
gemini-3-7-flash-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Gemini 3.7 Flash 目前作为兼容别名指向 Gemini 3.8 Flash。Rivya 保留此条目供查询,不作为独立可调用模型。新对话请选择 Gemini 3.8 Flash。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Gemini 3.6 Flash
gemini-3-6-flash-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 45,输出 225 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-3-6-flash-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 3.5 Flash
gemini-3-5-flash-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Gemini 3.5 Flash Chat 在 Rivya 不可用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Gemini 3.1 Pro
gemini-3-1-pro-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 100,输出 700 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-3-1-pro-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 3 Pro
gemini-3-pro-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 50,输出 350 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "gemini-3-pro-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Gemini 3 Flash
gemini-3-flash-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Gemini 2.5 Pro
gemini-2-5-pro-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Gemini 2.5 Pro Chat 在 Rivya 不可用;Gemini 2.5 Pro TTS 是独立的语音模型。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Gemini 2.5 Flash
gemini-2-5-flash-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Rivya目前不提供此确切版本,请选择可用型号继续使用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 320,输出 1,600 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-5-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Sonnet 5.5
claude-sonnet-5-5-chatAPI 可调用文本输入可用对话 · 发送文字消息并继续对话。每次回复的输出上限为 4096 个 token。
基础积分
基础费率(积分/百万 token):输入 160,输出 800 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-sonnet-5-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Haiku 5.5
claude-haiku-5-5-chatAPI 可调用文本输入可用对话 · Claude Haiku 5.5 — 通过纯文字对话整理思路、起草内容或讨论问题。
基础积分
基础费率(积分/百万 token):输入 12,输出 60 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-haiku-5-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Fable 5.2
claude-fable-5-2-chat这个模型已规划接入 Public API,但目前还不能调用。这个模型已规划接入 Public API,但目前还不能调用。对话 · Claude Fable 5.2 是 Rivya 目录中的对话模型预告。本页区分新预告、旧 Fable 名称与当前可用的 Claude 选择。
基础积分
这个模型已规划接入 Public API,但目前还不能调用。
支持模式
API 输入状态
这个模型已规划接入 Public API,但目前还不能调用。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型已规划接入 Public API,但目前还不能调用。
参数
不需要额外模型参数。
Claude Fable 5.1
claude-fable-5-1-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · 该模型已列入目录,但当前生成合同和积分价格尚未确认,因此 Rivya 暂不开放调用。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Claude Fable 5
claude-fable-5-chatAPI 可调用文本输入可用对话 · Rivya 上以文本为主的 Claude 对话模型,适合叙事重构、面向特定读者的草稿和结构化编辑工作。
基础积分
基础费率(积分/百万 token):输入 800,输出 4,000 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-fable-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Sonnet 5
claude-sonnet-5-chatAPI 可调用文本输入可用对话 · Rivya 上以文本为主的 Claude 对话模型,适合实施简报、需求审阅和精炼的技术规划。
基础积分
基础费率(积分/百万 token):输入 170,输出 855 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-sonnet-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Opus 5
claude-opus-5-chatAPI 可调用文本输入可用对话 · Rivya 上以文本为主的 Claude 对话模型,适合董事会层面的风险梳理、情景比较和决策记录。
基础积分
基础费率(积分/百万 token):输入 400,输出 2,000 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Opus 4.8
claude-opus-4-8-chatAPI 可调用文本输入可用对话 · Rivya 上以文本为主的 Claude 对话模型,适合审阅高密度资料包并形成谨慎、结构化的决策结论。
基础积分
基础费率(积分/百万 token):输入 400,输出 2,000 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-4-8-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Opus 4.7
claude-opus-4-7-chatAPI 可调用文本输入可用对话 · Anthropic 在 Rivya 上的旗舰 Claude 对话模型,适合深度推理、谨慎整合、管理层写作和高影响文本任务。
基础积分
基础费率(积分/百万 token):输入 285,输出 1,430 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-4-7-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 285,输出 1,430 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-4-6-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Sonnet 4.6
claude-sonnet-4-6-chatAPI 可调用文本输入可用对话 · Anthropic 在 Rivya 上均衡型的 Claude AI 对话模型,延续长文理解和审慎分析能力,适合内容、研究和代码协作,又不用一开始就上 Opus 档位。
基础积分
基础费率(积分/百万 token):输入 170,输出 855 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-sonnet-4-6-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 285,输出 1,430 任务最终消耗向上取整到整数积分。
支持模式
claude-messages
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-opus-4-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Sonnet 4.5
claude-sonnet-4-5-chatAPI 可调用文本输入可用对话 · Anthropic 在 Rivya 上均衡型的 Claude AI 对话模型,擅长细腻写作、审慎分析和更克制的响应,适合内容创作和研究。
基础积分
基础费率(积分/百万 token):输入 170,输出 855 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-sonnet-4-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Claude Haiku 4.5
claude-haiku-4-5-chatAPI 可调用文本输入可用对话 · Anthropic 在 Rivya 上轻量型的 Claude AI 对话模型,强调速度、成本效率和稳定的日常对话表现,适合高频使用场景。
基础积分
基础费率(积分/百万 token):输入 55,输出 285 任务最终消耗向上取整到整数积分。
支持模式
chat-completion
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "claude-haiku-4-5-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
Grok 4.7
grok-4-7-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · 根据 xAI 指南,Grok 4.7 面向代码、代理任务与知识工作。Rivya 当前暂停此型号的新请求。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Grok 4.6
grok-4-6-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Grok 4.6 面向代码、代理任务与知识工作。Rivya 当前暂停此型号的新请求。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Grok 4.5
grok-4-5-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · Grok 4.5 面向代码、工程与代理工作流。Rivya 当前暂停此型号的新请求。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Grok 4.3
grok-4-3-chat这个请求暂时不可用,请稍后重试。这个请求暂时不可用,请稍后重试。对话 · xAI 将 Grok 4.3 描述为侧重指令遵循和工具调用的快速模型。Rivya 当前暂停此型号的新请求。
基础积分
这个请求暂时不可用,请稍后重试。
支持模式
API 输入状态
这个请求暂时不可用,请稍后重试。
输入类型
-
提示词上限
-
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
这个模型不展示可运行 Public API 示例。
参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
这个模型只用于规划和对比。状态变为 API 可调用前,不要通过 Public API v1 调用它。
参数
不需要额外模型参数。
Kimi K3.1 Pro
kimi-k3-1-pro-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 160,输出 800 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "kimi-k3-1-pro-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
基础积分
基础费率(积分/百万 token):输入 480,输出 2,400 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "kimi-k3-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
DeepSeek V4.1 Flash
deepseek-v4-1-flash-chatAPI 可调用文本输入可用对话 · 仅支持文本聊天,不提供附件或联网搜索。发送前按保守的输出上界预扣积分,最终按已确认的消耗结算。
基础积分
基础费率(积分/百万 token):输入 24,输出 95 任务最终消耗向上取整到整数积分。
支持模式
responses
API 输入状态
文本输入可用
输入类型
text
提示词上限
20000 字符
参考素材
-
请求
POST /api/v1/chat/completions
鉴权
Bearer API Key
Idempotency-Key
重试请求时,请使用相同的 Idempotency-Key 和请求体。尚未完成或内容已变更的请求可能返回 idempotency_conflict;发起新请求前,请先检查原来的对话轮次。
请求体
{
"model": "deepseek-v4-1-flash-chat",
"message": "列出开展产品图片推广活动的三个步骤。"
}参考素材规则
-
结果读取
非流式 Chat 会返回助手消息、session_id、token 用量,以及带有结算状态的积分用量。使用 session_id 继续对话;不要轮询生成任务端点。
常见错误
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API 在 Public API v1 中支持非 streaming 和 SSE streaming 回合。 这个 Chat 模型不支持图片附件。
参数
不需要额外模型参数。
