其他客户端与通用配置

只要客户端支持 OpenAI、Anthropic 或 Gemini 的自定义 Base URL，通常都可以接入 Zivv。先确认客户端使用哪种协议，再填写对应地址。

协议参数速查

协议	Base URL	认证方式	典型端点
OpenAI	https://zivv.pro/v1	Authorization: Bearer sk-...	/chat/completions、/responses
Anthropic	https://zivv.pro	x-api-key: sk-...	/v1/messages
Gemini	https://zivv.pro/v1beta	x-goog-api-key: sk-...	/models/{model}:generateContent

不确定如何选择时，先看 选择接入方式 和 协议与兼容性。

通用接入步骤

1. 在 令牌管理 创建客户端专用 Key。
2. 在 模型广场 复制模型 ID。
3. 在客户端中选择原生协议或 Compatible Provider。
4. 填写 Base URL、API Key 和模型 ID。
5. 完全重启客户端，发送“只回复 pong”验证。
6. 在 用量日志 核对请求。

常见环境变量

不同工具读取的变量不同。只设置客户端文档明确支持的变量，不要一次性配置所有变量。

OpenAI 兼容

export OPENAI_API_KEY="sk-你的Key"
export OPENAI_BASE_URL="https://zivv.pro/v1"

Anthropic

export ANTHROPIC_API_KEY="sk-你的Key"
export ANTHROPIC_BASE_URL="https://zivv.pro"

Gemini

export GEMINI_API_KEY="sk-你的Key"
export GOOGLE_GEMINI_BASE_URL="https://zivv.pro/v1beta"

变量名以客户端为准

有些客户端使用 OPENAI_API_BASE、ANTHROPIC_AUTH_TOKEN 或自己的配置字段。变量名错误时，即使 Key 和地址正确也不会生效。

OpenAI 兼容客户端

适合大多数聊天客户端、编辑器插件、自动化工具和 OpenAI SDK 封装：

Base URL: https://zivv.pro/v1
API Key:  sk-你的Key
Model:    模型广场中的模型 ID

如果客户端要求填写完整 URL：

• Chat Completions：https://zivv.pro/v1/chat/completions
• Responses API：https://zivv.pro/v1/responses
• 模型列表：https://zivv.pro/v1/models

多数客户端只需要 Base URL，不要误填完整端点。

Anthropic 原生客户端

适合支持 Claude / Messages API 的工具：

Base URL: https://zivv.pro
API Key:  sk-你的Key

客户端应向 /v1/messages 发起请求，并携带 x-api-key 和 anthropic-version。如果配置项明确叫 Anthropic Base URL，通常不要在末尾追加 /v1。

Gemini 原生客户端

适合 Google Gen AI SDK 或支持 Gemini 原生 REST 格式的工具：

Base URL: https://zivv.pro/v1beta
API Key:  sk-你的Key

模型名通常位于 URL 中，例如：

POST /v1beta/models/{model}:generateContent

cURL 连通性测试

在排查客户端前，先用最小请求确认 Key、模型和网络都正常。

OpenAI

curl https://zivv.pro/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型广场中的模型 ID",
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

Anthropic

curl https://zivv.pro/v1/messages \
  -H "x-api-key: sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型广场中的模型 ID",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

Gemini

curl "https://zivv.pro/v1beta/models/模型ID:generateContent" \
  -H "x-goog-api-key: sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "只回复 pong"}]}]
  }'

排查顺序

1. 先测网络：能否访问 https://zivv.pro/v1/models。
2. 再测 Key：是否返回 401，Key 是否过期或禁用。
3. 再测模型：模型 ID 和 Key 分组是否匹配。
4. 再看路径：是否重复拼接 /v1 或填写了完整端点。
5. 最后看客户端能力：是否支持所需协议、流式输出、工具调用或视觉输入。

更多状态码说明见 错误码。

安全与用量

• 不同工具使用不同 Key，便于按客户端审计
• 本地测试 Key 设置额度和有效期
• 不要把 Key 写入仓库、公开日志或截图
• 为批处理设置并发上限，遇到 429 使用退避重试
• 团队使用时为成员设置子预算和团队 RPM

详见 API Key 管理与安全 与 用量、额度与限流。