VoxAPI API文档

接口地址

支持模型

• DeepSeek-v4系列
• GPT系列
• Claude系列
• Gemini系列

计费说明

认证方式

Authorization: Bearer sk-xxxx
Content-Type：application/json

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxx",
    base_url="https://api.voxapi.cn/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role":"user","content":"你好"}
    ]
)

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

GPT 示例

curl https://api.voxapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Claude 示例

curl https://api.voxapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Gemini 示例

curl https://api.voxapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Cherry Studio 配置教程

客户端：Cherry Studio

类型：OpenAI 兼容

Base URL：
https://api.voxapi.cn

API Key：
填写你自己的 sk 密钥

模型：
deepseek-v4-flash
gpt-5.5
claude-opus-4-8
gemini-3.5

推荐安全设置/客户端参数

首次使用建议关闭高级参数：

Temperature：关闭
Top P：关闭
Frequency Penalty：关闭
Presence Penalty：关闭
图片地址：关闭
流式输出：关闭

Max Tokens：512 或 1024

如果使用 Claude / Gemini 报参数错误，请先关闭所有高级参数后重试。

API 调用示例

cURL

curl https://api.voxapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.voxapi.cn/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

print(response.choices[0].message.content）

成功返回示例

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮助你的吗？"
      }
    }
  ]
}

如果返回内容中包含 choices 和 assistant 回复，说明 API 调用成功。

常见问题排查