4.1 自检命令与网络探活

本节目标：学会使用终端命令（cURL、Python、Node.js）进行连通性自检，一秒定位网络或 Key 权限问题。

当您在 Cursor、Claude Code 或其他软件中遇到报错、卡顿或无响应时，最有效的第一反应不是盲目重装软件，而是在终端直接运行一条自检命令，直接观察服务器返回的状态码与 JSON 数据。

---

一、cURL 极速自检命令

直接复制以下命令至您的终端（macOS Terminal、Linux Shell 或 Windows PowerShell/Git Bash），将其中的 sk-您的实际Key 替换为您在控制台创建的 Key：

1. OpenAI 协议自检 (DeepSeek)

curl https://hk.azy6.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-您的实际Key" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好，这是一次测试！"}],
    "stream": false
  }'

✅ 正常返回示例：

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "created": 1726000000,
  "model": "deepseek-chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！很高兴为您服务。请问有什么我可以帮您的？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 15,
    "total_tokens": 27
  }
}

如果能正常看到上述回复，说明 网络、域名解析、Key 鉴权、上游模型全部 100% 正常。此时客户端若报错，必然是客户端内部填写的路径或模型名有误。

---

2. Anthropic 原生协议自检 (Claude)

curl https://hk.azy6.cc/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-您的实际Key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-7-sonnet",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

---

二、Python 快速测试脚本

如果您使用 Python 进行自动化脚本开发，可使用官方 openai 库自测：

from openai import OpenAI

client = OpenAI(
    api_key="sk-您的实际Key",
    base_url="https://hk.azy6.cc/v1"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "测试连接"}],
    stream=True
)

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

---

三、网络延迟诊断 (Ping 与 Traceroute)

艾智云香港节点面向全网提供极速回源，您可以在终端测试网络往返延迟：

# 测试国内香港专线延迟
ping -c 4 hk.azy6.cc

# 测试全球主线延迟
ping -c 4 azy6.cc

正常情况下，国内沿海省份 ping 香港专线通常在 20ms ~ 35ms 之间，内陆省份在 35ms ~ 60ms 之间。

---

下一步：遇到非 200 状态码？查看完整错误码字典 → 4.2 常见错误码字典