[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-reference-data-callArkCompatibleAction":3,"api-reference-contract-\u002Fopenapi\u002Fsilvamux.json":313},{"tree":4,"groups":142,"operation":305},[5,14,38,67,97,119,134],{"title":6,"path":7,"order":8,"description":9,"requiredFlags":10,"navigationHidden":11,"content":12,"children":13},"快速开始","getting-started",1,"创建 API Key，并使用 curl、Python 或 Node.js 完成第一次模型调用。",[],false,"# 快速开始\n\n本指南从当前工作区和项目开始，帮助你创建 API Key、确认模型调用名，并发出第一个 OpenAI Chat Completions 兼容请求。\n\n## 1. 获取 API Key\n\n1. 注册并登录控制台，进入当前工作区。\n2. 在“项目”页面确认至少有一个项目；没有项目时先创建。\n3. 进入“密钥”页面，点击“生成 API Key”。\n4. 填写名称，选择绑定项目和 API 版本，然后创建。\n5. 立即保存以 `sk_live_` 开头的完整 Key。完整值**仅在创建时显示一次**。\n\n![创建 API Key](https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fdeveloper-docs\u002Fapi-key-create.png)\n\n![API Key 创建成功](https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fdeveloper-docs\u002Fapi-key-created.png)\n\n建议将 Key 存为环境变量：\n\n```bash\nexport SILVAMUX_API_KEY=\"sk_live_YOUR_API_KEY\"\n```\n\n## 2. 发送第一个请求\n\nSilvaMux 支持 OpenAI Chat Completions 兼容格式。如果你已有 OpenAI SDK 代码，只需修改 Base URL 和 API Key。\n\n> **关于 `model` 字段**：填写[模型广场](\u002Fmodels)详情页展示的调用名，优先使用稳定的 alias。不要根据展示名称自行拼接。\n\n### curl\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"messages\": [\n      {\"role\": \"user\", \"content\": \"用一句话介绍你自己\"}\n    ]\n  }'\n```\n\n### Python (OpenAI SDK)\n\n安装依赖：`pip install openai`\n\n```python\nimport os\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=os.environ[\"SILVAMUX_API_KEY\"],\n    base_url=\"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\",\n)\n\nresponse = client.chat.completions.create(\n    model=\"minimax-m2.5\",\n    messages=[{\"role\": \"user\", \"content\": \"用一句话介绍你自己\"}],\n)\n\nprint(response.choices[0].message.content)\n```\n\n### Node.js (OpenAI SDK)\n\n安装依赖：`npm install openai`\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n  apiKey: process.env.SILVAMUX_API_KEY,\n  baseURL: \"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\",\n});\n\nconst response = await client.chat.completions.create({\n  model: \"minimax-m2.5\",\n  messages: [{ role: \"user\", content: \"用一句话介绍你自己\" }],\n});\n\nconsole.log(response.choices[0].message.content);\n```\n\n## 3. 流式输出\n\n设置 `stream: true` 即可获得流式响应（SSE）：\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"写一首五言绝句\"}],\n    \"stream\": true\n  }'\n```\n\n流式响应格式为 Server-Sent Events，每个事件的 `data` 字段包含一个 JSON chunk。最终可能收到 `choices` 为空、带有 `usage` 的用量 chunk，随后服务器关闭连接。客户端应以流结束为准，不要仅依赖 `data: [DONE]` 判断完成。\n\n## 4. 使用 Anthropic 格式\n\n如果你更熟悉 Anthropic 的 Messages API，SilvaMux 同样支持：\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fmessages \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"max_tokens\": 1024,\n    \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}]\n  }'\n```",[],{"title":15,"path":16,"order":17,"description":18,"requiredFlags":19,"navigationHidden":11,"content":20,"children":21},"通用信息","common",10,"查看计费等跨功能的通用信息。",[],"# 通用信息\n\n跨功能的通用信息。\n\n- 计费说明",[22,30],{"title":23,"path":24,"order":25,"description":26,"requiredFlags":27,"navigationHidden":11,"content":28,"children":29},"计费说明","common\u002Fbilling",3,"了解模型计费、账户充值、折扣和账单导出。",[],"# 计费说明\n\nSilvaMux 按实际用量计费，支持充值、折扣与账单导出。\n\n## 余额与充值\n\n- 余额不足时模型请求返回 `INSUFFICIENT_BALANCE`（HTTP 402），需充值后重试。\n- 充值：在控制台「充值」页操作。控制台内部使用 `POST \u002Fbilling\u002Forders` 创建充值订单。\n- 充值记录：在控制台查看；`GET \u002Fbilling\u002Ftopups` 为控制台登录态接口。\n\n## 折扣\n\n平台支持按组织、按模型分组配置折扣，由管理员设置。未配置折扣时按原价计费。\n\n## 账单与导出\n\n- 实时账单与账单导出请在控制台「账单」页操作。`\u002Fbilling\u002Fledger`、`\u002Fbilling\u002Fusage-summaries` 和 `\u002Fbilling\u002Fexports` 为控制台登录态接口，不是本次对外发布的 API Key 接入契约。\n- 需要用 API Key 程序化查询余额与用量时，请使用[客户查询 API](\u002Fdocs\u002Fcommon\u002Fcustomer-api)。\n\n## 模型价目\n\n完整模型价目请在[模型广场](\u002Fmodels)打开对应模型详情查看。各能力的计费方式：\n\n- 对话：按 token 用量（输入 + 输出）计费。\n- 图片生成：按生成张数计费。\n- 视频生成：按模型与视频参数（分辨率、时长、是否配音）计费。",[],{"title":31,"path":32,"order":33,"description":34,"requiredFlags":35,"navigationHidden":11,"content":36,"children":37},"通用错误处理","common\u002Ferrors",5,"查看通用错误格式、状态码和重试建议。",[],"# 通用错误处理\n\nSilvaMux 的错误格式取决于接口类型。本页介绍通用错误格式与重试建议，各模块的具体错误码见：\n\n- 对话错误码\n- 图片生成错误码\n- 视频生成错误码\n\n## Gateway API 错误（模型调用）\n\n对话、图片、视频等模型调用接口的错误格式由模型协议决定，分 OpenAI \u002F Anthropic \u002F Gemini \u002F Volcengine 四种渲染形状，`code` 字符串统一。\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误信息\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n```\n\n模型侧返回 4xx\u002F5xx 时，SilvaMux 会脱敏后透传错误响应，HTTP 状态码保持一致，此时不会产生扣费。\n\n## Billing \u002F Business API 错误（管理接口）\n\n账户、计费、自有素材等管理接口使用 RFC 7807 风格：\n\n```json\n{\n  \"status\": 400,\n  \"detail\": \"具体错误信息\",\n  \"type\": \"tag:hub,2026-03:ERROR_CODE\"\n}\n```\n\n验证错误包含 `errors` 数组：\n\n```json\n{\n  \"status\": 422,\n  \"detail\": \"validation failed\",\n  \"type\": \"tag:hub,2026-03:VALIDATION_FAILED\",\n  \"errors\": [{\"location\": \"body.email\", \"message\": \"required\"}]\n}\n```\n\n## 重试建议\n\n| HTTP 状态码 | 建议 |\n| --- | --- |\n| 400 | 不要重试，修正请求参数 |\n| 401 | 不要重试，检查认证信息 |\n| 402 | 不要重试，充值后再试 |\n| 403 | 不要重试，联系管理员 |\n| 429 | 等待后重试，建议指数退避 |\n| 500 | 可以重试，建议间隔 1-5 秒 |\n| 502 | 可以重试，模型侧暂时不可用 |\n\n## 请求 ID\n\n每个请求返回 `X-Request-Id` header（格式 `REQ-xxxx`）。排查问题时提供此 ID。你也可以在请求中自行设置 `X-Request-Id`，系统会沿用。",[],{"title":39,"path":40,"order":41,"description":42,"requiredFlags":43,"navigationHidden":11,"content":44,"children":45},"对话","chat",20,"对话接口的使用说明已统一收录到接口文档。",[],"# 对话\n\n对话接口概览、多模态输入和错误码已统一收录到接口文档。",[46,53,60],{"title":47,"path":48,"order":8,"description":49,"requiredFlags":50,"navigationHidden":11,"content":51,"children":52},"对话补全 API","chat\u002Foverview","查看统一入口和 OpenAI、Anthropic、Volcengine、Responses、智谱等兼容入口。",[],"# 对话补全 API\n\nSilvaMux 支持多种**厂商协议兼容入口**，也提供一个可选的**统一入口**。新项目建议按照目标模型支持的厂商协议接入；使用 OpenAI SDK 的项目默认选择 OpenAI Chat Completions 兼容入口。\n\n\n## 厂商协议兼容入口（推荐）\n\n下列端点接收对应厂商的请求格式，并保持相应的响应和错误结构，适合官方 SDK、已有代码迁移或需要字段级透传的场景。\n\n| 兼容格式 | 端点 | 适用 |\n| --- | --- | --- |\n| OpenAI Chat Completions | `POST \u002Fapi\u002Fv1\u002Fchat\u002Fcompletions` | 推荐给 OpenAI SDK 和大多数新项目 |\n| Anthropic | `POST \u002Fapi\u002Fv1\u002Fmessages` | 兼容 Anthropic SDK |\n| Volcengine v3 | `POST \u002Fapi\u002Fv3\u002Fchat\u002Fcompletions` | 兼容火山方舟 SDK |\n| Responses | `POST \u002Fapi\u002Fv1\u002Fresponses` | 兼容 OpenAI Responses API |\n| 智谱 | `POST \u002Fapi\u002Fpaas\u002Fv4\u002Fchat\u002Fcompletions` | 兼容智谱官方 SDK，配 `base_url=\"\u003C接入域名>\u002Fapi\u002Fpaas\u002Fv4\"` 不改代码迁入，`model` 用智谱官方名（如 `glm-5`） |\n| Gemini | `POST \u002Fapi\u002Fv1beta\u002Fmodels\u002F{model}:generateContent` | 兼容 Gemini `generateContent` 格式；当前无公开可发现模型，不作为可执行示例 |\n\n这些路径属于 SilvaMux 的兼容入口，并非模型厂商的官方服务地址。调用时使用 SilvaMux 提供的 API Key。公开 OpenAPI 仅以上表中的标准路径作为新接入契约；历史地址 `\u002Fapi\u002Fanthropic\u002Fv1\u002Fmessages` 和 `\u002Fapi\u002Fv1\u002Fgemini\u002Fv1beta\u002Fmodels\u002F{model}:generateContent` 仅供已接入项目兼容，新项目不应使用。\n\n## SilvaMux 统一入口（可选）\n\n`POST \u002Fapi\u002Fv0\u002Fchat\u002Fcompletions` 接收 OpenAI Chat 格式，根据 `model` 自动选择上游，并将响应、SSE 和错误统一转换为 OpenAI Chat 格式。适合希望通过一个入口跨协议调用不同模型的场景。\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}]\n  }'\n```\n\n> 统一入口会规范化请求和响应结构。需要厂商特有字段、事件或响应形状时，优先使用对应的厂商协议兼容入口。\n\n**认证：** `Authorization: Bearer \u003CAPI_KEY>` 或 `x-api-key: \u003CAPI_KEY>`。\n\n## OpenAI Chat 与统一入口的常用参数\n\n| 参数 | 类型 | 说明 |\n| --- | --- | --- |\n| `model` | string | 必填。模型调用名（`id` 或 `alias`），如 `minimax-m2.5`、`doubao-seed-2.0-pro` |\n| `messages` | array | 必填。对话消息列表，格式同 OpenAI（`role` + `content`） |\n| `stream` | boolean | 是否流式返回，默认 `false` |\n| `temperature` | number | 采样温度，默认 1.0 |\n| `max_tokens` | integer | 最大生成 token 数 |\n\n> 不同厂商协议的字段结构不同。请先在[模型广场](\u002Fmodels)筛选支持目标接口格式的模型，再复制详情页中的调用名填入 `model`。\n\n## OpenAI 格式示例\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"messages\": [\n      {\"role\": \"system\", \"content\": \"你是一个有帮助的助手\"},\n      {\"role\": \"user\", \"content\": \"你好\"}\n    ],\n    \"stream\": false\n  }'\n```\n\n响应（OpenAI 格式）：\n\n```json\n{\n  \"id\": \"chatcmpl-xxxx\",\n  \"choices\": [\n    {\n      \"message\": {\"role\": \"assistant\", \"content\": \"你好！有什么可以帮你的吗？\"},\n      \"finish_reason\": \"stop\"\n    }\n  ],\n  \"usage\": {\"prompt_tokens\": 20, \"completion_tokens\": 15, \"total_tokens\": 35}\n}\n```\n\n## Anthropic 格式示例\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fmessages \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"max_tokens\": 1024,\n    \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}]\n  }'\n```\n\n响应（Anthropic 格式）：\n\n```json\n{\n  \"id\": \"msg_xxxx\",\n  \"type\": \"message\",\n  \"role\": \"assistant\",\n  \"content\": [{\"type\": \"text\", \"text\": \"你好！有什么可以帮你的吗？\"}],\n  \"usage\": {\"input_tokens\": 10, \"output_tokens\": 15}\n}\n```\n\n## Volcengine v3 格式示例\n\n兼容火山方舟 OpenAI 兼容接口，可用于豆包 Seed 系列等走火山 v3 协议的模型。\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"doubao-seed-2.0-pro\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}]\n  }'\n```\n\n> `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3` 即接入域名下的 `\u002Fapi\u002Fv3`，对应路由 `\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions`。\n\n## Responses 格式示例\n\n兼容 OpenAI Responses API，适用于支持的模型（如 codex 系列）。\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fresponses \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"input\": \"用一句话介绍你自己\"\n  }'\n```\n\n## 流式输出\n\n设置 `stream: true` 即可获得流式响应（SSE）：\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m2.5\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"写一首五言绝句\"}],\n    \"stream\": true\n  }'\n```\n\n响应为 `text\u002Fevent-stream`，每个事件以 `data: ` 开头。最终可能收到 `choices` 为空、带有 `usage` 的用量 chunk，随后服务器关闭连接；客户端不应仅依赖 `data: [DONE]` 判断完成。Anthropic 格式流式遵循 Anthropic SSE 规范。\n\nPython SDK 流式：\n\n```python\nstream = client.chat.completions.create(\n    model=\"minimax-m2.5\",\n    messages=[{\"role\": \"user\", \"content\": \"写一首五言绝句\"}],\n    stream=True,\n)\nfor chunk in stream:\n    if chunk.choices:\n        delta = chunk.choices[0].delta.content\n        if delta:\n            print(delta, end=\"\", flush=True)\n    if chunk.usage:\n        print(f\"\\n用量：{chunk.usage}\")\n```",[],{"title":54,"path":55,"order":25,"description":56,"requiredFlags":57,"navigationHidden":11,"content":58,"children":59},"多模态输入","chat\u002Fmultimodal","查看图片和音频等多模态内容的输入格式与模型能力限制。",[],"# 多模态输入\n\n本页说明对话接口的多模态输入能力。SilvaMux 对多模态内容**透传**给模型侧，能否处理取决于模型本身。\n\n## 图片输入（vision）\n\n支持 OpenAI vision 格式，在 `messages` 的 `content` 中传入 `image_url`：\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"minimax-m3\",\n    \"messages\": [\n      {\n        \"role\": \"user\",\n        \"content\": [\n          {\"type\": \"text\", \"text\": \"这张图里有什么？\"},\n          {\"type\": \"image_url\", \"image_url\": {\"url\": \"https:\u002F\u002Fexample.com\u002Fcat.jpg\"}}\n        ]\n      }\n    ]\n  }'\n```\n\n- `image_url.url` 可以是公网 URL，或 base64 编码（`data:image\u002Fjpeg;base64,...`）。\n- 平台不解析也不剥离图片内容，原样转发给模型侧。\n- 是否支持图片输入由模型决定（如部分多模态模型支持，纯文本模型会报错）。\n\n## 音频输入\n\n支持 OpenAI audio 格式，在 `content` 中传入 `input_audio`：\n\n```json\n{\n  \"type\": \"input_audio\",\n  \"input_audio\": {\"data\": \"\u003Cbase64>\", \"format\": \"wav\"}\n}\n```\n\n- 平台透传，能否处理由模型决定。\n- 音频 token 按普通输入 token 计价（无独立多模态单价）。",[],{"title":61,"path":62,"order":33,"description":63,"requiredFlags":64,"navigationHidden":11,"content":65,"children":66},"对话错误码","chat\u002Ferrors","查看对话接口的错误格式、错误码和处理建议。",[],"# 对话错误码\n\n对话接口（Gateway API）使用 OpenAI 兼容错误格式：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误信息\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n```\n\nAnthropic \u002F Volcengine 格式的错误形状各有差异，但 `code` 字段一致。\n\n## 常见错误码\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `MODEL_REQUIRED` | 400 | 请求体缺少 `model` 字段 |\n| `MODEL_NOT_FOUND` | 400 | 模型不存在或不可用 |\n| `INVALID_REQUEST` | 400 | 请求参数无效 |\n| `INVALID_REQUEST_BODY` | 400 | 请求体解析失败 |\n| `UNAUTHORIZED` | 401 | 认证失败（API Key\u002FJWT 无效） |\n| `MODEL_ACCESS_DENIED` | 403 | 组织缺少该模型所需权限标志 |\n| `INSUFFICIENT_BALANCE` | 402 | 余额不足 |\n| `PRE_DEDUCT_FAILED` | 400\u002F402 | 预扣费失败（参数错误=400，落库失败=402） |\n| `RATE_LIMITED` | 429 | 触发限流 |\n| `UPSTREAM_UNAVAILABLE` | 502 | 模型侧请求发送失败 |\n| `UPSTREAM_HTTP_ERROR` | 502 | 模型侧返回 4xx\u002F5xx |\n| `UPSTREAM_PROVIDER_ERROR` | 502 | 模型侧业务错误 |\n| `UPSTREAM_INVALID_RESPONSE` | 502 | 模型侧响应无法解析 |\n| `INTERNAL` | 500 | 内部错误 |\n\n## 模型侧错误透传\n\n模型侧返回 4xx\u002F5xx 时，SilvaMux 会脱敏后透传错误响应，HTTP 状态码保持一致，此时不会产生扣费。\n\n## 重试建议\n\n| HTTP 状态码 | 建议 |\n| --- | --- |\n| 400 | 不要重试，修正请求参数 |\n| 401 | 不要重试，检查认证信息 |\n| 402 | 不要重试，充值后再试 |\n| 403 | 不要重试，联系管理员 |\n| 429 | 等待后重试，建议指数退避 |\n| 500 | 可以重试，建议间隔 1-5 秒 |\n| 502 | 可以重试，模型侧暂时不可用 |\n\n每个请求返回 `X-Request-Id` header（格式 `REQ-xxxx`），排查问题时提供此 ID。",[],{"title":68,"path":69,"order":70,"description":71,"requiredFlags":72,"navigationHidden":11,"content":73,"children":74},"图片生成","images",30,"了解文生图和图片编辑两类图片生成能力。",[],"# 图片生成\n\n图片生成支持文生图与图生图（图片编辑）。\n\n- 图片生成\n- 图片编辑",[75,81,89],{"title":68,"path":76,"order":8,"description":77,"requiredFlags":78,"navigationHidden":11,"content":79,"children":80},"images\u002Ftext-to-image","使用 OpenAI Images 或 Gemini 兼容格式根据提示词生成图片。",[],"# 图片生成\n\n文生图接口根据模型分为两种风格：OpenAI Images API 风格（豆包 Seedream）和 Gemini `generateContent` 风格。\n\n\n## OpenAI 风格（Seedream）\n\n```\nPOST \u002Fapi\u002Fv3\u002Fimages\u002Fgenerations\n```\n\n**认证：** `Authorization: Bearer \u003CAPI_KEY>` 或 `x-api-key: \u003CAPI_KEY>`\n\n### 关键参数\n\n| 参数 | 类型 | 必填 | 说明 |\n| --- | --- | --- | --- |\n| `model` | string | 是 | 模型调用名，如 `doubao-seedream-5-0-260128` |\n| `prompt` | string | 是 | 图片描述 |\n| `n` | integer | 否 | 图片数量，默认 1 |\n| `size` | string | 否 | 尺寸，具体支持尺寸因模型而异；Seedream 5.0 示例使用 `2048x2048` |\n| `stream` | boolean | 否 | 模型透传字段，当前不属于统一 OpenAPI 契约；是否支持以模型详情为准 |\n\n> `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3` 即接入域名下的 `\u002Fapi\u002Fv3`，对应路由 `\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations`。\n\n### 示例\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"doubao-seedream-5-0-260128\",\n    \"prompt\": \"一只戴墨镜的柴犬坐在咖啡馆里\",\n    \"size\": \"2048x2048\",\n    \"n\": 1\n  }'\n```\n\n响应：\n\n```json\n{\n  \"created\": 1234567890,\n  \"data\": [{\"url\": \"https:\u002F\u002F...\"}],\n  \"usage\": {\"output_images\": 1}\n}\n```\n\n## Gemini 风格（契约示例）\n\nGemini `generateContent` 风格，适合 Gemini 图像模型。\n\n> 当前模型列表和模型广场暂无公开可发现的 Gemini 图像模型。以下内容仅用于展示请求结构，不能直接执行；`\u003CMODEL_CALL_NAME>` 必须替换为模型广场后续发布的真实调用名，请勿猜测模型名称。\n\n```\nPOST \u002Fapi\u002Fv1beta\u002Fmodels\u002F{model}:generateContent\n```\n\n**认证：** `Authorization: Bearer \u003CAPI_KEY>` 或 `x-api-key: \u003CAPI_KEY>`\n\n### 示例\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1beta\u002Fmodels\u002F\u003CMODEL_CALL_NAME>:generateContent \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"contents\": [\n      {\"role\": \"user\", \"parts\": [{\"text\": \"画一只坐在窗台上的猫\"}]}\n    ],\n    \"generationConfig\": {\n      \"responseModalities\": [\"TEXT\", \"IMAGE\"],\n      \"imageConfig\": {\"aspectRatio\": \"1:1\", \"imageSize\": \"1K\"}\n    }\n  }'\n```\n\n响应保持 Gemini 格式，计费字段在 `usageMetadata` 中。\n\n## 上传限制\n\n请求体大小不超过 64 MB。超出返回 `413`（`REQUEST_TOO_LARGE`）。\n\n## 可用模型\n\n当前可直接使用的样例模型：`doubao-seedream-5-0-260128`（Seedream）。Gemini 图像模型暂无公开可发现的调用名。\n\n> 完整模型清单见[模型广场](\u002Fmodels)。\n\n## 计费\n\n文生图按生成张数计费，当前单价请在[模型广场](\u002Fmodels)打开对应模型详情查看。",[],{"title":82,"path":83,"order":84,"description":85,"requiredFlags":86,"navigationHidden":11,"content":87,"children":88},"图片编辑","images\u002Fimage-edit",2,"使用 multipart\u002Fform-data 上传图片并根据提示词进行编辑。",[],"# 图片编辑\n\n图生图（图片编辑）接口兼容 OpenAI Images Edits 风格，使用 `multipart\u002Fform-data` 上传图片并按提示词编辑。\n\n\n```\nPOST \u002Fapi\u002Fv3\u002Fimages\u002Fedits\n```\n\n**认证：** `Authorization: Bearer \u003CAPI_KEY>` 或 `x-api-key: \u003CAPI_KEY>`\n\n## 关键参数\n\n| 参数 | 类型 | 必填 | 说明 |\n| --- | --- | --- | --- |\n| `model` | string | 是 | 模型调用名；必须从模型广场或模型列表获取 |\n| `image` | file | 是 | 输入图片，最多 16 张（重复传入 `image=@...`） |\n| `prompt` | string | 是 | 编辑指令 |\n| `size` | string | 否 | 尺寸，如 `1024x1024` |\n| `mask` | file | 否 | 蒙版图 |\n| `n` | integer | 否 | 输出图片数量 |\n| `stream` | boolean | 否 | 模型透传字段，当前不属于统一 OpenAPI 契约；是否支持以后续公开模型为准 |\n\n> `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3` 即接入域名下的 `\u002Fapi\u002Fv3`，对应路由 `\u002Fapi\u002Fv3\u002Fimages\u002Fedits`。\n\n## OpenAPI 契约说明\n\n图片编辑 v1 和 v3 在 OpenAPI 中共用 `#\u002Fcomponents\u002FrequestBodies\u002FImageEdit` 请求体，并继续引用 `#\u002Fcomponents\u002Fschemas\u002FImageEditRequest` 定义字段。读取或生成 SDK 时需要递归解析本地 `$ref`；字段没有直接内联在接口节点下，不代表请求体缺失。\n\n解析后的请求体为必填的 `multipart\u002Fform-data`，其中 `model`、`prompt` 和 `image` 必填，`image` 为单个或多个二进制文件。\n\n## 示例\n\n> 当前模型列表和模型广场暂未公开可发现的图片编辑模型。以下内容是请求结构示例，不能直接执行；`\u003CMODEL_CALL_NAME>` 必须替换为模型广场后续发布的真实调用名，请勿猜测模型名称。\n\n```bash\ncurl https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3\u002Fimages\u002Fedits \\\n  -H \"Authorization: Bearer $SILVAMUX_API_KEY\" \\\n  -F \"model=\u003CMODEL_CALL_NAME>\" \\\n  -F \"image=@photo.png\" \\\n  -F \"prompt=给图片加上一些装饰文字\" \\\n  -F \"size=1024x1024\"\n```\n\n`background`、`partial_images` 等字段属于模型透传字段，当前不属于统一 OpenAPI 契约。是否支持以后续公开模型的详情为准。\n\n## 上传限制\n\n请求体大小不超过 64 MB。超出返回 `413`（`REQUEST_TOO_LARGE`）。\n\n## 可用模型\n\n当前暂未公开可发现的图片编辑模型。可用调用名必须以[模型广场](\u002Fmodels)或模型列表接口为准。\n\n## 计费\n\n图生图按生成张数计费，当前单价请在[模型广场](\u002Fmodels)打开对应模型详情查看。",[],{"title":90,"path":91,"order":92,"description":93,"requiredFlags":94,"navigationHidden":11,"content":95,"children":96},"图片错误码","images\u002Ferrors",4,"查看图片接口的错误格式、错误码和处理建议。",[],"# 图片错误码\n\n图片生成接口的错误格式与对话接口一致（OpenAI 兼容）。常见错误码：\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `MODEL_NOT_FOUND` | 400 | 模型不存在或不可用 |\n| `INVALID_REQUEST` | 400 | 请求参数无效 |\n| `UNAUTHORIZED` | 401 | 认证失败 |\n| `INSUFFICIENT_BALANCE` | 402 | 余额不足 |\n| `PRE_DEDUCT_FAILED` | 400\u002F402 | 预扣费失败 |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | 图片生成并发上限 |\n| `RATE_LIMITED` | 429 | 触发限流 |\n| `REQUEST_TOO_LARGE` | 413 | 请求体超过 64MB |\n| `UPSTREAM_HTTP_ERROR` | 502 | 模型侧返回 4xx\u002F5xx |\n| `UPSTREAM_PROVIDER_ERROR` | 502 | 模型侧业务错误 |\n| `INTERNAL` | 500 | 内部错误 |",[],{"title":98,"path":99,"order":100,"description":101,"requiredFlags":102,"navigationHidden":11,"content":103,"children":104},"视频生成","video",40,"了解视频与 3D 的素材选用。",[],"# 视频生成\n\n视频与 3D 生成相关的素材选用说明。\n\n- 素材选用指南",[105,112],{"title":106,"path":107,"order":84,"description":108,"requiredFlags":109,"navigationHidden":11,"content":110,"children":111},"素材选用指南","video\u002Fmaterial-guide","根据视频生成场景准备和选择图片、视频及音频素材。",[],"# 素材选用指南\n\n视频生成支持参考图片、视频、音频等多种素材。本页通过对比案例说明如何准备和上传素材，以获得更理想的生成效果。\n\n> ⚠️ 上传素材时，**若将目标人脸图、全身参考图及细节参考图合并为同一张图片**，可能导致各参考元素在画面中占比较小，增加模型识别难度，造成生成视频中的人物形象与所上传素材出现偏差，或触发风控拦截。\n\n建议将人物面部特写、服装细节等关键内容**独立分割为单独的图片**上传。\n\n## 案例对比：3D 动画亲子\n\n### 案例 A（推荐）\n\n输入：背景参考图 + 人物妆造三视图 + **人物面部无表情特写图** + 提示词\n\n![](https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2a.webp)\n\n提示词：\n\n> 3d 动画风格，背景参考图片 1。人物 A（妆造参考图片 2；面部特征严格参考图片 3）和人物 B（妆造参考图片 4；面部特征严格参考图片 5）手牵手走在花园的小径上，镜头处于人物背后。镜头切到前面，人物 A 拿起一朵鲜花，轻轻递给人物 B。背景音效：轻柔的风吹动树叶和花朵，鸟鸣声。人物 B 微笑接过花，轻轻闻了闻花香，然后蹲下低头与人物 A 微笑对视，轻轻拍拍人物 A 的头，说：\"thank you\"。背景音效：风铃轻响。\n\n\u003Cvideo style=\"max-width: 480px; margin: 0 auto;\" src=\"https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2a-h265.mp4\" controls>\u003C\u002Fvideo>\n\n### 案例 B\n\n输入：背景参考图 + 人物妆造三视图 + 提示词（**缺少人物面部特写图**）\n\n![](https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2b.webp)\n\n\u003Cvideo style=\"max-width: 480px; margin: 0 auto;\" src=\"https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2b-h265.mp4\" controls>\u003C\u002Fvideo>\n\n### 案例 C\n\n输入：背景参考图 + **人物妆造正视图**（非三视图）+ 提示词\n\n![](https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2c.webp)\n\n\u003Cvideo style=\"max-width: 480px; margin: 0 auto;\" src=\"https:\u002F\u002Fsilvamux-docs.tingyutech.com\u002Fcases\u002F2c-h265.mp4\" controls>\u003C\u002Fvideo>\n\n### 对比\n\n- 案例 A（三视图 + 面部特写图）：人物面部特征还原最佳。\n- 案例 B（三视图，无面部特写图）：面部特征一致性较差。\n- 案例 C（正视图，非三视图）：妆造与面部特征一致性均较差。\n\n## 小结\n\n| 素材组合 | 效果 |\n| --- | --- |\n| 背景图 + 妆造三视图 + 面部特写图 | 最佳 |\n| 背景图 + 妆造三视图（无面部特写） | 面部一致性差 |\n| 背景图 + 妆造正视图 | 妆造与面部都差 |\n\n需要使用平台素材库时，请联系 SilvaMux 团队获取接入说明。",[],{"title":113,"path":114,"order":33,"description":115,"requiredFlags":116,"navigationHidden":11,"content":117,"children":118},"视频与任务错误码","video\u002Ferrors","查看视频与 3D 任务接口的错误码和处理建议。",[],"# 视频与任务错误码\n\n视频生成接口的错误格式与对话接口一致（OpenAI 兼容）。常见错误码：\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `MODEL_NOT_FOUND` | 400 | 模型不存在或不可用 |\n| `INVALID_REQUEST` | 400 | 请求参数无效 |\n| `INVALID_CALLBACK_URL` | 400 | 回调 URL 无效 |\n| `UNAUTHORIZED` | 401 | 认证失败 |\n| `MODEL_ACCESS_DENIED` | 403 | 组织缺少模型权限标志 |\n| `INSUFFICIENT_BALANCE` | 402 | 余额不足 |\n| `PRE_DEDUCT_FAILED` | 400\u002F402 | 预扣费失败 |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | 视频生成并发上限 |\n| `RATE_LIMITED` | 429 | 触发限流 |\n| `UPSTREAM_HTTP_ERROR` | 502 | 模型侧返回 4xx\u002F5xx |\n| `UPSTREAM_PROVIDER_ERROR` | 502 | 模型侧业务错误 |\n| `UPSTREAM_INVALID_RESPONSE` | 502 | 模型侧响应无法解析 |\n| `INTERNAL` | 500 | 内部错误 |\n\n取消任务的错误：\n\n| HTTP | 错误码 | 说明 |\n| --- | --- | --- |\n| 404 | `NOT_FOUND` | 任务不存在 |\n| 409 | `INVALID_STATE` | 任务不在 queued 状态 |\n| 502 | `UPSTREAM_CANCEL_FAILED` | 模型侧取消失败 |",[],{"title":120,"path":121,"order":122,"description":123,"requiredFlags":124,"navigationHidden":11,"content":125,"children":126},"即梦AI","dreamina",50,"查看即梦 AI 能力和数字人文档入口。",[],"# 即梦AI\n\n- [OmniHuman 数字人](\u002Fdocs\u002Fdreamina\u002Fomni-human)",[127],{"title":128,"path":129,"order":17,"description":130,"requiredFlags":131,"navigationHidden":11,"content":132,"children":133},"OmniHuman 1.5","dreamina\u002Fomni-human","使用图片和音频生成 OmniHuman 数字人视频。",[],"# 即梦 OmniHuman 1.5\n\nOmniHuman1.5（即梦同源数字人模型），该模型可根据用户上传的单张图片+音频，生成与图片对应的视频效果。支持输入任意画幅包含人物或其他主体（宠物、动漫等）的图片，结合音频，生成高质量的视频。\n\n人物的情绪、动作与音频具有强关联性，支持通过提示词（prompt）对画面、动作、运镜进行调整。同时OmniHuman1.5对动漫、宠物等形象支持较好，允许指定讲话人\u002F主体，可广泛应用于内容表达、唱歌和表演等场景。\n\n相较于上一代模型，OmniHuman1.5 在运动自然度和结构稳定性提升明显，在人物\u002F主体的运动表现力和画面质量上更优。可以广泛应用于制作剧情对话、多人对话\u002F对唱、商品交互、漫剧等内容。对比其他视频通用模型，OmniHuman 数字人大模型在人物\u002F主体的剧情演绎效果上极具优势。\n\n具体模型介绍细节，可参考[火山文档](https:\u002F\u002Fdocs.volcengine.com\u002Fdocs\u002F85621\u002F1834143?lang=zh)。\n\n## 调用示例\n\n千木提供与火山相同的即梦 OmniHuman 1.5 API，您可以使用火山 SDK 或是通过自研 API 接入即梦 OmniHuman 1.5。\n\nSilvaMux 的请求入口、`Action`、`Version` 和 AK\u002FSK 鉴权方式见[火山兼容 API](\u002Fdocs\u002Fapi-reference\u002FcallArkCompatibleAction)。本页下方列出的火山官方链接用于查看 OmniHuman 模型的专项输入字段；接入地址和凭据仍使用 SilvaMux。\n\n\n以火山 Python SDK 为例，使用 `pip install volcengine` 安装示例所需 SDK 后，运行如下示例脚本：\n\n```python\n# coding:utf-8\nimport json\nimport threading\nfrom time import sleep\n\nfrom volcengine.ApiInfo import ApiInfo\nfrom volcengine.Credentials import Credentials\nfrom volcengine.base.Service import Service\nfrom volcengine.ServiceInfo import ServiceInfo\nfrom volcengine.visual.VisualService import VisualService\n\nclass SilvaMuxVisualService(VisualService):\n    def __new__(cls, *args, **kwargs):\n        return object.__new__(cls, *args, **kwargs)\n\n    def __init__(self):\n        self.service_info = SilvaMuxVisualService.get_service_info()\n        self.api_info = SilvaMuxVisualService.get_api_info()\n        super(VisualService, self).__init__(self.service_info, self.api_info)\n\n    def get_service_info():\n        service_info = ServiceInfo(\"www.silvamux.com\", # 如需使用海外版，请替换为 www.silvamux.io\n                                   {}, Credentials('', '', 'cv', 'cn-north-1'), 30, 30, 'https')\n        return service_info\n\n    def get_api_info():\n        api_info = {\n            \"CVGetResult\": ApiInfo(\"POST\", \"\u002Fapi\u002Fark\", {\"Action\": \"CVGetResult\", \"Version\": \"2022-08-31\"}, {}, {}),\n            \"CVSubmitTask\": ApiInfo(\"POST\", \"\u002Fapi\u002Fark\", {\"Action\": \"CVSubmitTask\", \"Version\": \"2022-08-31\"}, {}, {}),\n            \"CVProcess\": ApiInfo(\"POST\", \"\u002Fapi\u002Fark\", {\"Action\": \"CVProcess\", \"Version\": \"2022-08-31\"}, {}, {}),\n        }\n        return api_info\n\n\ndef get_result(req_key, task_id):\n    i = 0\n    while True:\n        i += 1\n        result_resp = visual_service.cv_get_result({\n            \"req_key\": req_key,\n            \"task_id\": task_id\n        })\n        result_status = result_resp['data']['status']\n        print(f\"  第 {i} 次查询结果，状态: {result_status}\")\n        if result_status == \"in_queue\" or result_status == \"generating\":\n            sleep(3)\n            continue\n        if result_status == \"done\":\n            if 'data' in result_resp and 'resp_data' in result_resp['data']:\n                return json.loads(result_resp['data']['resp_data'])\n            elif 'data' in result_resp and 'video_url' in result_resp['data']:\n                return result_resp['data']['video_url']\n            else:\n                print(f\"  解析失败：{result_resp}\")\n                raise Exception(\"result parse failed\")\n        raise Exception(f\"task {result_status}\")\n\nif __name__ == '__main__':\n    image_url = \"https:\u002F\u002Fportal.volccdn.com\u002Fobj\u002Fvolcfe\u002Fcloud-universal-doc\u002Fupload_7297f5f099cee6b48f5417e47ac8291b.png\"\n    audio_url = \"https:\u002F\u002Fp9-arcosite.byteimg.com\u002Fobj\u002Ftos-cn-i-goo7wpa0wc\u002F64c66c987973400491c0b487d832537c\"\n    mask_urls = []\n\n    visual_service = SilvaMuxVisualService()\n\n    # 请使用千木后台生成的兼容“凭据”以调用火山兼容 API\n    visual_service.set_ak('AKexampleReplaceWithRealAK')\n    visual_service.set_sk('SKexampleReplaceWithRealSK')\n\n    print(\"第一步：主体识别 如果确认图片中有人类主体，可以跳过该步骤\")\n    step1_resp = visual_service.cv_submit_task({\n        \"req_key\": \"jimeng_realman_avatar_picture_create_role_omni_v15\",\n        \"image_url\": image_url\n    })\n    step1_resp_task_id = step1_resp['data']['task_id']\n    print(f\"  任务ID: {step1_resp_task_id}\")\n\n    step1_result = get_result(\"jimeng_realman_avatar_picture_create_role_omni_v15\", step1_resp_task_id)\n    if step1_result['status'] != 1:\n        raise Exception(\"没有检测到主体，任务失败，请更换图片尝试\")\n\n    print(\"第二步：主体检测 如果在视频生成时不需要指定主体说话，可以跳过该步骤\")\n    step2_resp = visual_service.cv_process({\n        \"req_key\": \"jimeng_realman_avatar_object_detection\",\n        \"image_url\": image_url\n    })\n    step2_data = json.loads(step2_resp['data']['resp_data'])\n    mask_urls = step2_data['object_detection_result']['mask']['url']\n    print(f\"  遮罩列表: {mask_urls}\")\n\n    print(\"第三步：视频生成\")\n    step3_resp = visual_service.cv_submit_task({\n        \"req_key\": \"jimeng_realman_avatar_picture_omni_v15\",\n        \"image_url\": image_url,\n        \"mask_url\": mask_urls,\n        \"audio_url\": audio_url,\n    })\n    step3_resp_task_id = step3_resp['data']['task_id']\n    print(f\"  任务ID: {step3_resp_task_id}\")\n\n    step3_result = get_result(\"jimeng_realman_avatar_picture_omni_v15\", step3_resp_task_id)\n    print(f\"  结果： {step3_result}\")\n```\n\n具体 API 文档如下：\n\n- [调用步骤1：主体识别](https:\u002F\u002Fdocs.volcengine.com\u002Fdocs\u002F85621\u002F1828975?lang=zh)\n- [调用步骤2：主体检测](https:\u002F\u002Fdocs.volcengine.com\u002Fdocs\u002F85621\u002F1829011?lang=zh)\n- [调用步骤3：视频生成](https:\u002F\u002Fdocs.volcengine.com\u002Fdocs\u002F85621\u002F1829013?lang=zh)",[],{"title":135,"path":136,"order":137,"description":138,"requiredFlags":139,"navigationHidden":11,"content":140,"children":141},"常见问题","faq",60,"集中查看接入、对话、图片和视频任务中的常见问题。",[],"# 常见问题\n\n## 接入与账号\n\n### Base URL 是什么？\n\nBase URL 是 SilvaMux 的接入域名。文档示例中的 `https:\u002F\u002Fsilvamux.io` 会在网站构建时替换为当前站点配置的域名。\n\n### API Key 在哪创建？\n\n在控制台 **密钥** 页面创建。API Key 以 `sk_live_` 开头，仅在创建时完整显示一次，建议存入环境变量 `SILVAMUX_API_KEY`。\n\n### `model` 字段填什么？\n\n填写模型详情页展示的调用名，优先使用稳定的 alias。不要根据展示名称自行拼接。\n\n## 对话与模型\n\n### 应该选择统一入口还是兼容入口？\n\n已经使用 OpenAI、Anthropic、Gemini、Volcengine 或智谱 SDK 时，优先选择对应兼容入口；需要通过一个入口跨协议调用时，可使用 SilvaMux 统一入口。\n\n### 多模态内容为什么调用失败？\n\n模型必须支持对应输入类型。纯文本模型收到图片或音频内容时可能返回错误。\n\n## 图片生成\n\n### 文生图和图片编辑用同一个接口吗？\n\n不是。文生图和图片编辑使用不同接口，请按接口文档选择。\n\n### 413 REQUEST_TOO_LARGE\n\n请求体超过大小上限。压缩图片或减少输入图片数量后重试。\n\n## 视频与任务\n\n### 视频生成使用火山 AK\u002FSK 吗？\n\n视频生成使用 SilvaMux API Key；火山 V4 签名用于火山兼容的素材管理接口。\n\n### 视频任务怎么查询结果？\n\n创建任务后轮询任务查询接口，直到状态变为成功或失败。具体状态和结果字段以接口契约为准。\n\n### 429 CONCURRENCY_LIMIT_EXCEEDED\n\n达到并发上限，等待后重试。",[],[143,157,177,188,198,209,220,229,238,260,277],{"name":144,"description":144,"operations":145},"模型列表",[146],{"operationId":147,"kind":148,"tag":149,"summary":144,"description":150,"method":151,"path":152,"sourcePath":152,"contractUrl":153,"href":154,"currentPath":155,"publiclyDiscoverable":156},"listModels","operation","Models","返回可直接用于模型调用的聚合模型名。未鉴权时返回公开模型；鉴权后按组织模型权限过滤。","GET","\u002Fapi\u002Fv1\u002Fmodels","\u002Fopenapi\u002Fsilvamux.json","\u002Fdocs\u002Fapi-reference\u002FlistModels","api-reference\u002FlistModels",true,{"name":158,"description":159,"operations":160},"OpenAI 兼容","OpenAI 兼容接口",[161,170],{"operationId":162,"kind":148,"tag":163,"summary":164,"description":165,"method":166,"path":167,"sourcePath":167,"contractUrl":153,"href":168,"currentPath":169,"publiclyDiscoverable":156},"createOpenAIChatCompletion","OpenAI","OpenAI Chat Completions","OpenAI Chat Completions 兼容入口，额外字段按模型能力透传。","POST","\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions","\u002Fdocs\u002Fapi-reference\u002FcreateOpenAIChatCompletion","api-reference\u002FcreateOpenAIChatCompletion",{"operationId":171,"kind":148,"tag":163,"summary":172,"description":173,"method":166,"path":174,"sourcePath":174,"contractUrl":153,"href":175,"currentPath":176,"publiclyDiscoverable":156},"createOpenAIResponse","OpenAI Responses","","\u002Fapi\u002Fv1\u002Fresponses","\u002Fdocs\u002Fapi-reference\u002FcreateOpenAIResponse","api-reference\u002FcreateOpenAIResponse",{"name":178,"description":179,"operations":180},"Anthropic 兼容","Anthropic 兼容接口",[181],{"operationId":182,"kind":148,"tag":183,"summary":178,"description":184,"method":166,"path":185,"sourcePath":185,"contractUrl":153,"href":186,"currentPath":187,"publiclyDiscoverable":156},"createAnthropicMessage","Anthropic","标准 Anthropic Messages 兼容路径；历史路径 \u002Fapi\u002Fanthropic\u002Fv1\u002Fmessages 继续兼容。","\u002Fapi\u002Fv1\u002Fmessages","\u002Fdocs\u002Fapi-reference\u002FcreateAnthropicMessage","api-reference\u002FcreateAnthropicMessage",{"name":189,"description":190,"operations":191},"Volcengine 兼容","Volcengine 兼容接口",[192],{"operationId":193,"kind":148,"tag":194,"summary":189,"description":173,"method":166,"path":195,"sourcePath":195,"contractUrl":153,"href":196,"currentPath":197,"publiclyDiscoverable":156},"createVolcengineChatCompletion","Volcengine","\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions","\u002Fdocs\u002Fapi-reference\u002FcreateVolcengineChatCompletion","api-reference\u002FcreateVolcengineChatCompletion",{"name":199,"description":200,"operations":201},"智谱兼容","智谱兼容接口",[202],{"operationId":203,"kind":148,"tag":204,"summary":199,"description":205,"method":166,"path":206,"sourcePath":206,"contractUrl":153,"href":207,"currentPath":208,"publiclyDiscoverable":156},"createZhipuChatCompletion","Zhipu","复用统一入口按 model 选路。","\u002Fapi\u002Fpaas\u002Fv4\u002Fchat\u002Fcompletions","\u002Fdocs\u002Fapi-reference\u002FcreateZhipuChatCompletion","api-reference\u002FcreateZhipuChatCompletion",{"name":210,"description":211,"operations":212},"SilvaMux 统一入口","SilvaMux 跨协议统一入口",[213],{"operationId":214,"kind":148,"tag":215,"summary":210,"description":216,"method":166,"path":217,"sourcePath":217,"contractUrl":153,"href":218,"currentPath":219,"publiclyDiscoverable":156},"createUnifiedChatCompletion","Unified","可选的跨协议统一入口。按 model 选择上游，并将响应、SSE 和错误统一为 OpenAI Chat 格式。","\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions","\u002Fdocs\u002Fapi-reference\u002FcreateUnifiedChatCompletion","api-reference\u002FcreateUnifiedChatCompletion",{"name":68,"description":221,"operations":222},"图片生成和编辑",[223],{"operationId":224,"kind":148,"tag":225,"summary":68,"description":173,"method":166,"path":226,"sourcePath":226,"contractUrl":153,"href":227,"currentPath":228,"publiclyDiscoverable":156},"createImageV3","Images","\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations","\u002Fdocs\u002Fapi-reference\u002FcreateImageV3","api-reference\u002FcreateImageV3",{"name":54,"description":230,"operations":231},"多模态内容的输入方式与限制",[232],{"operationId":233,"kind":234,"tag":235,"summary":54,"description":236,"method":173,"path":173,"sourcePath":173,"contractUrl":173,"href":237,"currentPath":55,"publiclyDiscoverable":156},"multimodal-input","guide","ConversationGuides","图片和音频等多模态内容的输入格式与限制。","\u002Fdocs\u002Fchat\u002Fmultimodal",{"name":239,"description":240,"operations":241},"客户查询接口","客户余额与用量",[242,252],{"operationId":243,"kind":148,"tag":244,"summary":245,"description":246,"method":151,"path":247,"sourcePath":248,"contractUrl":249,"href":250,"currentPath":251,"publiclyDiscoverable":156},"customer-balance","Customer","查询余额","Return the current balance for the API key's organization. API key only.","\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fbalance","\u002Fcustomer\u002Fbalance","\u002Fopenapi\u002Fcustomer.json","\u002Fdocs\u002Fapi-reference\u002Fcustomer-balance","api-reference\u002Fcustomer-balance",{"operationId":253,"kind":148,"tag":244,"summary":254,"description":255,"method":151,"path":256,"sourcePath":257,"contractUrl":249,"href":258,"currentPath":259,"publiclyDiscoverable":156},"customer-usage","查询用量","Return aggregated usage (totals + per-model) for the API key's project over a time range. API key only.","\u002Fapi\u002Fbusiness\u002Fv1\u002Fcustomer\u002Fusage","\u002Fcustomer\u002Fusage","\u002Fdocs\u002Fapi-reference\u002Fcustomer-usage","api-reference\u002Fcustomer-usage",{"name":261,"description":262,"operations":263},"错误码","错误格式、错误码与处理建议",[264,268,271,274],{"operationId":265,"kind":234,"tag":266,"summary":31,"description":173,"method":173,"path":173,"sourcePath":173,"contractUrl":173,"href":267,"currentPath":32,"publiclyDiscoverable":156},"common-errors","ErrorGuides","\u002Fdocs\u002Fcommon\u002Ferrors",{"operationId":269,"kind":234,"tag":266,"summary":61,"description":173,"method":173,"path":173,"sourcePath":173,"contractUrl":173,"href":270,"currentPath":62,"publiclyDiscoverable":156},"chat-errors","\u002Fdocs\u002Fchat\u002Ferrors",{"operationId":272,"kind":234,"tag":266,"summary":90,"description":173,"method":173,"path":173,"sourcePath":173,"contractUrl":173,"href":273,"currentPath":91,"publiclyDiscoverable":156},"images-errors","\u002Fdocs\u002Fimages\u002Ferrors",{"operationId":275,"kind":234,"tag":266,"summary":113,"description":173,"method":173,"path":173,"sourcePath":173,"contractUrl":173,"href":276,"currentPath":114,"publiclyDiscoverable":156},"video-errors","\u002Fdocs\u002Fvideo\u002Ferrors",{"name":278,"description":279,"operations":280},"视频与 3D","视频与 3D 异步任务",[281,288,293,300],{"operationId":282,"kind":148,"tag":283,"summary":284,"description":173,"method":151,"path":285,"sourcePath":285,"contractUrl":153,"href":286,"currentPath":287,"publiclyDiscoverable":156},"listContentGenerationTasks","VideoAnd3D","任务列表","\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks","\u002Fdocs\u002Fapi-reference\u002FlistContentGenerationTasks","api-reference\u002FlistContentGenerationTasks",{"operationId":289,"kind":148,"tag":283,"summary":290,"description":173,"method":166,"path":285,"sourcePath":285,"contractUrl":153,"href":291,"currentPath":292,"publiclyDiscoverable":156},"createContentGenerationTask","创建任务","\u002Fdocs\u002Fapi-reference\u002FcreateContentGenerationTask","api-reference\u002FcreateContentGenerationTask",{"operationId":294,"kind":148,"tag":283,"summary":295,"description":173,"method":296,"path":297,"sourcePath":297,"contractUrl":153,"href":298,"currentPath":299,"publiclyDiscoverable":156},"cancelContentGenerationTask","取消任务","DELETE","\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F{id}","\u002Fdocs\u002Fapi-reference\u002FcancelContentGenerationTask","api-reference\u002FcancelContentGenerationTask",{"operationId":301,"kind":148,"tag":283,"summary":302,"description":173,"method":151,"path":297,"sourcePath":297,"contractUrl":153,"href":303,"currentPath":304,"publiclyDiscoverable":156},"getContentGenerationTask","查询任务","\u002Fdocs\u002Fapi-reference\u002FgetContentGenerationTask","api-reference\u002FgetContentGenerationTask",{"operationId":306,"kind":148,"tag":307,"summary":308,"description":309,"method":166,"path":310,"sourcePath":310,"contractUrl":153,"href":311,"currentPath":312,"publiclyDiscoverable":11},"callArkCompatibleAction","Ark","火山兼容 API","多个素材和 CV Action 共用该路径，请求体结构由 Action 和 Version 决定。","\u002Fapi\u002Fark","\u002Fdocs\u002Fapi-reference\u002FcallArkCompatibleAction","api-reference\u002FcallArkCompatibleAction",{"components":314,"info":688,"openapi":692,"paths":693,"servers":1089,"tags":1093},{"parameters":315,"requestBodies":322,"responses":339,"schemas":384,"securitySchemes":675},{"TaskId":316},{"in":317,"name":318,"required":156,"schema":319},"path","id",{"pattern":320,"type":321},"^VTK-","string",{"ImageEdit":323,"ImageGeneration":329,"OpenAIChat":334},{"content":324,"description":328,"required":156},{"multipart\u002Fform-data":325},{"schema":326},{"$ref":327},"#\u002Fcomponents\u002Fschemas\u002FImageEditRequest","图片编辑 v1\u002Fv3 共用的必填请求体。Content-Type 为 multipart\u002Fform-data；继续解析 ImageEditRequest 可获得 model、prompt、image 等字段。",{"content":330,"required":156},{"application\u002Fjson":331},{"schema":332},{"$ref":333},"#\u002Fcomponents\u002Fschemas\u002FImageGenerationRequest",{"content":335,"required":156},{"application\u002Fjson":336},{"schema":337},{"$ref":338},"#\u002Fcomponents\u002Fschemas\u002FOpenAIChatRequest",{"AnthropicError":340,"ArkError":346,"GeminiError":352,"Image":358,"OpenAIChat":364,"OpenAIError":372,"VolcengineError":378},{"content":341,"description":345},{"application\u002Fjson":342},{"schema":343},{"$ref":344},"#\u002Fcomponents\u002Fschemas\u002FAnthropicError","Anthropic 兼容错误。",{"content":347,"description":351},{"application\u002Fjson":348},{"schema":349},{"$ref":350},"#\u002Fcomponents\u002Fschemas\u002FArkResponse","火山兼容错误 envelope。",{"content":353,"description":357},{"application\u002Fjson":354},{"schema":355},{"$ref":356},"#\u002Fcomponents\u002Fschemas\u002FGeminiError","Gemini 兼容错误。",{"content":359,"description":363},{"application\u002Fjson":360},{"schema":361},{"$ref":362},"#\u002Fcomponents\u002Fschemas\u002FImageResponse","图片生成或编辑响应。",{"content":365,"description":371},{"application\u002Fjson":366,"text\u002Fevent-stream":369},{"schema":367},{"$ref":368},"#\u002Fcomponents\u002Fschemas\u002FOpenAIChatResponse",{"schema":370},{"type":321},"OpenAI Chat JSON 或 SSE 响应。",{"content":373,"description":377},{"application\u002Fjson":374},{"schema":375},{"$ref":376},"#\u002Fcomponents\u002Fschemas\u002FOpenAIError","OpenAI 兼容错误。",{"content":379,"description":383},{"application\u002Fjson":380},{"schema":381},{"$ref":382},"#\u002Fcomponents\u002Fschemas\u002FVolcengineError","Volcengine 兼容错误。",{"AnthropicError":385,"AnthropicRequest":399,"ArkResponse":420,"AssetByIdRequest":424,"AssetGroupByIdRequest":429,"ContentTask":433,"ContentTaskRequest":457,"ContentTaskStatus":465,"CreateAssetGroupRequest":474,"CreateAssetRequest":483,"FreeFormObject":498,"GeminiError":499,"ImageEditRequest":502,"ImageGenerationRequest":518,"ImageResponse":530,"JimengRequest":538,"ListAssetGroupsRequest":551,"ListAssetsRequest":563,"Message":577,"ModelList":593,"OpenAIChatRequest":613,"OpenAIChatResponse":626,"OpenAIError":636,"ResponsesRequest":648,"UpdateAssetGroupRequest":661,"UpdateAssetRequest":667,"VolcengineError":672},{"properties":386,"required":398,"type":394},{"error":387,"type":395},{"properties":388,"required":391,"type":394},{"message":389,"type":390},{"type":321},{"type":321},[392,393],"type","message","object",{"enum":396,"type":321},[397],"error",[392,397],{"additionalProperties":156,"properties":400,"required":416,"type":394},{"max_tokens":401,"messages":403,"model":407,"stream":408,"system":410},{"minimum":8,"type":402},"integer",{"items":404,"minItems":8,"type":406},{"$ref":405},"#\u002Fcomponents\u002Fschemas\u002FMessage","array",{"type":321},{"default":11,"type":409},"boolean",{"oneOf":411},[412,413],{"type":321},{"items":414,"type":406},{"$ref":415},"#\u002Fcomponents\u002Fschemas\u002FFreeFormObject",[417,418,419],"model","max_tokens","messages",{"additionalProperties":156,"properties":421,"type":394},{"ResponseMetadata":422,"Result":423},{"$ref":415},{"$ref":415},{"properties":425,"required":427,"type":394},{"Id":426},{"type":321},[428],"Id",{"properties":430,"required":432,"type":394},{"Id":431},{"type":321},[428],{"additionalProperties":156,"properties":434,"required":455,"type":394},{"content":435,"created_at":436,"error":443,"id":444,"kind":445,"model":448,"status":449,"updated_at":451},{"$ref":415},{"description":437,"oneOf":438},"API 版本 2026-01-01 返回 RFC3339；2026-06-01 返回 Unix 秒。",[439,441],{"format":440,"type":321},"date-time",{"format":442,"type":402},"int64",{"$ref":415},{"type":321},{"enum":446,"type":321},[99,447],"3d",{"type":321},{"$ref":450},"#\u002Fcomponents\u002Fschemas\u002FContentTaskStatus",{"description":437,"oneOf":452},[453,454],{"format":440,"type":321},{"format":442,"type":402},[318,456],"status",{"additionalProperties":156,"properties":458,"required":464,"type":394},{"callback_url":459,"content":461,"model":463},{"format":460,"type":321},"uri",{"items":462,"type":406},{"$ref":415},{"type":321},[417],{"enum":466,"type":321},[467,468,469,470,471,472,473],"queued","running","succeed","succeeded","failed","cancelled","expired",{"properties":475,"required":481,"type":394},{"Description":476,"GroupType":477,"Name":480},{"type":321},{"enum":478,"type":321},[479],"AIGC",{"type":321},[482],"Name",{"properties":484,"required":494,"type":394},{"AssetType":485,"GroupId":490,"Name":491,"URL":493},{"enum":486,"type":321},[487,488,489],"Image","Video","Audio",{"type":321},{"maxLength":492,"type":321},64,{"format":460,"type":321},[495,496,497],"GroupId","URL","AssetType",{"additionalProperties":156,"type":394},{"additionalProperties":156,"properties":500,"type":394},{"error":501},{"$ref":415},{"additionalProperties":156,"properties":503,"required":515,"type":394},{"image":504,"mask":510,"model":511,"n":512,"prompt":513,"size":514},{"oneOf":505},[506,508],{"format":507,"type":321},"binary",{"items":509,"type":406},{"format":507,"type":321},{"format":507,"type":321},{"type":321},{"minimum":8,"type":402},{"type":321},{"type":321},[417,516,517],"prompt","image",{"additionalProperties":156,"properties":519,"required":529,"type":394},{"model":520,"n":523,"prompt":524,"response_format":525,"size":526},{"description":521,"example":522,"type":321},"从模型广场选择支持当前图片接口的模型并复制调用名。","doubao-seedream-5-0-260128",{"minimum":8,"type":402},{"type":321},{"type":321},{"description":527,"example":528,"type":321},"可用尺寸由模型决定；Seedream 5.0 的首次调用示例使用 2048x2048。","2048x2048",[417,516],{"additionalProperties":156,"properties":531,"type":394},{"created":532,"data":533},{"format":442,"type":402},{"items":534,"type":406},{"additionalProperties":156,"properties":535,"type":394},{"b64_json":536,"url":537},{"type":321},{"format":460,"type":321},{"additionalProperties":156,"properties":539,"required":549,"type":394},{"audio_url":540,"image_url":541,"mask_url":542,"req_key":547,"task_id":548},{"format":460,"type":321},{"format":460,"type":321},{"oneOf":543},[544,545],{"format":460,"type":321},{"items":546,"type":406},{"format":460,"type":321},{"type":321},{"type":321},[550],"req_key",{"properties":552,"type":394},{"Filter":553,"PageNumber":559,"PageSize":560,"SortBy":561,"SortOrder":562},{"properties":554,"type":394},{"GroupIds":555,"GroupType":557,"Name":558},{"items":556,"type":406},{"type":321},{"type":321},{"type":321},{"format":442,"minimum":8,"type":402},{"format":442,"minimum":8,"type":402},{"type":321},{"type":321},{"properties":564,"type":394},{"Filter":565,"PageNumber":573,"PageSize":574,"SortBy":575,"SortOrder":576},{"properties":566,"type":394},{"GroupIds":567,"GroupType":569,"Name":570,"Statuses":571},{"items":568,"type":406},{"type":321},{"type":321},{"type":321},{"items":572,"type":406},{"type":321},{"format":442,"minimum":8,"type":402},{"format":442,"minimum":8,"type":402},{"type":321},{"type":321},{"additionalProperties":156,"properties":578,"required":590,"type":394},{"content":579,"role":584},{"oneOf":580},[581,582],{"type":321},{"items":583,"type":406},{"$ref":415},{"enum":585,"type":321},[586,587,588,589],"system","user","assistant","tool",[591,592],"role","content",{"properties":594,"required":611,"type":394},{"data":595,"object":608},{"items":596,"type":406},{"properties":597,"required":605,"type":394},{"created":598,"id":599,"object":601,"owned_by":603},{"type":402},{"description":600,"type":321},"可直接填入请求 model 字段的聚合模型调用名。",{"enum":602,"type":321},[417],{"enum":604,"type":321},[586],[318,394,606,607],"created","owned_by",{"enum":609,"type":321},[610],"list",[394,612],"data",{"additionalProperties":156,"properties":614,"required":625,"type":394},{"max_tokens":615,"messages":616,"model":618,"stream":620,"temperature":621,"tools":623},{"minimum":8,"type":402},{"items":617,"minItems":8,"type":406},{"$ref":405},{"description":619,"type":321},"SilvaMux 模型 id 或 alias。",{"default":11,"type":409},{"type":622},"number",{"items":624,"type":406},{"$ref":415},[417,419],{"additionalProperties":156,"properties":627,"required":634,"type":394},{"choices":628,"id":630,"model":631,"object":632,"usage":633},{"items":629,"type":406},{"$ref":415},{"type":321},{"type":321},{"type":321},{"$ref":415},[318,635],"choices",{"properties":637,"required":647,"type":394},{"error":638},{"additionalProperties":156,"properties":639,"required":646,"type":394},{"code":640,"message":644,"type":645},{"oneOf":641},[642,643],{"type":321},{"type":402},{"type":321},{"type":321},[393],[397],{"additionalProperties":156,"properties":649,"required":659,"type":394},{"input":650,"model":655,"stream":658},{"oneOf":651},[652,653],{"type":321},{"items":654,"type":406},{"$ref":415},{"description":656,"example":657,"type":321},"从模型广场选择标注支持 OpenAI Responses 的模型并复制调用名。","minimax-m2.5",{"default":11,"type":409},[417,660],"input",{"properties":662,"required":666,"type":394},{"Description":663,"Id":664,"Name":665},{"type":321},{"type":321},{"type":321},[428],{"properties":668,"required":671,"type":394},{"Id":669,"Name":670},{"type":321},{"maxLength":492,"type":321},[428],{"additionalProperties":156,"properties":673,"type":394},{"error":674},{"$ref":415},{"ApiKeyAuth":676,"BearerAuth":680,"VolcengineV4":685},{"in":677,"name":678,"type":679},"header","x-api-key","apiKey",{"bearerFormat":681,"description":682,"scheme":683,"type":684},"API Key","平台签发的 sk_live_ API Key。","bearer","http",{"description":686,"in":677,"name":687,"type":679},"平台 AK\u002FSK 计算的 HMAC-SHA256 V4 签名。","Authorization",{"description":689,"title":690,"version":691},"SilvaMux 模型调用、视频与 3D 任务、火山兼容素材和即梦 API。\n兼容入口允许透传对应协议的额外字段；本契约明确列出仓库代码和测试\n能够证明的公共字段。\n本契约使用标准本地 $ref 复用请求体、响应和 schema；读取字段或生成 SDK\n时应递归解析 $ref、allOf、oneOf 和 anyOf。\n","SilvaMux API","1.0.0","3.0.3",{"\u002Fapi\u002Fark":694,"\u002Fapi\u002Fpaas\u002Fv4\u002Fchat\u002Fcompletions":779,"\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions":795,"\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions":808,"\u002Fapi\u002Fv1\u002Fimages\u002Fedits":820,"\u002Fapi\u002Fv1\u002Fimages\u002Fgenerations":837,"\u002Fapi\u002Fv1\u002Fmessages":852,"\u002Fapi\u002Fv1\u002Fmodels":876,"\u002Fapi\u002Fv1\u002Fresponses":892,"\u002Fapi\u002Fv1beta\u002Fmodels\u002F{model_action}":914,"\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions":949,"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks":963,"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F{id}":1026,"\u002Fapi\u002Fv3\u002Fimages\u002Fedits":1062,"\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations":1076},{"post":695},{"description":309,"operationId":306,"parameters":696,"requestBody":722,"responses":766,"security":774,"summary":777,"tags":778},[697,715],{"in":698,"name":699,"required":156,"schema":700},"query","Action",{"enum":701,"type":321},[702,703,704,705,706,707,708,709,710,711,712,713,714],"CreateAssetGroup","GetAssetGroup","ListAssetGroups","UpdateAssetGroup","DeleteAssetGroup","CreateAsset","GetAsset","ListAssets","UpdateAsset","DeleteAsset","CVProcess","CVSubmitTask","CVGetResult",{"description":716,"in":698,"name":717,"schema":718},"火山协议版本。素材操作使用 2024-01-01，CV 操作使用 2022-08-31；当前 handler 不强制校验该参数。","Version",{"enum":719,"type":321},[720,721],"2024-01-01","2022-08-31",{"content":723,"required":156},{"application\u002Fjson":724},{"schema":725},{"oneOf":726},[727,731,736,740,744,748,753,757,761],{"allOf":728,"title":702},[729],{"$ref":730},"#\u002Fcomponents\u002Fschemas\u002FCreateAssetGroupRequest",{"allOf":732,"title":735},[733],{"$ref":734},"#\u002Fcomponents\u002Fschemas\u002FAssetGroupByIdRequest","GetAssetGroup \u002F DeleteAssetGroup",{"allOf":737,"title":704},[738],{"$ref":739},"#\u002Fcomponents\u002Fschemas\u002FListAssetGroupsRequest",{"allOf":741,"title":705},[742],{"$ref":743},"#\u002Fcomponents\u002Fschemas\u002FUpdateAssetGroupRequest",{"allOf":745,"title":707},[746],{"$ref":747},"#\u002Fcomponents\u002Fschemas\u002FCreateAssetRequest",{"allOf":749,"title":752},[750],{"$ref":751},"#\u002Fcomponents\u002Fschemas\u002FAssetByIdRequest","GetAsset \u002F DeleteAsset",{"allOf":754,"title":709},[755],{"$ref":756},"#\u002Fcomponents\u002Fschemas\u002FListAssetsRequest",{"allOf":758,"title":710},[759],{"$ref":760},"#\u002Fcomponents\u002Fschemas\u002FUpdateAssetRequest",{"allOf":762,"title":765},[763],{"$ref":764},"#\u002Fcomponents\u002Fschemas\u002FJimengRequest","CVSubmitTask \u002F CVProcess \u002F CVGetResult",{"200":767,"default":772},{"content":768,"description":771},{"application\u002Fjson":769},{"schema":770},{"$ref":350},"火山兼容响应 envelope。",{"$ref":773},"#\u002Fcomponents\u002Fresponses\u002FArkError",[775],{"VolcengineV4":776},[],"调用火山兼容素材或即梦 Action",[307],{"post":780},{"description":205,"operationId":203,"requestBody":781,"responses":783,"security":788,"summary":793,"tags":794},{"$ref":782},"#\u002Fcomponents\u002FrequestBodies\u002FOpenAIChat",{"200":784,"default":786},{"$ref":785},"#\u002Fcomponents\u002Fresponses\u002FOpenAIChat",{"$ref":787},"#\u002Fcomponents\u002Fresponses\u002FOpenAIError",[789,791],{"BearerAuth":790},[],{"ApiKeyAuth":792},[],"智谱 Chat Completions",[204],{"post":796},{"description":216,"operationId":214,"requestBody":797,"responses":798,"security":801,"summary":806,"tags":807},{"$ref":782},{"200":799,"default":800},{"$ref":785},{"$ref":787},[802,804],{"BearerAuth":803},[],{"ApiKeyAuth":805},[],"SilvaMux 统一对话",[215],{"post":809},{"description":165,"operationId":162,"requestBody":810,"responses":811,"security":814,"summary":164,"tags":819},{"$ref":782},{"200":812,"default":813},{"$ref":785},{"$ref":787},[815,817],{"BearerAuth":816},[],{"ApiKeyAuth":818},[],[163],{"post":821},{"description":822,"operationId":823,"requestBody":824,"responses":826,"security":830,"summary":835,"tags":836},"使用 multipart\u002Fform-data 上传图片；请求体通过 #\u002Fcomponents\u002FrequestBodies\u002FImageEdit 定义，解析后 model、prompt 和 image 为必填字段。","editImageV1",{"$ref":825},"#\u002Fcomponents\u002FrequestBodies\u002FImageEdit",{"200":827,"default":829},{"$ref":828},"#\u002Fcomponents\u002Fresponses\u002FImage",{"$ref":787},[831,833],{"BearerAuth":832},[],{"ApiKeyAuth":834},[],"编辑图片（OpenAI v1）",[225],{"post":838},{"operationId":839,"requestBody":840,"responses":842,"security":845,"summary":850,"tags":851},"createImageV1",{"$ref":841},"#\u002Fcomponents\u002FrequestBodies\u002FImageGeneration",{"200":843,"default":844},{"$ref":828},{"$ref":787},[846,848],{"BearerAuth":847},[],{"ApiKeyAuth":849},[],"创建图片（OpenAI v1）",[225],{"post":853},{"description":184,"operationId":182,"requestBody":854,"responses":859,"security":869,"summary":874,"tags":875},{"content":855,"required":156},{"application\u002Fjson":856},{"schema":857},{"$ref":858},"#\u002Fcomponents\u002Fschemas\u002FAnthropicRequest",{"200":860,"default":867},{"content":861,"description":866},{"application\u002Fjson":862,"text\u002Fevent-stream":864},{"schema":863},{"$ref":415},{"schema":865},{"type":321},"Anthropic JSON 或 SSE 响应。",{"$ref":868},"#\u002Fcomponents\u002Fresponses\u002FAnthropicError",[870,872],{"BearerAuth":871},[],{"ApiKeyAuth":873},[],"Anthropic Messages",[183],{"get":877},{"description":150,"operationId":147,"responses":878,"security":886,"summary":890,"tags":891},{"200":879,"default":885},{"content":880,"description":884},{"application\u002Fjson":881},{"schema":882},{"$ref":883},"#\u002Fcomponents\u002Fschemas\u002FModelList","OpenAI 兼容模型列表。",{"$ref":787},[887,888],{},{"BearerAuth":889},[],"列出公开模型",[149],{"post":893},{"operationId":171,"requestBody":894,"responses":899,"security":908,"summary":172,"tags":913},{"content":895,"required":156},{"application\u002Fjson":896},{"schema":897},{"$ref":898},"#\u002Fcomponents\u002Fschemas\u002FResponsesRequest",{"200":900,"default":907},{"content":901,"description":906},{"application\u002Fjson":902,"text\u002Fevent-stream":904},{"schema":903},{"$ref":415},{"schema":905},{"type":321},"Responses JSON 或 SSE 响应。",{"$ref":787},[909,911],{"BearerAuth":910},[],{"ApiKeyAuth":912},[],[163],{"post":915},{"description":916,"operationId":917,"parameters":918,"requestBody":923,"responses":933,"security":941,"summary":946,"tags":947},"标准 Gemini v1beta 兼容路径；历史路径 \u002Fapi\u002Fv1\u002Fgemini\u002Fv1beta\u002Fmodels\u002F{model_action} 继续兼容。","generateGeminiContent",[919],{"example":920,"in":317,"name":921,"required":156,"schema":922},"gemini-3.1-flash-image:generateContent","model_action",{"type":321},{"content":924,"required":156},{"application\u002Fjson":925},{"schema":926},{"additionalProperties":156,"properties":927,"required":931,"type":394},{"contents":928,"generationConfig":930},{"items":929,"minItems":8,"type":406},{"$ref":415},{"$ref":415},[932],"contents",{"200":934,"default":939},{"content":935,"description":938},{"application\u002Fjson":936},{"schema":937},{"$ref":415},"Gemini 兼容响应。",{"$ref":940},"#\u002Fcomponents\u002Fresponses\u002FGeminiError",[942,944],{"BearerAuth":943},[],{"ApiKeyAuth":945},[],"Gemini Generate Content",[948],"Gemini",{"post":950},{"operationId":193,"requestBody":951,"responses":952,"security":956,"summary":961,"tags":962},{"$ref":782},{"200":953,"default":954},{"$ref":785},{"$ref":955},"#\u002Fcomponents\u002Fresponses\u002FVolcengineError",[957,959],{"BearerAuth":958},[],{"ApiKeyAuth":960},[],"Volcengine Chat Completions",[194],{"get":964,"post":1007},{"operationId":282,"parameters":965,"responses":988,"security":1003,"summary":284,"tags":1006},[966,969,973,976,979,983],{"in":698,"name":967,"schema":968},"page_num",{"default":8,"minimum":8,"type":402},{"in":698,"name":970,"schema":971},"page_size",{"default":41,"maximum":972,"minimum":8,"type":402},100,{"in":698,"name":974,"schema":975},"filter.status",{"$ref":450},{"in":698,"name":977,"schema":978},"filter.model",{"type":321},{"in":698,"name":980,"schema":981},"filter.kind",{"enum":982,"type":321},[99,447],{"explode":156,"in":698,"name":984,"schema":985,"style":987},"filter.task_ids",{"items":986,"type":406},{"type":321},"form",{"200":989,"default":1002},{"content":990,"description":1001},{"application\u002Fjson":991},{"schema":992},{"properties":993,"required":998,"type":394},{"items":994,"total":997},{"items":995,"type":406},{"$ref":996},"#\u002Fcomponents\u002Fschemas\u002FContentTask",{"format":442,"type":402},[999,1000],"total","items","任务列表。",{"$ref":787},[1004],{"BearerAuth":1005},[],[283],{"operationId":289,"requestBody":1008,"responses":1013,"security":1020,"summary":290,"tags":1025},{"content":1009,"required":156},{"application\u002Fjson":1010},{"schema":1011},{"$ref":1012},"#\u002Fcomponents\u002Fschemas\u002FContentTaskRequest",{"200":1014,"default":1019},{"content":1015,"description":1018},{"application\u002Fjson":1016},{"schema":1017},{"$ref":996},"任务创建成功。",{"$ref":955},[1021,1023],{"BearerAuth":1022},[],{"ApiKeyAuth":1024},[],[283],{"delete":1027,"get":1048},{"operationId":294,"parameters":1028,"responses":1031,"security":1044,"summary":295,"tags":1047},[1029],{"$ref":1030},"#\u002Fcomponents\u002Fparameters\u002FTaskId",{"200":1032,"409":1042,"default":1043},{"content":1033,"description":1041},{"application\u002Fjson":1034},{"schema":1035},{"properties":1036,"required":1040,"type":394},{"id":1037,"status":1038},{"type":321},{"enum":1039,"type":321},[472],[318,456],"任务已取消。",{"$ref":787},{"$ref":787},[1045],{"BearerAuth":1046},[],[283],{"operationId":301,"parameters":1049,"responses":1051,"security":1058,"summary":302,"tags":1061},[1050],{"$ref":1030},{"200":1052,"default":1057},{"content":1053,"description":1056},{"application\u002Fjson":1054},{"schema":1055},{"$ref":996},"任务详情。",{"$ref":787},[1059],{"BearerAuth":1060},[],[283],{"post":1063},{"description":822,"operationId":1064,"requestBody":1065,"responses":1066,"security":1069,"summary":1074,"tags":1075},"editImageV3",{"$ref":825},{"200":1067,"default":1068},{"$ref":828},{"$ref":787},[1070,1072],{"BearerAuth":1071},[],{"ApiKeyAuth":1073},[],"编辑图片（Volcengine v3）",[225],{"post":1077},{"operationId":224,"requestBody":1078,"responses":1079,"security":1082,"summary":1087,"tags":1088},{"$ref":841},{"200":1080,"default":1081},{"$ref":828},{"$ref":955},[1083,1085],{"BearerAuth":1084},[],{"ApiKeyAuth":1086},[],"创建图片（Volcengine v3）",[225],[1090],{"description":1091,"url":1092},"当前 SilvaMux 部署","\u002F",[1094,1095,1096,1097,1098,1100,1101,1102,1103,1104],{"description":159,"name":163},{"description":179,"name":183},{"description":190,"name":194},{"description":200,"name":204},{"description":1099,"name":948},"Gemini 兼容接口",{"description":211,"name":215},{"description":221,"name":225},{"description":279,"name":283},{"description":144,"name":149},{"description":1105,"name":307},"火山兼容素材与即梦"]