跳转到内容
API 码头

一行命令验证连通

拿到 API Key 之后，最快的验证方式就是用 curl 直接发一个请求。API 码头同时兼容 OpenAI Chat Completions 与 Anthropic Messages 两种协议，下面分别给出验证示例。

把示例中的 sk-xxxxx 替换成你在 创建令牌 中拿到的真实 API Key 即可。

OpenAI 协议（/v1/chat/completions）

Section titled “OpenAI 协议（/v1/chat/completions）”

适用于 OpenAI 全系模型（如 gpt-5.5）以及通过 OpenAI 兼容接口调用的其他模型：

Terminal window
curl https://apimatou.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{ "role": "user", "content": "你是谁？" }]
  }'

Anthropic 协议（/v1/messages）

Section titled “Anthropic 协议（/v1/messages）”

适用于 Claude 全系模型。注意：API 码头的 Anthropic 兼容端点同样使用 Authorization: Bearer 鉴权（不是 x-api-key），因为请求是经过中转的：

Terminal window
curl https://apimatou.cc/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{ "role": "user", "content": "你是谁？" }]
  }'

Anthropic 协议要求请求体携带 max_tokens 字段，未提供会直接报错，这是与 OpenAI 协议最容易被忽略的差异。

验证流式响应

Section titled “验证流式响应”

把请求体里加上 "stream": true 即可拿到 SSE 流式输出：

Terminal window
curl https://apimatou.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [{ "role": "user", "content": "用三句话介绍你自己" }]
  }'

终端会持续输出形如 data: {...} 的事件块，直到流结束。

常见报错

Section titled “常见报错”
报错HTTP 状态码原因与解决
invalid_api_key / Unauthorized401API Key 错误、被禁用或已过期。检查 Authorization: Bearer sk-xxxxx 格式是否正确，令牌是否仍在有效期
余额不足 / insufficient_quota402账户余额或令牌额度已耗尽。前往控制台充值或调高令牌额度上限
模型不存在 / model not found404模型名拼写错误，或当前令牌分组不支持该模型。前往模型广场核对模型名与可用分组
无可用渠道503模型源临时不可用。稍后重试或联系客服

更完整的报错排查清单参见 FAQ。

下一步

Section titled “下一步”

curl 验证通过之后，根据你的接入方式继续：