cURL

cURL 是最直接的 API 调试工具，适合快速验证接口是否可用。几乎所有操作系统都自带 cURL，无需安装额外依赖。

环境变量设置

在发送请求前，先将 API Key、Base URL 和模型名称设置为环境变量：

export API_KEY="sk-your-api-key"
export BASE_URL="https://your-domain.com/v1"
export MODEL="gpt-4o"

将上述值替换为你在 零派智能 平台获取的真实信息。建议将 export 命令写入 ~/.bashrc 或 ~/.zshrc 中，避免每次重复输入。

基本请求示例

发送一个普通的 Chat Completions 请求：

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍你自己。"
      }
    ]
  }'

请求成功后，你将收到类似以下的 JSON 响应：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是一个 AI 助手。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式请求

添加 "stream": true 参数即可启用流式响应，逐字返回内容：

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "写一首关于秋天的诗"
      }
    ],
    "stream": true
  }'

流式响应以 data: 前缀的 Server-Sent Events (SSE) 格式逐行返回，最后一行为 data: [DONE]。

查看模型列表

调用 /v1/models 接口查看当前可用的模型：

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

完整可复制示例

以下是一个完整脚本，包含环境变量设置和一次流式请求：

#!/bin/bash

# —— 配置 —— #
export API_KEY="sk-your-api-key"
export BASE_URL="https://your-domain.com/v1"
export MODEL="gpt-4o"

# —— 发送流式请求 —— #
curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$MODEL"'",
    "messages": [
      {
        "role": "system",
        "content": "你是一个有帮助的助手。"
      },
      {
        "role": "user",
        "content": "用三句话解释量子计算。"
      }
    ],
    "stream": true
  }'

将上述内容保存为 request.sh，执行 chmod +x request.sh && ./request.sh 即可运行。