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 错误码与限制