# 其他客户端接入指南

## 基础信息

对于可自定义 provider 的客户端（如 OpenClaw、LobeChat、NextChat、LibreChat 等），按其配置格式填入下列字段即可。

- Base URL：`https://api.apiverse.ai/v1`
- API Key：`<API_KEY>`
- 鉴权头：`Authorization: Bearer <API_KEY>`
- 可选协议：`anthropic-messages` / `openai-completions` / `google-generative-ai`

## JSON 配置示例

以支持多 provider JSON 配置的客户端为例：

```json
{
    "models": {
        "mode": "replace",
        "providers": {
            "fcgw": {
                "baseUrl": "https://api.apiverse.ai/v1",
                "apiKey": "<API_KEY>",
                "auth": "token",
                "api": "anthropic-messages",
                "headers": {
                    "Authorization": "Bearer <API_KEY>"
                },
                "authHeader": true,
                "models": [
                    {
                        "id": "global.anthropic.claude-sonnet-5",
                        "name": "global.anthropic.claude-sonnet-5",
                        "api": "anthropic-messages",
                        "reasoning": true,
                        "input": ["text"],
                        "contextWindow": 500000,
                        "maxTokens": 8192,
                        "compat": { "maxTokensField": "max_tokens" }
                    },
                    {
                        "id": "gemini-3-flash-preview",
                        "name": "gemini-3-flash-preview",
                        "api": "google-generative-ai",
                        "reasoning": false,
                        "input": ["text", "image"],
                        "contextWindow": 500000,
                        "maxTokens": 32000,
                        "compat": { "maxTokensField": "max_tokens" }
                    },
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4",
                        "api": "openai-completions",
                        "reasoning": true,
                        "input": ["text"],
                        "contextWindow": 200000,
                        "maxTokens": 32768,
                        "compat": { "maxTokensField": "max_completion_tokens" }
                    },
                    {
                        "id": "deepseek-v4-pro",
                        "name": "deepseek-v4-pro",
                        "api": "openai-completions",
                        "reasoning": true,
                        "input": ["text"],
                        "contextWindow": 200000,
                        "maxTokens": 32768,
                        "compat": { "maxTokensField": "max_tokens" }
                    }
                ]
            }
        }
    }
}
```

## 常见问题

| 现象 | 排查方向 |
| ---- | -------- |
| 返回 403 未开通 LLM 能力 | 在控制台重新创建并开通「大模型」能力的 API Key |
| 模型返回 503 / 排队 | 换用同系列其他模型，或联系技术支持 |
| 返回 666 | 复制响应体 `code_reason` 联系技术支持 |