API 积分

API 积分

了解 Rivya API 如何使用账户积分、余额检查、预留积分、失败退款和积分排查。

最近审阅于 2026/05/10

Rivya API 使用和 Studio 相同的账户积分钱包。

使用 GET /api/v1/credits 读取 API Key 所属账户的当前余额。

Endpoint

GET https://rivya.ai/api/v1/credits

必需 header：

Authorization: Bearer rvya_sk_...

响应

{
  "current_credits": 123
}

生成计费

提交生成任务时，Rivya 会检查账户是否有足够积分。

图片、视频和音频任务通常在任务开始时预留或消耗积分。生成响应包含：

reserved_credits
final_credits

任务仍在 queued 或 processing 时，final_credits 可能仍是 0。

失败任务

如果任务按 Rivya 现有失败规则失败，退款处理沿用和 Studio 相同的产品策略。

使用生成任务状态确认最终状态，并阅读失败任务与积分返还理解产品层失败模型。

常见积分错误

insufficient_credits：账户积分不足
api_key_invalid：API Key 无法识别账户
public_api_disabled：公开 API 暂时关闭

相关页面

Chat API

使用 Rivya Chat API 发送非 streaming 或 SSE turn，继续 API 创建的 session，使用 file_id 图片附件，并按 token usage 结算积分。

API 错误码与限制

处理 Rivya API 公共错误码、HTTP 状态、限流、幂等冲突和重试策略。