21. 常见问题 FAQ#

Q：我现有的 OpenAI 代码需要改多少？ A：通常只改 baseURL 和 apiKey 两处，其余请求参数保持不变。

Q：可以直接用 OpenAI 官方 SDK 吗？ A：可以。所有主流语言的 OpenAI SDK 都支持自定义 baseURL，指向 http://183.240.79.21:52099/v1 即可。

Q：Claude / Gemini 等非 OpenAI 模型怎么调用？ A：推荐统一走 /v1/chat/completions，把 model 换成对应模型名即可，无需切换协议。若必须用 Anthropic 原生协议，可走 /v1/messages（不支持函数调用 / 多模态）。

Q：如何知道当前 Key 能用哪些模型？ A：调用 GET /v1/models，返回的即为当前有权访问的模型列表。

Q：调用报 404 怎么办？ A：优先确认路径为单 /v1（如 /v1/chat/completions，而非 /v1/v1/...）；再确认模型名拼写正确且在 GET /v1/models 返回列表中。

Q：流式返回如何判断结束？ A：OpenAI 端点的 SSE 流以 data: [DONE] 作为结束标记；/v1/messages 端点返回 Anthropic 形状的 SSE 事件序列。

Q：视频 / 绘图任务要等多久？ A：属异步任务，提交后用返回的 id 轮询 /v1/tasks/{id}，直到状态变为完成。

Q：忘记保存 API Key 明文了怎么办？ A：出于安全，明文仅创建时展示一次且不可找回。请在控制台吊销旧 Key 并重新创建。

本文档中的域名 http://183.240.79.21:52099 为占位地址，正式上线后请替换为实际服务域名。 本地开发环境 Base URL 为 http://183.240.79.21:52099/v1。