[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-reference-data-createOpenAIChatCompletion":3,"api-reference-contract-\u002Fopenapi\u002Fsilvamux.json":306},{"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":162,"kind":148,"tag":163,"summary":164,"description":165,"method":166,"path":167,"sourcePath":167,"contractUrl":153,"href":168,"currentPath":169,"publiclyDiscoverable":156},{"components":307,"info":681,"openapi":685,"paths":686,"servers":1085,"tags":1089},{"parameters":308,"requestBodies":315,"responses":332,"schemas":377,"securitySchemes":668},{"TaskId":309},{"in":310,"name":311,"required":156,"schema":312},"path","id",{"pattern":313,"type":314},"^VTK-","string",{"ImageEdit":316,"ImageGeneration":322,"OpenAIChat":327},{"content":317,"description":321,"required":156},{"multipart\u002Fform-data":318},{"schema":319},{"$ref":320},"#\u002Fcomponents\u002Fschemas\u002FImageEditRequest","图片编辑 v1\u002Fv3 共用的必填请求体。Content-Type 为 multipart\u002Fform-data；继续解析 ImageEditRequest 可获得 model、prompt、image 等字段。",{"content":323,"required":156},{"application\u002Fjson":324},{"schema":325},{"$ref":326},"#\u002Fcomponents\u002Fschemas\u002FImageGenerationRequest",{"content":328,"required":156},{"application\u002Fjson":329},{"schema":330},{"$ref":331},"#\u002Fcomponents\u002Fschemas\u002FOpenAIChatRequest",{"AnthropicError":333,"ArkError":339,"GeminiError":345,"Image":351,"OpenAIChat":357,"OpenAIError":365,"VolcengineError":371},{"content":334,"description":338},{"application\u002Fjson":335},{"schema":336},{"$ref":337},"#\u002Fcomponents\u002Fschemas\u002FAnthropicError","Anthropic 兼容错误。",{"content":340,"description":344},{"application\u002Fjson":341},{"schema":342},{"$ref":343},"#\u002Fcomponents\u002Fschemas\u002FArkResponse","火山兼容错误 envelope。",{"content":346,"description":350},{"application\u002Fjson":347},{"schema":348},{"$ref":349},"#\u002Fcomponents\u002Fschemas\u002FGeminiError","Gemini 兼容错误。",{"content":352,"description":356},{"application\u002Fjson":353},{"schema":354},{"$ref":355},"#\u002Fcomponents\u002Fschemas\u002FImageResponse","图片生成或编辑响应。",{"content":358,"description":364},{"application\u002Fjson":359,"text\u002Fevent-stream":362},{"schema":360},{"$ref":361},"#\u002Fcomponents\u002Fschemas\u002FOpenAIChatResponse",{"schema":363},{"type":314},"OpenAI Chat JSON 或 SSE 响应。",{"content":366,"description":370},{"application\u002Fjson":367},{"schema":368},{"$ref":369},"#\u002Fcomponents\u002Fschemas\u002FOpenAIError","OpenAI 兼容错误。",{"content":372,"description":376},{"application\u002Fjson":373},{"schema":374},{"$ref":375},"#\u002Fcomponents\u002Fschemas\u002FVolcengineError","Volcengine 兼容错误。",{"AnthropicError":378,"AnthropicRequest":392,"ArkResponse":413,"AssetByIdRequest":417,"AssetGroupByIdRequest":422,"ContentTask":426,"ContentTaskRequest":450,"ContentTaskStatus":458,"CreateAssetGroupRequest":467,"CreateAssetRequest":476,"FreeFormObject":491,"GeminiError":492,"ImageEditRequest":495,"ImageGenerationRequest":511,"ImageResponse":523,"JimengRequest":531,"ListAssetGroupsRequest":544,"ListAssetsRequest":556,"Message":570,"ModelList":586,"OpenAIChatRequest":606,"OpenAIChatResponse":619,"OpenAIError":629,"ResponsesRequest":641,"UpdateAssetGroupRequest":654,"UpdateAssetRequest":660,"VolcengineError":665},{"properties":379,"required":391,"type":387},{"error":380,"type":388},{"properties":381,"required":384,"type":387},{"message":382,"type":383},{"type":314},{"type":314},[385,386],"type","message","object",{"enum":389,"type":314},[390],"error",[385,390],{"additionalProperties":156,"properties":393,"required":409,"type":387},{"max_tokens":394,"messages":396,"model":400,"stream":401,"system":403},{"minimum":8,"type":395},"integer",{"items":397,"minItems":8,"type":399},{"$ref":398},"#\u002Fcomponents\u002Fschemas\u002FMessage","array",{"type":314},{"default":11,"type":402},"boolean",{"oneOf":404},[405,406],{"type":314},{"items":407,"type":399},{"$ref":408},"#\u002Fcomponents\u002Fschemas\u002FFreeFormObject",[410,411,412],"model","max_tokens","messages",{"additionalProperties":156,"properties":414,"type":387},{"ResponseMetadata":415,"Result":416},{"$ref":408},{"$ref":408},{"properties":418,"required":420,"type":387},{"Id":419},{"type":314},[421],"Id",{"properties":423,"required":425,"type":387},{"Id":424},{"type":314},[421],{"additionalProperties":156,"properties":427,"required":448,"type":387},{"content":428,"created_at":429,"error":436,"id":437,"kind":438,"model":441,"status":442,"updated_at":444},{"$ref":408},{"description":430,"oneOf":431},"API 版本 2026-01-01 返回 RFC3339；2026-06-01 返回 Unix 秒。",[432,434],{"format":433,"type":314},"date-time",{"format":435,"type":395},"int64",{"$ref":408},{"type":314},{"enum":439,"type":314},[99,440],"3d",{"type":314},{"$ref":443},"#\u002Fcomponents\u002Fschemas\u002FContentTaskStatus",{"description":430,"oneOf":445},[446,447],{"format":433,"type":314},{"format":435,"type":395},[311,449],"status",{"additionalProperties":156,"properties":451,"required":457,"type":387},{"callback_url":452,"content":454,"model":456},{"format":453,"type":314},"uri",{"items":455,"type":399},{"$ref":408},{"type":314},[410],{"enum":459,"type":314},[460,461,462,463,464,465,466],"queued","running","succeed","succeeded","failed","cancelled","expired",{"properties":468,"required":474,"type":387},{"Description":469,"GroupType":470,"Name":473},{"type":314},{"enum":471,"type":314},[472],"AIGC",{"type":314},[475],"Name",{"properties":477,"required":487,"type":387},{"AssetType":478,"GroupId":483,"Name":484,"URL":486},{"enum":479,"type":314},[480,481,482],"Image","Video","Audio",{"type":314},{"maxLength":485,"type":314},64,{"format":453,"type":314},[488,489,490],"GroupId","URL","AssetType",{"additionalProperties":156,"type":387},{"additionalProperties":156,"properties":493,"type":387},{"error":494},{"$ref":408},{"additionalProperties":156,"properties":496,"required":508,"type":387},{"image":497,"mask":503,"model":504,"n":505,"prompt":506,"size":507},{"oneOf":498},[499,501],{"format":500,"type":314},"binary",{"items":502,"type":399},{"format":500,"type":314},{"format":500,"type":314},{"type":314},{"minimum":8,"type":395},{"type":314},{"type":314},[410,509,510],"prompt","image",{"additionalProperties":156,"properties":512,"required":522,"type":387},{"model":513,"n":516,"prompt":517,"response_format":518,"size":519},{"description":514,"example":515,"type":314},"从模型广场选择支持当前图片接口的模型并复制调用名。","doubao-seedream-5-0-260128",{"minimum":8,"type":395},{"type":314},{"type":314},{"description":520,"example":521,"type":314},"可用尺寸由模型决定；Seedream 5.0 的首次调用示例使用 2048x2048。","2048x2048",[410,509],{"additionalProperties":156,"properties":524,"type":387},{"created":525,"data":526},{"format":435,"type":395},{"items":527,"type":399},{"additionalProperties":156,"properties":528,"type":387},{"b64_json":529,"url":530},{"type":314},{"format":453,"type":314},{"additionalProperties":156,"properties":532,"required":542,"type":387},{"audio_url":533,"image_url":534,"mask_url":535,"req_key":540,"task_id":541},{"format":453,"type":314},{"format":453,"type":314},{"oneOf":536},[537,538],{"format":453,"type":314},{"items":539,"type":399},{"format":453,"type":314},{"type":314},{"type":314},[543],"req_key",{"properties":545,"type":387},{"Filter":546,"PageNumber":552,"PageSize":553,"SortBy":554,"SortOrder":555},{"properties":547,"type":387},{"GroupIds":548,"GroupType":550,"Name":551},{"items":549,"type":399},{"type":314},{"type":314},{"type":314},{"format":435,"minimum":8,"type":395},{"format":435,"minimum":8,"type":395},{"type":314},{"type":314},{"properties":557,"type":387},{"Filter":558,"PageNumber":566,"PageSize":567,"SortBy":568,"SortOrder":569},{"properties":559,"type":387},{"GroupIds":560,"GroupType":562,"Name":563,"Statuses":564},{"items":561,"type":399},{"type":314},{"type":314},{"type":314},{"items":565,"type":399},{"type":314},{"format":435,"minimum":8,"type":395},{"format":435,"minimum":8,"type":395},{"type":314},{"type":314},{"additionalProperties":156,"properties":571,"required":583,"type":387},{"content":572,"role":577},{"oneOf":573},[574,575],{"type":314},{"items":576,"type":399},{"$ref":408},{"enum":578,"type":314},[579,580,581,582],"system","user","assistant","tool",[584,585],"role","content",{"properties":587,"required":604,"type":387},{"data":588,"object":601},{"items":589,"type":399},{"properties":590,"required":598,"type":387},{"created":591,"id":592,"object":594,"owned_by":596},{"type":395},{"description":593,"type":314},"可直接填入请求 model 字段的聚合模型调用名。",{"enum":595,"type":314},[410],{"enum":597,"type":314},[579],[311,387,599,600],"created","owned_by",{"enum":602,"type":314},[603],"list",[387,605],"data",{"additionalProperties":156,"properties":607,"required":618,"type":387},{"max_tokens":608,"messages":609,"model":611,"stream":613,"temperature":614,"tools":616},{"minimum":8,"type":395},{"items":610,"minItems":8,"type":399},{"$ref":398},{"description":612,"type":314},"SilvaMux 模型 id 或 alias。",{"default":11,"type":402},{"type":615},"number",{"items":617,"type":399},{"$ref":408},[410,412],{"additionalProperties":156,"properties":620,"required":627,"type":387},{"choices":621,"id":623,"model":624,"object":625,"usage":626},{"items":622,"type":399},{"$ref":408},{"type":314},{"type":314},{"type":314},{"$ref":408},[311,628],"choices",{"properties":630,"required":640,"type":387},{"error":631},{"additionalProperties":156,"properties":632,"required":639,"type":387},{"code":633,"message":637,"type":638},{"oneOf":634},[635,636],{"type":314},{"type":395},{"type":314},{"type":314},[386],[390],{"additionalProperties":156,"properties":642,"required":652,"type":387},{"input":643,"model":648,"stream":651},{"oneOf":644},[645,646],{"type":314},{"items":647,"type":399},{"$ref":408},{"description":649,"example":650,"type":314},"从模型广场选择标注支持 OpenAI Responses 的模型并复制调用名。","minimax-m2.5",{"default":11,"type":402},[410,653],"input",{"properties":655,"required":659,"type":387},{"Description":656,"Id":657,"Name":658},{"type":314},{"type":314},{"type":314},[421],{"properties":661,"required":664,"type":387},{"Id":662,"Name":663},{"type":314},{"maxLength":485,"type":314},[421],{"additionalProperties":156,"properties":666,"type":387},{"error":667},{"$ref":408},{"ApiKeyAuth":669,"BearerAuth":673,"VolcengineV4":678},{"in":670,"name":671,"type":672},"header","x-api-key","apiKey",{"bearerFormat":674,"description":675,"scheme":676,"type":677},"API Key","平台签发的 sk_live_ API Key。","bearer","http",{"description":679,"in":670,"name":680,"type":672},"平台 AK\u002FSK 计算的 HMAC-SHA256 V4 签名。","Authorization",{"description":682,"title":683,"version":684},"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":687,"\u002Fapi\u002Fpaas\u002Fv4\u002Fchat\u002Fcompletions":775,"\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions":791,"\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions":804,"\u002Fapi\u002Fv1\u002Fimages\u002Fedits":816,"\u002Fapi\u002Fv1\u002Fimages\u002Fgenerations":833,"\u002Fapi\u002Fv1\u002Fmessages":848,"\u002Fapi\u002Fv1\u002Fmodels":872,"\u002Fapi\u002Fv1\u002Fresponses":888,"\u002Fapi\u002Fv1beta\u002Fmodels\u002F{model_action}":910,"\u002Fapi\u002Fv3\u002Fchat\u002Fcompletions":945,"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks":959,"\u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F{id}":1022,"\u002Fapi\u002Fv3\u002Fimages\u002Fedits":1058,"\u002Fapi\u002Fv3\u002Fimages\u002Fgenerations":1072},{"post":688},{"description":689,"operationId":690,"parameters":691,"requestBody":717,"responses":761,"security":769,"summary":772,"tags":773},"多个素材和 CV Action 共用该路径，请求体结构由 Action 和 Version 决定。","callArkCompatibleAction",[692,710],{"in":693,"name":694,"required":156,"schema":695},"query","Action",{"enum":696,"type":314},[697,698,699,700,701,702,703,704,705,706,707,708,709],"CreateAssetGroup","GetAssetGroup","ListAssetGroups","UpdateAssetGroup","DeleteAssetGroup","CreateAsset","GetAsset","ListAssets","UpdateAsset","DeleteAsset","CVProcess","CVSubmitTask","CVGetResult",{"description":711,"in":693,"name":712,"schema":713},"火山协议版本。素材操作使用 2024-01-01，CV 操作使用 2022-08-31；当前 handler 不强制校验该参数。","Version",{"enum":714,"type":314},[715,716],"2024-01-01","2022-08-31",{"content":718,"required":156},{"application\u002Fjson":719},{"schema":720},{"oneOf":721},[722,726,731,735,739,743,748,752,756],{"allOf":723,"title":697},[724],{"$ref":725},"#\u002Fcomponents\u002Fschemas\u002FCreateAssetGroupRequest",{"allOf":727,"title":730},[728],{"$ref":729},"#\u002Fcomponents\u002Fschemas\u002FAssetGroupByIdRequest","GetAssetGroup \u002F DeleteAssetGroup",{"allOf":732,"title":699},[733],{"$ref":734},"#\u002Fcomponents\u002Fschemas\u002FListAssetGroupsRequest",{"allOf":736,"title":700},[737],{"$ref":738},"#\u002Fcomponents\u002Fschemas\u002FUpdateAssetGroupRequest",{"allOf":740,"title":702},[741],{"$ref":742},"#\u002Fcomponents\u002Fschemas\u002FCreateAssetRequest",{"allOf":744,"title":747},[745],{"$ref":746},"#\u002Fcomponents\u002Fschemas\u002FAssetByIdRequest","GetAsset \u002F DeleteAsset",{"allOf":749,"title":704},[750],{"$ref":751},"#\u002Fcomponents\u002Fschemas\u002FListAssetsRequest",{"allOf":753,"title":705},[754],{"$ref":755},"#\u002Fcomponents\u002Fschemas\u002FUpdateAssetRequest",{"allOf":757,"title":760},[758],{"$ref":759},"#\u002Fcomponents\u002Fschemas\u002FJimengRequest","CVSubmitTask \u002F CVProcess \u002F CVGetResult",{"200":762,"default":767},{"content":763,"description":766},{"application\u002Fjson":764},{"schema":765},{"$ref":343},"火山兼容响应 envelope。",{"$ref":768},"#\u002Fcomponents\u002Fresponses\u002FArkError",[770],{"VolcengineV4":771},[],"调用火山兼容素材或即梦 Action",[774],"Ark",{"post":776},{"description":205,"operationId":203,"requestBody":777,"responses":779,"security":784,"summary":789,"tags":790},{"$ref":778},"#\u002Fcomponents\u002FrequestBodies\u002FOpenAIChat",{"200":780,"default":782},{"$ref":781},"#\u002Fcomponents\u002Fresponses\u002FOpenAIChat",{"$ref":783},"#\u002Fcomponents\u002Fresponses\u002FOpenAIError",[785,787],{"BearerAuth":786},[],{"ApiKeyAuth":788},[],"智谱 Chat Completions",[204],{"post":792},{"description":216,"operationId":214,"requestBody":793,"responses":794,"security":797,"summary":802,"tags":803},{"$ref":778},{"200":795,"default":796},{"$ref":781},{"$ref":783},[798,800],{"BearerAuth":799},[],{"ApiKeyAuth":801},[],"SilvaMux 统一对话",[215],{"post":805},{"description":165,"operationId":162,"requestBody":806,"responses":807,"security":810,"summary":164,"tags":815},{"$ref":778},{"200":808,"default":809},{"$ref":781},{"$ref":783},[811,813],{"BearerAuth":812},[],{"ApiKeyAuth":814},[],[163],{"post":817},{"description":818,"operationId":819,"requestBody":820,"responses":822,"security":826,"summary":831,"tags":832},"使用 multipart\u002Fform-data 上传图片；请求体通过 #\u002Fcomponents\u002FrequestBodies\u002FImageEdit 定义，解析后 model、prompt 和 image 为必填字段。","editImageV1",{"$ref":821},"#\u002Fcomponents\u002FrequestBodies\u002FImageEdit",{"200":823,"default":825},{"$ref":824},"#\u002Fcomponents\u002Fresponses\u002FImage",{"$ref":783},[827,829],{"BearerAuth":828},[],{"ApiKeyAuth":830},[],"编辑图片（OpenAI v1）",[225],{"post":834},{"operationId":835,"requestBody":836,"responses":838,"security":841,"summary":846,"tags":847},"createImageV1",{"$ref":837},"#\u002Fcomponents\u002FrequestBodies\u002FImageGeneration",{"200":839,"default":840},{"$ref":824},{"$ref":783},[842,844],{"BearerAuth":843},[],{"ApiKeyAuth":845},[],"创建图片（OpenAI v1）",[225],{"post":849},{"description":184,"operationId":182,"requestBody":850,"responses":855,"security":865,"summary":870,"tags":871},{"content":851,"required":156},{"application\u002Fjson":852},{"schema":853},{"$ref":854},"#\u002Fcomponents\u002Fschemas\u002FAnthropicRequest",{"200":856,"default":863},{"content":857,"description":862},{"application\u002Fjson":858,"text\u002Fevent-stream":860},{"schema":859},{"$ref":408},{"schema":861},{"type":314},"Anthropic JSON 或 SSE 响应。",{"$ref":864},"#\u002Fcomponents\u002Fresponses\u002FAnthropicError",[866,868],{"BearerAuth":867},[],{"ApiKeyAuth":869},[],"Anthropic Messages",[183],{"get":873},{"description":150,"operationId":147,"responses":874,"security":882,"summary":886,"tags":887},{"200":875,"default":881},{"content":876,"description":880},{"application\u002Fjson":877},{"schema":878},{"$ref":879},"#\u002Fcomponents\u002Fschemas\u002FModelList","OpenAI 兼容模型列表。",{"$ref":783},[883,884],{},{"BearerAuth":885},[],"列出公开模型",[149],{"post":889},{"operationId":171,"requestBody":890,"responses":895,"security":904,"summary":172,"tags":909},{"content":891,"required":156},{"application\u002Fjson":892},{"schema":893},{"$ref":894},"#\u002Fcomponents\u002Fschemas\u002FResponsesRequest",{"200":896,"default":903},{"content":897,"description":902},{"application\u002Fjson":898,"text\u002Fevent-stream":900},{"schema":899},{"$ref":408},{"schema":901},{"type":314},"Responses JSON 或 SSE 响应。",{"$ref":783},[905,907],{"BearerAuth":906},[],{"ApiKeyAuth":908},[],[163],{"post":911},{"description":912,"operationId":913,"parameters":914,"requestBody":919,"responses":929,"security":937,"summary":942,"tags":943},"标准 Gemini v1beta 兼容路径；历史路径 \u002Fapi\u002Fv1\u002Fgemini\u002Fv1beta\u002Fmodels\u002F{model_action} 继续兼容。","generateGeminiContent",[915],{"example":916,"in":310,"name":917,"required":156,"schema":918},"gemini-3.1-flash-image:generateContent","model_action",{"type":314},{"content":920,"required":156},{"application\u002Fjson":921},{"schema":922},{"additionalProperties":156,"properties":923,"required":927,"type":387},{"contents":924,"generationConfig":926},{"items":925,"minItems":8,"type":399},{"$ref":408},{"$ref":408},[928],"contents",{"200":930,"default":935},{"content":931,"description":934},{"application\u002Fjson":932},{"schema":933},{"$ref":408},"Gemini 兼容响应。",{"$ref":936},"#\u002Fcomponents\u002Fresponses\u002FGeminiError",[938,940],{"BearerAuth":939},[],{"ApiKeyAuth":941},[],"Gemini Generate Content",[944],"Gemini",{"post":946},{"operationId":193,"requestBody":947,"responses":948,"security":952,"summary":957,"tags":958},{"$ref":778},{"200":949,"default":950},{"$ref":781},{"$ref":951},"#\u002Fcomponents\u002Fresponses\u002FVolcengineError",[953,955],{"BearerAuth":954},[],{"ApiKeyAuth":956},[],"Volcengine Chat Completions",[194],{"get":960,"post":1003},{"operationId":282,"parameters":961,"responses":984,"security":999,"summary":284,"tags":1002},[962,965,969,972,975,979],{"in":693,"name":963,"schema":964},"page_num",{"default":8,"minimum":8,"type":395},{"in":693,"name":966,"schema":967},"page_size",{"default":41,"maximum":968,"minimum":8,"type":395},100,{"in":693,"name":970,"schema":971},"filter.status",{"$ref":443},{"in":693,"name":973,"schema":974},"filter.model",{"type":314},{"in":693,"name":976,"schema":977},"filter.kind",{"enum":978,"type":314},[99,440],{"explode":156,"in":693,"name":980,"schema":981,"style":983},"filter.task_ids",{"items":982,"type":399},{"type":314},"form",{"200":985,"default":998},{"content":986,"description":997},{"application\u002Fjson":987},{"schema":988},{"properties":989,"required":994,"type":387},{"items":990,"total":993},{"items":991,"type":399},{"$ref":992},"#\u002Fcomponents\u002Fschemas\u002FContentTask",{"format":435,"type":395},[995,996],"total","items","任务列表。",{"$ref":783},[1000],{"BearerAuth":1001},[],[283],{"operationId":289,"requestBody":1004,"responses":1009,"security":1016,"summary":290,"tags":1021},{"content":1005,"required":156},{"application\u002Fjson":1006},{"schema":1007},{"$ref":1008},"#\u002Fcomponents\u002Fschemas\u002FContentTaskRequest",{"200":1010,"default":1015},{"content":1011,"description":1014},{"application\u002Fjson":1012},{"schema":1013},{"$ref":992},"任务创建成功。",{"$ref":951},[1017,1019],{"BearerAuth":1018},[],{"ApiKeyAuth":1020},[],[283],{"delete":1023,"get":1044},{"operationId":294,"parameters":1024,"responses":1027,"security":1040,"summary":295,"tags":1043},[1025],{"$ref":1026},"#\u002Fcomponents\u002Fparameters\u002FTaskId",{"200":1028,"409":1038,"default":1039},{"content":1029,"description":1037},{"application\u002Fjson":1030},{"schema":1031},{"properties":1032,"required":1036,"type":387},{"id":1033,"status":1034},{"type":314},{"enum":1035,"type":314},[465],[311,449],"任务已取消。",{"$ref":783},{"$ref":783},[1041],{"BearerAuth":1042},[],[283],{"operationId":301,"parameters":1045,"responses":1047,"security":1054,"summary":302,"tags":1057},[1046],{"$ref":1026},{"200":1048,"default":1053},{"content":1049,"description":1052},{"application\u002Fjson":1050},{"schema":1051},{"$ref":992},"任务详情。",{"$ref":783},[1055],{"BearerAuth":1056},[],[283],{"post":1059},{"description":818,"operationId":1060,"requestBody":1061,"responses":1062,"security":1065,"summary":1070,"tags":1071},"editImageV3",{"$ref":821},{"200":1063,"default":1064},{"$ref":824},{"$ref":783},[1066,1068],{"BearerAuth":1067},[],{"ApiKeyAuth":1069},[],"编辑图片（Volcengine v3）",[225],{"post":1073},{"operationId":224,"requestBody":1074,"responses":1075,"security":1078,"summary":1083,"tags":1084},{"$ref":837},{"200":1076,"default":1077},{"$ref":824},{"$ref":951},[1079,1081],{"BearerAuth":1080},[],{"ApiKeyAuth":1082},[],"创建图片（Volcengine v3）",[225],[1086],{"description":1087,"url":1088},"当前 SilvaMux 部署","\u002F",[1090,1091,1092,1093,1094,1096,1097,1098,1099,1100],{"description":159,"name":163},{"description":179,"name":183},{"description":190,"name":194},{"description":200,"name":204},{"description":1095,"name":944},"Gemini 兼容接口",{"description":211,"name":215},{"description":221,"name":225},{"description":279,"name":283},{"description":144,"name":149},{"description":1101,"name":774},"火山兼容素材与即梦"]