外挂仔 API 开发者指南

完全兼容 OpenAI 接口协议。只需修改两行代码，即可实现一键无缝接入全球大模型。

1. 基础配置与鉴权

2. Python 生产级接入 (推荐)

强烈建议配置 timeout 和 max_retries 以防止网络波动导致本地进程卡死。

from openai import OpenAI

client = OpenAI(
  api_key="sk-your-api-key-here",
  base_url="https://api.waiguazai.com/v1",
  timeout=30.0, # 防卡死：30秒超时机制
  max_retries=3 # 智能回退：失败自动重试3次
)

response = client.chat.completions.create(
  model="gpt-5",
  messages=[{"role": "user", "content": "写一个快排"}],
)
print(response.choices.message.content)

3. 接入 VSCode Claude Code 插件

在 VSCode 设置 (settings.json) 中加入以下环境变量，重启后即可使用 Claude 4.7 等模型辅助编程：

"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "sk-在此处填入您的API密钥"
  },
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://api.waiguazai.com"
  },
  {
    "name": "ANTHROPIC_MODEL",
    "value": "claude-sonnet-4-6"
  }
]

常见问题排查 (Troubleshooting)

Q: 报错 429 Too Many Requests 怎么解决？

此错误代表触发了并发速率限制（RPM）。我们在企业级网关中内置了多节点调度，如果您跑高频批量任务遇到此错，请在代码中加入指数退避重试，或联系客服提升默认并发额度。

Q: 使用 Function Calling 报错 400 parameters 格式错误？

部分老旧开源工具会将 parameters 对象错误序列化为字符串。我们的网关已修复此兼容性问题，请确保您的工具定义（Tools JSON）严格遵守 OpenAI 最新规范即可正常调用。