Voook API 接入文档

Voook 同时提供 OpenAI 兼容接口与 Claude Messages API。使用控制台创建的同一个 API 令牌，即可按客户端支持的协议接入可用模型。

接口地址

OpenAI 兼容 SDK 使用以下 Base URL：

Claude SDK 使用 https://ai.aigcbbs.dpdns.org 作为 Base URL；直接发送 HTTP 请求时使用完整地址 https://ai.aigcbbs.dpdns.org/v1/messages。

身份验证

登录控制台，在「令牌」页面创建 API 令牌。两种接口使用同一个令牌，但请求头格式不同：

Authorization: Bearer YOUR_API_KEY

以上格式用于 OpenAI 兼容接口。Claude Messages API 使用 x-api-key: YOUR_API_KEY，并需携带 anthropic-version: 2023-06-01；Claude SDK 会自动设置这些请求头。

API 令牌等同于账户凭证。请勿公开分享或提交到公开代码仓库；怀疑泄露时请立即在控制台撤销并重新创建。

查看可用模型

调用模型列表接口查看当前令牌可用的模型，再将返回的模型名称用于请求。

curl https://ai.aigcbbs.dpdns.org/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

可用模型以接口返回和控制台显示为准。

OpenAI 兼容接口

适用于 OpenAI SDK 以及支持 OpenAI 兼容格式的客户端。请求体中的模型名称应来自可用模型列表。

curl https://ai.aigcbbs.dpdns.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Python SDK 示例

安装 SDK：pip install openai。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://ai.aigcbbs.dpdns.org/v1",
)

result = client.chat.completions.create(
    model="MODEL_NAME",
    messages=[{"role": "user", "content": "你好"}],
)

print(result.choices[0].message.content)

Claude Messages API

使用 Claude SDK 时，Base URL 填写 https://ai.aigcbbs.dpdns.org；SDK 会请求 /v1/messages。请求体中的模型名称请使用控制台或模型列表中可用的名称。

Python SDK 示例

安装 SDK：pip install anthropic。

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://ai.aigcbbs.dpdns.org",
)

message = client.messages.create(
    model="MODEL_NAME",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)

print(message.content[0].text)

HTTP 示例

curl https://ai.aigcbbs.dpdns.org/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

额度与计费

模型可用范围、分组和价格以账户控制台实时显示为准。API 调用按账户额度扣减；使用前请确认账户额度及对应模型价格。

问题排查

认证失败

检查令牌是否有效，以及对应协议的请求头和 Base URL：OpenAI 兼容接口使用 Authorization: Bearer YOUR_API_KEY 和 https://ai.aigcbbs.dpdns.org/v1；Claude 使用 x-api-key、anthropic-version 和 https://ai.aigcbbs.dpdns.org。

模型不可用或额度不足

重新查询 GET /v1/models，核对模型名称、账户分组与可用额度。具体原因以接口返回的错误信息和控制台状态为准。