Messages 格式

使用 Anthropic Claude 官方 Messages API 格式创建消息响应。

该接口仅支持 Claude 模型。请不要把 OpenAI、DeepSeek 或其他非 Claude 模型放到此接口。

Try It

POST/v1/messageshttps://api.ope.ai

认证

使用平台 API Key 认证。

• Header：Authorization: Bearer <api-key>
• 示例：Authorization: Bearer sk-xxxxxx

可按 Claude 官方格式传入 anthropic-version 请求头，例如 2023-06-01。

请求体（application/json）

字段	类型	必填	说明
model	string	是	Claude 模型 ID
max_tokens	integer	是	生成的最大 token 数
messages	array	是	对话消息列表
system	string | array	否	系统提示词
stop_sequences	string[]	否	自定义停止序列
stream	boolean	否	是否使用 SSE 流式响应
temperature	number	否	采样温度
top_p	number	否	nucleus sampling 参数
top_k	integer	否	top-k 采样参数
tools	array	否	Claude 官方工具定义数组
tool_choice	object	否	工具选择策略
thinking	object	否	扩展思考配置
metadata	object	否	元数据

messages

字段	类型	必填	说明
role	string	是	user 或 assistant
content	string | array	是	文本内容，或 Claude 官方 content block 数组

请求示例

cURL

curl -X POST "https://api.ope.ai/v1/messages" \
  -H "Authorization: Bearer $OPEAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

JavaScript

const res = await fetch("https://api.ope.ai/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OPEAI_API_KEY}`,
    "anthropic-version": "2023-06-01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-5",
    max_tokens: 1024,
    messages: [{role: "user", content: "Hello, Claude"}],
  }),
});

console.log(await res.json());

Python

import os
import requests

resp = requests.post(
    "https://api.ope.ai/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}",
        "anthropic-version": "2023-06-01",
    },
    json={
        "model": "claude-sonnet-4-5",
        "max_tokens": 1024,
        "messages": [{"role": "user", "content": "Hello, Claude"}],
    },
    timeout=60,
)

print(resp.json())

响应示例

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "model": "claude-sonnet-4-5",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 6
  }
}

官方参考：Claude Messages API