{ "openapi": "3.1.0", "info": { "title": "MMS AI 开放平台", "version": "2026-10-12", "description": "独立 openai 协议边界。统一公开请求由内部服务商配置适配。生成前按模型配置预扣；完成后按实际用量/已确认账单结算，多退少补，失败释放；缺少真实用量时沿用冻结预估，不伪造 usage。当前 Beta 不保证 Idempotency-Key 去重。" }, "servers": [ { "url": "https://mmsai.cn/v1" } ], "security": [ { "BearerAuth": [] } ], "paths": { "/models": { "get": { "summary": "当前账户模型目录；available 表示配置可解析，不承诺上游实时成功", "operationId": "get__models", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Models" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "type", "in": "query", "schema": { "type": "string" } } ] } }, "/models/{model_id}": { "get": { "summary": "模型当前能力与统一参数约束", "operationId": "get__models_model_id", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Model" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "model_id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/pricing/models": { "get": { "summary": "与模型目录同集合的基础售价；账户折扣以最终结算为准", "operationId": "get__pricing_models", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Prices" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/balance": { "get": { "summary": "余额和套餐额度", "operationId": "get__balance", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Balance" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/chat/completions": { "post": { "summary": "统一交流；stream=false 返回 JSON，stream=true 返回 SSE", "operationId": "post__chat_completions", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatResponse" } }, "text/event-stream": { "schema": { "type": "string", "description": "data: chat.completion.chunk；终帧含 usage，结尾 [DONE]。开始输出后的错误使用 SSE error 事件。" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatRequest" } } } } } }, "/images/generations": { "post": { "summary": "图片生成", "operationId": "post__images_generations", "responses": { "202": { "description": "任务已受理，必须轮询终态", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAccepted" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageRequest" } } } } } }, "/videos/generations": { "post": { "summary": "视频生成", "operationId": "post__videos_generations", "responses": { "202": { "description": "任务已受理，必须轮询终态", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAccepted" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoRequest" } } } } } }, "/dramas/generations": { "post": { "summary": "短剧镜头生成", "operationId": "post__dramas_generations", "responses": { "202": { "description": "任务已受理，必须轮询终态", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAccepted" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoRequest" } } } } } }, "/audio/speech": { "post": { "summary": "异步语音合成，不直接返回音频字节", "operationId": "post__audio_speech", "responses": { "202": { "description": "任务已受理，必须轮询终态", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAccepted" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpeechRequest" } } } } } }, "/avatars/generations": { "post": { "summary": "异步唇形同步", "operationId": "post__avatars_generations", "responses": { "202": { "description": "任务已受理，必须轮询终态", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAccepted" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AvatarRequest" } } } } } }, "/tasks/{task_id}": { "get": { "summary": "任务状态、统一媒体数组和实际扣费摘要", "operationId": "get__tasks_task_id", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/files": { "post": { "summary": "上传生成参考素材", "operationId": "post__files", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "purpose": { "const": "generation", "default": "generation" } }, "required": [ "file" ], "additionalProperties": false } } } } } }, "/videos/seedance-2/character-assets/groups": { "post": { "summary": "登记人物素材组", "operationId": "post__videos_seedance_2_character_assets_groups", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Group" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupRequest" } } } } } }, "/videos/seedance-2/character-assets": { "post": { "summary": "登记人物素材", "operationId": "post__videos_seedance_2_character_assets", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Asset" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetRequest" } } } } } }, "/videos/seedance-2/character-assets/{asset_id}": { "get": { "summary": "查询素材状态", "operationId": "get__videos_seedance_2_character_assets_asset_id", "responses": { "200": { "description": "成功", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Asset" } } } }, "400": { "description": "字段缺失、格式错误、不支持的参数或模式", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "密钥无效", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "余额不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "权限不足", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "模型或资源不存在", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "限流；Retry-After 退避", "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "内部服务错误", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "上游服务不可用", "headers": { "x-request-id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "asset_id", "in": "path", "required": true, "schema": { "type": "string" } } ] } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "code": { "type": "string" }, "param": { "type": "string" }, "recharge_url": { "type": "string" } }, "required": [ "message", "type", "code" ] }, "request_id": { "type": "string" } }, "required": [ "error", "request_id" ], "additionalProperties": false }, "Media": { "type": "object", "properties": { "type": { "enum": [ "image", "video", "audio" ] }, "url": { "type": "string", "description": "临时签名媒体地址，取得后及时保存" }, "thumbnail_url": { "type": "string" }, "expires_at": { "type": "integer" } }, "required": [ "type", "url" ], "additionalProperties": false }, "Billing": { "type": "object", "properties": { "currency": { "const": "POINTS" }, "status": { "enum": [ "reserved", "settled", "refunded", "unavailable" ] }, "reserved_amount": { "type": "number" }, "charged_amount": { "type": "number" }, "adjustment_amount": { "type": "number", "description": "正数补扣，负数退款" } }, "required": [ "currency", "status" ], "additionalProperties": false }, "ChatRequest": { "type": "object", "properties": { "model": { "type": "string" }, "messages": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "role": { "enum": [ "system", "user", "assistant", "tool" ] }, "content": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object" } } ] }, "name": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_calls": { "type": "array" } }, "required": [ "role" ] } }, "stream": { "type": "boolean", "default": false }, "temperature": { "type": "number", "description": "仅在 limits.temperature.enabled=true 时传入，遵循 min/max" }, "max_completion_tokens": { "type": "integer", "minimum": 1, "description": "输出 Token 上限，按服务商配置映射实际字段" }, "max_tokens": { "type": "integer", "minimum": 1, "description": "兼容字段，不得与 max_completion_tokens 同时传入" } }, "required": [ "model", "messages" ], "additionalProperties": false }, "ChatResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "const": "chat.completion" }, "created": { "type": "integer" }, "model": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object", "required": [ "index", "message", "finish_reason" ] } }, "usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer", "minimum": 0 }, "completion_tokens": { "type": "integer", "minimum": 0 }, "total_tokens": { "type": "integer", "minimum": 0 } }, "required": [ "prompt_tokens", "completion_tokens", "total_tokens" ] } }, "required": [ "id", "object", "created", "model", "choices", "usage" ] }, "ImageRequest": { "type": "object", "properties": { "model": { "type": "string" }, "prompt": { "type": "string", "minLength": 1 }, "size": { "type": "string", "description": "比例，以 limits.sizes 为准" }, "resolution": { "type": "string" }, "quality": { "type": "string" }, "n": { "type": "integer", "minimum": 1 }, "image_urls": { "type": "array", "items": { "type": "string", "description": "公网 HTTPS 或上传返回的 file_id" } }, "output_format": { "type": "string" }, "background": { "type": "string" } }, "required": [ "model", "prompt" ], "additionalProperties": false }, "VideoRequest": { "type": "object", "properties": { "model": { "type": "string" }, "prompt": { "type": "string", "minLength": 1 }, "duration": { "type": "integer", "minimum": 1 }, "aspect_ratio": { "type": "string" }, "resolution": { "type": "string" }, "generate_audio": { "type": "boolean" }, "seed": { "type": "integer" }, "mode": { "enum": [ "text2video", "image2video", "video2video" ] }, "negative_prompt": { "type": "string" }, "image_with_roles": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "description": "真实公网 HTTPS、file_id 或已登记 asset://" }, "role": { "enum": [ "first_frame", "last_frame", "reference_image", "reference_video", "reference_audio" ] } }, "required": [ "url", "role" ], "additionalProperties": false } }, "video_with_roles": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "description": "真实公网 HTTPS、file_id 或已登记 asset://" }, "role": { "enum": [ "first_frame", "last_frame", "reference_image", "reference_video", "reference_audio" ] } }, "required": [ "url", "role" ], "additionalProperties": false } }, "audio_with_roles": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "description": "真实公网 HTTPS、file_id 或已登记 asset://" }, "role": { "enum": [ "first_frame", "last_frame", "reference_image", "reference_video", "reference_audio" ] } }, "required": [ "url", "role" ], "additionalProperties": false } } }, "required": [ "model", "prompt" ], "additionalProperties": false }, "SpeechRequest": { "type": "object", "properties": { "model": { "const": "mms-tts-base" }, "input": { "type": "string", "minLength": 1 }, "voice": { "type": "string", "minLength": 1, "description": "须使用真实平台音色 ID；当前无公开音色发现端点" }, "speed": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "model", "input", "voice" ], "additionalProperties": false }, "AvatarRequest": { "type": "object", "properties": { "model": { "const": "mms-tts-lip-sync" }, "avatar_file_id": { "type": "string" }, "audio_file_id": { "type": "string" }, "aspect_ratio": { "type": "string" } }, "required": [ "model", "avatar_file_id", "audio_file_id" ], "additionalProperties": false }, "TaskAccepted": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "const": "generation.task" }, "status": { "const": "queued" }, "model": { "type": "string" }, "created": { "type": "integer" }, "progress": { "type": "number" }, "request_id": { "type": "string" } }, "required": [ "id", "object", "status", "created", "request_id" ] }, "Task": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "const": "generation.task" }, "type": { "type": "string" }, "status": { "enum": [ "queued", "processing", "succeeded", "failed", "cancelled", "canceled" ] }, "progress": { "type": "number" }, "progress_message": { "type": "string" }, "created_at": { "type": "string", "description": "服务端数据库时间字符串，Asia/Shanghai" }, "updated_at": { "type": "string", "description": "服务端数据库时间字符串，Asia/Shanghai" }, "output": { "type": "array", "items": { "$ref": "#/components/schemas/Media" } }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false }, "billing": { "$ref": "#/components/schemas/Billing" } }, "required": [ "id", "object", "type", "status", "progress", "output", "billing" ] }, "Model": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "const": "model" }, "name": { "type": "string" }, "display_name": { "type": "string" }, "type": { "type": "string" }, "status": { "enum": [ "available", "degraded", "unavailable" ] }, "capabilities": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "object", "description": "当前渠道配置的公开约束；sizes/resolutions/counts/qualities/durations/aspect_ratios/modes/max_reference_images 等。未声明字段不保证支持。" }, "billing": { "type": "object" }, "stream": { "type": "boolean" }, "endpoints": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "object", "type", "status", "capabilities", "limits", "billing", "stream", "endpoints" ] }, "Models": { "type": "object", "properties": { "object": { "const": "list" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Model" } } }, "required": [ "object", "data" ] }, "Prices": { "type": "object", "properties": { "object": { "const": "list" }, "currency": { "const": "POINTS" }, "data": { "type": "array", "items": { "type": "object", "properties": { "model": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "price": { "type": "object", "properties": { "configured": { "type": "boolean" }, "currency": { "const": "POINTS" }, "rules": { "type": "array" }, "plan_version": { "type": "integer" } }, "required": [ "configured", "currency", "rules" ] } }, "required": [ "model", "name", "type", "price" ] } } }, "required": [ "object", "currency", "data" ] }, "Balance": { "type": "object", "properties": { "object": { "const": "balance" }, "currency": { "const": "POINTS" }, "available_balance": { "type": "string" }, "quotas": { "type": "object" }, "plan": { "type": "object" } }, "required": [ "object", "currency", "available_balance", "quotas", "plan" ] }, "File": { "type": "object", "properties": { "id": { "type": "string" }, "file_id": { "type": "string" }, "object": { "const": "file" }, "filename": { "type": "string" }, "bytes": { "type": "integer" }, "mime_type": { "type": "string" }, "purpose": { "const": "generation" }, "created_at": { "type": "integer" } }, "required": [ "id", "file_id", "object", "bytes", "purpose", "created_at" ] }, "GroupRequest": { "type": "object", "properties": { "model": { "type": "string" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string" } }, "required": [ "model", "name" ], "additionalProperties": false }, "AssetRequest": { "type": "object", "properties": { "group_id": { "type": "string" }, "asset_type": { "enum": [ "image", "video", "audio" ] }, "source_url": { "type": "string" }, "name": { "type": "string" } }, "required": [ "group_id", "asset_type", "source_url" ], "additionalProperties": false }, "Asset": { "type": "object", "description": "平台登记素材 ID 与状态；asset_uri 可用于视频参考", "properties": { "asset_id": { "type": "string" }, "group_id": { "type": "string" }, "asset_type": { "type": "string" }, "status": { "type": "string" }, "asset_uri": { "type": "string" } }, "required": [ "asset_id", "status" ] }, "Group": { "type": "object", "properties": { "group_id": { "type": "string" } }, "required": [ "group_id" ] } } } }