跳转到内容
零派智能文档 零派智能文档
返回主站

FAQ

以下是使用 零派智能API 过程中最常见的问题及解答。

如何更换模型？

在请求的 model 参数中指定模型名称即可。通过 /v1/models 接口查看所有可用模型：

Terminal window
curl "$BASE_URL/v1/models" -H "Authorization: Bearer $API_KEY"

切换模型只需修改 model 字段：

# 使用 GPT-4o
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)


# 切换为 Claude
response = client.chat.completions.create(
    model="claude-3-5-sonnet-20241022",
    messages=[{"role": "user", "content": "Hello"}]
)

不同模型支持的参数可能有所不同，切换前请确认目标模型的特性。

是否支持流式响应？

支持。在请求中设置 "stream": true 即可启用流式响应：

Terminal window
curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
    stream=True,
)


for chunk in response:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

流式响应适用于需要实时展示生成内容的场景，如聊天界面。

是否支持函数调用（Function Calling）？

支持。OpenAI 兼容的模型支持 Function Calling 功能：

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "北京天气怎么样？"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "获取指定城市的天气",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string", "description": "城市名称"}
                },
                "required": ["city"]
            }
        }
    }],
)


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

Function Calling 的支持程度取决于具体模型，部分模型可能不完全支持此功能。

如何查看用量？

  1. 通过管理后台查看：登录管理后台，在 用量统计 或 日志 页面查看详细的调用记录和用量统计。

  2. 通过 API 查看：部分版本的 零派智能API 提供用量查询接口，可以通过 API 获取用量数据。

  3. 通过响应头查看：每次 API 响应中通常会包含 token 使用量信息：

{
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

能否同时使用多个模型？

可以。零派智能API 支持在一个应用中调用多个不同的模型。只需在每次请求中指定不同的 model 参数即可：

# 同时调用多个模型进行对比
models = ["gpt-4o", "claude-3-5-sonnet-20241022", "gemini-2.0-flash"]


for model in models:
    response = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "你好"}],
    )
    print(f"{model}: {response.choices[0].message.content}")

使用多个模型时请注意各自的定价和额度限制。

数据是否安全？

零派智能API 在数据安全方面采取以下措施：

  • 传输加密：所有 API 请求通过 HTTPS 加密传输
  • Key 管理：API Key 支持设置 IP 白名单和使用范围限制
  • 日志策略：可根据需求配置是否记录请求日志

建议遵循安全最佳实践：不要将 Key 硬编码在代码中、定期轮换 Key、为不同环境使用不同的 Key。

请求被限流了怎么办？

遇到 429 Rate Limit 错误时，可以采取以下措施：

  • 降低请求频率，在请求间添加延迟
  • 实现指数退避重试机制
  • 控制并发请求数量
  • 升级套餐以获得更高的限流配额

详见 429 Rate Limit 排查文档。

如何获取 API Key 和 Base URL？

  1. API Key：注册并登录后，在管理后台的 API Key 管理 页面创建新的 Key
  2. Base URL：在管理后台首页或设置页面查看，格式通常为 https://你的域名/v1

详见 获取 API Key 和 获取 Base URL 文档。

支持哪些编程语言？

零派智能API 兼容 OpenAI API 格式，任何支持 HTTP 请求的编程语言都可以使用。同时，所有兼容 OpenAI SDK 的语言都可以直接接入：

  • Python：使用 openai 库
  • JavaScript / TypeScript：使用 openai 库
  • Go：使用 HTTP 库或 OpenAI 兼容库
  • Java：使用 HTTP 库或 OpenAI 兼容库
  • C#：使用 HTTP 库或 OpenAI 兼容库
  • cURL：直接发送 HTTP 请求

详见各语言的实例

支持哪些 AI 模型提供商？

零派智能API 支持多种模型提供商，包括但不限于：

  • OpenAI：GPT-4o、o1 等
  • Anthropic：Claude 系列
  • Google：Gemini 系列
  • GLM：GLM5.2、GLM5.3
  • deepseek：DeepSeek-V4-Flash、DeepSeek-V4-Pro
  • Qwen：Qwen3.7-Plus、Qwen3.7-MAX

部分模型由于需求量低并未上架，如有任何模型需求请联系管理员增加。

通过 /v1/models 接口可以查看当前可用的完整模型列表。