API 更新记录

这个页面记录会影响开发者的 Rivya API 公共变更。

2026-05-11

新增 Rivya API v1 首批接入文档：

• API 总览
• 快速开始
• 鉴权
• OpenAPI 与 schema 合同
• API 模型列表
• 动态模型 API Reference
• 提交生成任务
• 轮询生成任务状态
• 查询积分余额
• 错误码与限制
• Files API 参考素材上传
• API Webhooks 签名生成完成事件
• 非 streaming 与 streaming Chat API 和 API 创建的 session

当前 API 版本覆盖通过 API Key 和账户积分调用异步图片、视频和音频生成，也包含用于模型参考素材的 Files API 上传、用于生成任务终态通知的签名 webhooks，以及支持非 streaming 或 SSE streaming response 的 Chat API turn。

当前端点范围

• GET /api/v1/models
• POST /api/v1/generations
• POST /api/v1/files
• POST /api/v1/chat/completions
• GET /api/v1/chat/sessions
• GET /api/v1/chat/sessions/{sessionId}
• GET /api/v1/generations/{taskId}
• GET /api/v1/credits
• GET /api/v1/webhooks
• POST /api/v1/webhooks
• GET /api/v1/webhooks/{endpointId}
• PATCH /api/v1/webhooks/{endpointId}
• DELETE /api/v1/webhooks/{endpointId}
• POST /api/v1/webhooks/{endpointId}/rotate-secret
• GET /api/v1/webhook-events
• GET /api/v1/webhooks/{endpointId}/deliveries
• POST /api/v1/webhooks/{endpointId}/test
• GET /api/v1/openapi.json

尚未开放

这些能力不属于当前可调用 API：

• Chat webhook event
• 官方 SDK

兼容性说明

随着 Rivya 新增、移除或灰度模型，模型列表会变化。请使用 /api/v1/models 或 模型 API Reference，不要依赖固定模型数量。

相关页面

• Rivya API 总览
• OpenAPI 与 Schema 合同
• 模型 API Reference
• API 错误码与限制