- NewAPI - 全量后端接口包
- 外部 API：Midjourney
- 读取 /{mode}/mj/image/{id} 接口
- 提交 /{mode}/mj/insight-face/swap 接口
- 提交 /{mode}/mj/submit/action 接口
- 提交 /{mode}/mj/submit/blend 接口
- 提交 /{mode}/mj/submit/change 接口
- 提交 /{mode}/mj/submit/describe 接口
- 提交 /{mode}/mj/submit/edits 接口
- 提交 /{mode}/mj/submit/imagine 接口
- 提交 /{mode}/mj/submit/modal 接口
- 提交 /{mode}/mj/submit/shorten 接口
- 提交 /{mode}/mj/submit/simple-change 接口
- 提 交 /{mode}/mj/submit/upload-discord-images 接口
- 提交 /{mode}/mj/submit/video 接口
- 读取 /{mode}/mj/task/{id}/fetch 接口
- 读取 /{mode}/mj/task/{id}/image-seed 接口
- 提交 /{mode}/mj/task/list-by-condition 接口
- 读取 /mj/image/{id} 接口
- 提交 /mj/insight-face/swap 接口
- 提交 /mj/submit/action 接口
- 提交 /mj/submit/blend 接口
- 提交 /mj/submit/change 接口
- 提交 /mj/submit/describe 接口
- 提交 /mj/submit/edits 接口
- 提交 /mj/submit/imagine 接口
- 提交 /mj/submit/modal 接口
- 提交 /mj/submit/shorten 接口
- 提交 /mj/submit/simple-change 接口
- 提交 /mj/submit/upload-discord-images 接口
- 提交 /mj/submit/video 接口
- 读取 /mj/task/{id}/fetch 接口
- 读取 /mj/task/{id}/image-seed 接口
- 提交 /mj/task/list-by-condition 接口
- 公共内容与首次安装
- 管理员用户、权限与预填组
- 管理员渠道：基础管理
- 管理员渠道：运维、密钥与 Codex
- 管理员渠道：上游模型同步
- 管理员渠道：Ollama 模型操作
- 支付 Provider 服务端回调
- Root 自定义 OAuth Provider
- 仪表盘与用量分析
- 管理员模型部署
- 读取 /api/deployments/ 接口
- 提交 /api/deployments/ 接口
- 删除 /api/deployments/{id} 接口
- 读取 /api/deployments/{id} 接口
- 更新 /api/deployments/{id} 接口
- 读取 /api/deployments/{id}/containers 接口
- 读取 /api/deployments/{id}/containers/{container_id} 接口
- 提交 /api/deployments/{id}/extend 接口
- 读取 /api/deployments/{id}/logs 接口
- 更新 /api/deployments/{id}/name 接口
- 读取 /api/deployments/available-replicas 接口
- 读取 /api/deployments/check-name 接口
- 读取 /api/deployments/hardware-types 接口
- 读取 /api/deployments/locations 接口
- 提交 /api/deployments/price-estimation 接口
- 读取 /api/deployments/search 接口
- 读取 /api/deployments/settings 接口
- 提交 /api/deployments/settings/test-connection 接口
- 提交 /api/deployments/test-connection 接口
- 使用日志、Midjourney 与任务历史
- Root 运行状态、性能与系统任务
- 读取 /api/log/channel_affinity_usage_cache 接口
- 读取 /api/perf-metrics 接口
- 读取 /api/perf-metrics/summary 接口
- 删除 /api/performance/disk_cache 接口
- 提交 /api/performance/gc 接口
- 删除 /api/performance/logs 接口
- 读取 /api/performance/logs 接口
- 提交 /api/performance/reset_stats 接口
- 读取 /api/performance/stats 接口
- 测试系统状态
- 读取 /api/system-info/instances 接口
- 删除 /api/system-info/instances/{node_name} 接口
- 删除 /api/system-info/stale-instances 接口
- 读取 /api/system-task/{task_id} 接口
- 读取 /api/system-task/current 接口
- 读取 /api/system-task/list 接口
- 创建日志清理任务
- API Key 与 Key 自助用量
- 管理员模型与厂商目录
- 全局公告
- 浏览器 OAuth 与登录回调
- 个人资料与安全中心
- 绑定当前用户邮箱
- 开始 Telegram 账号绑定流程
- 绑定当前用户微信账号
- 重新生成 2FA 备用码
- 禁用 2FA
- 确认并启用已初始化的 2FA
- 初始化 2FA 登记材料
- 读取当前用户 2FA 状态
- 读取当前用户自定义 OAuth 绑定
- 解绑当前用户自定义 OAuth Provider
- 解绑当前用户 Passkey
- 读取当前用户 Passkey 状态
- 开始 Passkey 注册
- 完成 Passkey 注册
- 开始 Passkey 安全验证
- 完成 Passkey 安全验证并签发 proof
- 注销当前用户账号
- 读取当前用户安全资料
- 更新当前用户资料、语言、侧边栏或密码
- 读取当前用户可用分组
- 列出当前用户设备会话
- 撤销指定设备会话
- 撤销除当前会话外的所有设备会话
- 更新当前用户通知与日志设置
- 轮换 Dashboard 管理个人访问令牌
- 用 2FA 签发短期安全证明
- 登录、注册与会话
- Root 系统选项与支付配置
- 管理员定价与倍率同步
- 管理员兑换码
- 订阅计划与用户订阅
- 提交 /api/subscription/admin/bind 接口
- 读取 /api/subscription/admin/plans 接口
- 提交 /api/subscription/admin/plans 接口
- 部分更新 /api/subscription/admin/plans/{id} 接口
- 更新 /api/subscription/admin/plans/{id} 接口
- 提交 /api/subscription/admin/plans/{id}/subscriptions/reset 接口
- 删除 /api/subscription/admin/user_subscriptions/{id} 接口
- 提交 /api/subscription/admin/user_subscriptions/{id}/invalidate 接口
- 读取 /api/subscription/admin/users/{id}/subscriptions 接口
- 提交 /api/subscription/admin/users/{id}/subscriptions 接口
- 提交 /api/subscription/admin/users/{id}/subscriptions/reset 接口
- 提交 /api/subscription/balance/pay 接口
- 提交 /api/subscription/creem/pay 接口
- 提交 /api/subscription/epay/pay 接口
- 读取 /api/subscription/plans 接口
- 读取 /api/subscription/self 接口
- 更新 /api/subscription/self/preference 接口
- 提交 /api/subscription/stripe/pay 接口
- 提交 /api/subscription/waffo-pancake/pay 接口
- 浏览器订阅支付返回
- 钱包、充值与推广
- 读取或首次生成当前用户推广码
- 把当前用户推广额度转入可用额度
- 计算易支付充值金额
- 读取 /api/user/checkin 接口
- 提交 /api/user/checkin 接口
- 创建 Creem Checkout 充值订单
- 创建易支付充值订单并获取跳转参数
- 计算 Stripe 充值金额
- 创建 Stripe Checkout 充值订单
- 获取所有充值记录
- 提交 /api/user/topup 接口
- 管理员完成充值
- 读取当前用户钱包可用的充值配置
- 分页读取当前用户最近充值订单
- 提交 /api/user/waffo-pancake/amount 接口
- 提交 /api/user/waffo-pancake/pay 接口
- 提交 /api/user/waffo/amount 接口
- 提交 /api/user/waffo/pay 接口
- 在线 Playground
- 外部 API：兼容计费查询
- 外部 API：视频生成任务
- 外部 API：Suno 音乐任 务
- 外部 API：OpenAI 文本与 Responses
- 外部 API：OpenAI 图像与音频
- 外部 API：OpenAI 模型与嵌入
- 外部 API：已注册但未实现
- 外部 API：Anthropic Messages
- 外部 API：Gemini
- 外部 API：Realtime 与 Rerank
- 数据模型
- ApiResponse
- AuthSessionIssuanceError
- PageInfo
- Log
- User
- Channel
- Token
- Redemption
- ErrorResponse
- Usage
- Model
- ModelsResponse
- GeminiModelsResponse
- Message
- MessageContent
- ToolCall
- Tool
- ResponseFormat
- ChatCompletionRequest
- ChatCompletionResponse
- ChatCompletionStreamResponse
- CompletionRequest
- CompletionResponse
- ResponsesRequest
- ResponsesResponse
- ResponsesCompactionResponse
- ResponsesCompactionRequest
- ResponsesStreamResponse
- ClaudeRequest
- ClaudeMessage
- ClaudeResponse
- EmbeddingRequest
- EmbeddingResponse
- ImageGenerationRequest
- ImageEditRequest
- ImageResponse
- AudioTranscriptionRequest
- AudioTranslationRequest
- AudioTranscriptionResponse
- SpeechRequest
- RerankRequest
- RerankResponse
- ModerationRequest
- ModerationResponse
- GeminiRequest
- GeminiResponse
- VideoRequest
- VideoResponse
- VideoTaskResponse
- VideoTaskMetadata
- VideoTaskError
- OpenAIVideo
- OpenAIVideoError
- DashboardApiEnvelope
- DashboardAuthError
- OpenAIErrorEnvelope
- UnknownJsonObject
更新兑换码业务字段或状态
PUT
/api/redemption/
本地契约说明#
PUT /api/redemption/github.com/QuantumNous/new-api/controller.UpdateRedemption。web_vue。controller-confirmed-redemption。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之 后拼接 Token示例：
Authorization: Bearer ********************or
Query 参数
Body 参数application/json必填
示例
{
"id": 20,
"name": "调试批次",
"quota": 100000,
"expired_time": 0
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://api-dev.opensosen.cn/api/redemption/?status_only=undefined' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": 20,
"name": "调试批次",
"quota": 100000,
"expired_time": 0
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"success": true,
"message": "",
"data": {
"id": 20,
"user_id": 1,
"key": "<redacted-redemption-code>",
"status": 1,
"name": "调试批次",
"quota": 100000,
"created_time": 1786646400,
"redeemed_time": 0,
"count": 0,
"used_user_id": 0,
"expired_time": 0
}
}🟠401
🟠403
修改于 2026-08-14 17:19:51