# 开发者问答

标准 URL： https://sosoapi.ai/zh-hans/docs/developer-faq

直接解答 npm 别名、API 与 MCP 选择、身份验证、媒体、安全重试、速率限制，以及已发布的真正含义。

## 四个 npm 套件是不同的 SDK 吗？

不是。安装 sosoapi 或其别名之一：@sosoapi/cli、sosoapi-cli 或 sosoapi-mcp。每个别名使用完全相同版本的 CLI 和 MCP 实现。只需安装一个。

- [安装与套件](https://sosoapi.ai/zh-hans/docs/installation)

## 我该使用 HTTP、CLI 还是 MCP？

在服务器中使用 HTTP，用 CLI 进行 shell 自动化和检查 schema，或通过兼容 agent 使用 MCP。它们使用相同的公开 API 契约。MCP 还提供本地文件上传，以及为你处理媒体准备的图片 URL 发帖工具。不要让服务器凭证出现在浏览器代码中。

- [完整 API 参考](https://sosoapi.ai/zh-hans/docs/api)

- [MCP 工具参考](https://sosoapi.ai/zh-hans/docs/mcp)

## 设置或 OAuth 同意会发布帖子吗？

不会。设置不会发布任何内容。OAuth 同意会在所选范围内授予持续访问权限，不会为每次写入要求新的浏览器批准。请告知 agent 何时等待审核，并在要求发布前检查账号、内容和时间。

- [验证与权限](https://sosoapi.ai/zh-hans/docs/authentication)

## HTTP 200 或 202 表示已发布吗？

不代表。请求可能已接受、已排程或仍在处理中。请存储帖子 ID，并读取同一篇排程帖子，直到其结果确认已发布。若可获取永久链接，请一并提供，并分别报告各目标结果。

- [发布结果](https://sosoapi.ai/zh-hans/docs/publishing-api-reference)

## 逾时后可以重试吗？

先检查现有操作。保留排程帖子 ID，对相同请求重复使用相同幂等键。变更载荷就代表不同请求。若要重试、更新或取消现有帖子，请使用其当前版本，以及 SosoAPI 针对该状态提供的操作。

- [安全处理错误](https://sosoapi.ai/zh-hans/docs/troubleshooting)

## 为什么客户端里缺少某个工具？

检查配置、连接类型以及客户端是否已重新加载服务器。core 隐藏管理工具；HTTP 连接不含本地文件上传。工具参考列出可用性。更改配置不会改变账号权限或资格。

- [MCP 工具参考](https://sosoapi.ai/zh-hans/docs/mcp)

## 远端 MCP 可以上传本地文件吗？

不可以。请使用本地 MCP，从允许的文件夹上传文件，或通过 HTTP 导入公开媒体 URL。持续检查导入直到就绪，再一起使用已登记素材 ID 与标准 URL。已接受的导入仍在进行中。

- [MCP 工具参考](https://sosoapi.ai/zh-hans/docs/mcp)

## 速率与套餐限制为何？

请查看每个 schema 的字段、列表和分页限制。studio-api 对人工会话允许每位用户每分钟 240 个请求；该用户的机器凭证另有每分钟 480 个请求的独立配额桶。请遵循 429 和 Retry-After。套餐配额、平台限制和账号资格相互独立；大批量执行前请读取当前计费和能力信息。

- [发布 API 限制](https://sosoapi.ai/zh-hans/docs/publishing-api-reference)

## Markdown 和 schema 在哪里？

在指南、API 操作或 MCP 工具 URL 后加入 .md，即可获取 Markdown 版本。API 索引链接至公开 JSON 契约与 OpenAPI 3.1 文件。页面索引请从 llms.txt 开始，两种语言的完整参考请使用 llms-full.txt。这些文件包含公开文件，不含账号资料或凭证。

- [完整 API 参考](https://sosoapi.ai/zh-hans/docs/api)

- [LLM 索引](https://sosoapi.ai/zh-hans/llms.txt)

## 这些文档保证获得搜索收录或 AI 引用吗？

不保证。HTML 页面、规范 URL、结构化元数据和 Markdown 有助于系统读取文档。搜索引擎和 AI 服务仍自行决定收录、排名或引用哪些内容。请将这些结果与页面是否可访问分开检查。