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 錯誤與限制