API 更新記錄

這個頁面記錄會影響開發者的公開 Rivya API 變更。

2026-05-11

Rivya API v1 的初始 API 文件集：

• API 總覽
• 快速開始
• 驗證
• OpenAPI 與 schema 合約
• API 模型清單
• 動態模型 API 參考
• 提交生成任務
• 輪詢生成狀態
• 點數餘額
• 錯誤與限制
• 用於參考上傳的 Files API
• 用於已簽名生成完成事件的 API webhooks
• 包含 API 建立工作階段的非串流與串流 Chat API

目前 API 版本透過 API keys 和帳號點數支援非同步圖片、影片和音訊生成。它也包含用於模型參考媒體的 Files API 上傳、用於終態生成事件的已簽名 webhooks，以及可使用非串流或 SSE 串流回應的 Chat API 回合。

目前端點範圍

• 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 events
• 官方 SDK

相容性說明

模型清單可能會隨著 Rivya 新增、移除或限制模型而改變。請使用 /api/v1/models 或 模型 API 參考，而不是依賴固定數量。

相關頁面

• Rivya API 總覽
• OpenAPI 與 Schema 合約
• 模型 API 參考
• API 錯誤與限制