Skip to content

Anthropic Messages

Claude Messages 兼容接口,适合 Anthropic SDK、Claude 原生协议工具和长上下文对话。

接口信息

项目
方法POST
路径/v1/messages
完整地址https://api.gemai.cc/v1/messages
常用鉴权x-api-key: sk-你的令牌
协议版本anthropic-version: 2023-06-01

请求体示例

json
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "你是一个有帮助的助手。",
  "messages": [
    {
      "role": "user",
      "content": "请用一句话介绍 Claude Messages 格式。"
    }
  ]
}

代码示例

bash
curl --location 'https://api.gemai.cc/v1/messages' \
  --header "x-api-key: $GEMAI_API_KEY" \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "请写一句欢迎语。" }
    ]
  }'
javascript
const response = await fetch('https://api.gemai.cc/v1/messages', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.GEMAI_API_KEY,
    'anthropic-version': '2023-06-01',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'claude-sonnet-4-6',
    max_tokens: 1024,
    messages: [
      { role: 'user', content: '请写一句欢迎语。' },
    ],
  }),
})

console.log(await response.json())
python
import os
import requests

response = requests.post(
    'https://api.gemai.cc/v1/messages',
    headers={
        'x-api-key': os.environ['GEMAI_API_KEY'],
        'anthropic-version': '2023-06-01',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'claude-sonnet-4-6',
        'max_tokens': 1024,
        'messages': [
            {'role': 'user', 'content': '请写一句欢迎语。'},
        ],
    },
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例

json
{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "欢迎使用哈基米 API。"
    }
  ],
  "stop_reason": "end_turn"
}

注意事项

  • Anthropic 原生格式一般使用 x-api-key,不是 OpenAI 的 Authorization
  • 长上下文和缓存 tokens 的统计方式与 OpenAI 格式不同。