51API

主题

cURL 调用示例 ​

本页面提供使用 cURL 命令行工具调用 51API 的完整示例。

适用场景

  • 快速测试 API 是否正常
  • 在 Shell 脚本中调用 AI
  • 不想安装任何 SDK
  • 调试和排查问题

基础信息 ​

配置项值
Base URLhttps://www.51api.org/v1
鉴权方式Authorization: Bearer <API Key>
请求格式application/json

基础对话 ​

最简单的请求 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

带系统提示词 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个专业的翻译助手，请将用户的输入翻译成英文。"},
      {"role": "user", "content": "今天天气真好"}
    ]
  }'

响应示例 ​

json
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o-2024-08-06",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮助你的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式输出 ​

添加 "stream": true 参数，实现实时输出。

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "讲一个简短的故事"}],
    "stream": true
  }'

流式响应格式 ​

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"从"}}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"前"}}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"有"}}]}

data: [DONE]

常用参数 ​

控制输出长度 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "写一首诗"}],
    "max_tokens": 100
  }'

控制随机性 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "给我一个创意点子"}],
    "temperature": 1.5
  }'
temperature 值效果
0最确定，适合事实性问答
0.7默认，平衡创意和准确性
1.5-2更随机，适合创意写作

多轮对话 ​

将之前的对话历史放入 messages 数组：

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "我叫小明"},
      {"role": "assistant", "content": "你好小明！很高兴认识你。"},
      {"role": "user", "content": "我刚才说我叫什么？"}
    ]
  }'

图片分析 ​

使用图片 URL ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "这张图片里有什么？"},
          {
            "type": "image_url",
            "image_url": {"url": "https://example.com/image.jpg"}
          }
        ]
      }
    ],
    "max_tokens": 300
  }'

使用 Base64 图片 ​

bash
# 先将图片转换为 base64
BASE64_IMAGE=$(base64 -i image.jpg)

curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d "{
    \"model\": \"gpt-4o\",
    \"messages\": [
      {
        \"role\": \"user\",
        \"content\": [
          {\"type\": \"text\", \"text\": \"描述这张图片\"},
          {
            \"type\": \"image_url\",
            \"image_url\": {\"url\": \"data:image/jpeg;base64,${BASE64_IMAGE}\"}
          }
        ]
      }
    ],
    \"max_tokens\": 300
  }"

函数调用 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "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"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }'

使用不同模型 ​

Claude 模型 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

Gemini 模型 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

Grok 模型 ​

bash
curl https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "grok-4",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

Shell 脚本示例 ​

简单的聊天脚本 ​

bash
#!/bin/bash

API_KEY="sk-你的密钥"
API_URL="https://www.51api.org/v1/chat/completions"

chat() {
    local message="$1"
    local model="${2:-gpt-4o}"

    curl -s "$API_URL" \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $API_KEY" \
        -d "{
            \"model\": \"$model\",
            \"messages\": [{\"role\": \"user\", \"content\": \"$message\"}]
        }" | jq -r '.choices[0].message.content'
}

# 使用示例
echo "AI: $(chat '你好！')"
echo "AI: $(chat '1+1等于几？' 'gemini-2.5-flash')"

交互式聊天脚本 ​

bash
#!/bin/bash

API_KEY="sk-你的密钥"
API_URL="https://www.51api.org/v1/chat/completions"

echo "51API 聊天助手 (输入 'quit' 退出)"
echo "================================"

while true; do
    read -p "你: " user_input

    if [ "$user_input" = "quit" ]; then
        echo "再见！"
        break
    fi

    response=$(curl -s "$API_URL" \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $API_KEY" \
        -d "{
            \"model\": \"gpt-4o\",
            \"messages\": [{\"role\": \"user\", \"content\": \"$user_input\"}]
        }" | jq -r '.choices[0].message.content')

    echo "AI: $response"
    echo ""
done

调试技巧 ​

查看完整响应 ​

添加 -v 参数查看详细信息：

bash
curl -v https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}'

格式化 JSON 输出 ​

使用 jq 工具格式化输出：

bash
curl -s https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}' \
  | jq .

只提取回复内容 ​

bash
curl -s https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}' \
  | jq -r '.choices[0].message.content'

查看 Token 消耗 ​

bash
curl -s https://www.51api.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}' \
  | jq '.usage'

常见错误 ​

404 Not Found ​

bash
# ❌ 错误：缺少 /v1
curl https://www.51api.org/chat/completions ...

# ✅ 正确：包含 /v1
curl https://www.51api.org/v1/chat/completions ...

401 Unauthorized ​

bash
# ❌ 错误：API Key 格式错误
-H "Authorization: sk-xxx"

# ✅ 正确：需要 Bearer 前缀
-H "Authorization: Bearer sk-xxx"

JSON 解析错误 ​

bash
# ❌ 错误：使用单引号包裹 JSON 中的字符串
-d "{'model': 'gpt-4o'}"

# ✅ 正确：使用双引号
-d '{"model": "gpt-4o"}'

更多示例 ​

51API - 您的 AI 能力聚合平台

Copyright © 2024-2025 51API