Skip to main content
POST
/
v1
/
messages
创建消息
curl --request POST \
  --url https://api.tokenops.ai/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <api-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下你自己"
    }
  ]
}
'
{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好！我是Claude，一个由Anthropic开发的AI助手。"
    }
  ],
  "model": "claude-3-5-sonnet-20241022",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 25,
    "output_tokens": 18
  }
}

Authorizations

​
x-api-key
string
header
required

Claude API密钥认证。在 x-api-key HTTP Header 中包含您的 API-Key

​
anthropic-version
string
header
required

Claude API版本号，必需的Header，例如：2023-06-01

Body

application/json
​
model
enum<string>
required

要使用的模型ID

Available options:
claude-3-5-sonnet-20241022,
claude-3-5-haiku-20241022,
claude-3-opus-20240229,
claude-3-sonnet-20240229,
claude-3-haiku-20240307
Example:

"claude-3-5-sonnet-20241022"

​
max_tokens
integer
required

生成的最大token数量

Required range: 1 <= x <= 8192
Example:

1024

​
messages
object[]
required

输入消息列表

Minimum array length: 1
Example:
[
  { "role": "user", "content": "你好，请介绍一下你自己" }
]
​
metadata
object

用于标识和跟踪对话的可选元数据

​
stop_sequences
string[]

自定义文本序列，当模型生成这些序列时将停止生成

Maximum array length: 4
​
stream
boolean
default:false

是否以服务器发送事件(SSE)的形式增量流式传输响应

​
system

系统提示，用于指导Claude的行为

​
temperature
number
default:1

采样温度，控制随机性

Required range: 0 <= x <= 1
​
tool_choice

控制模型如何使用提供的工具

​
tools
object[]

Claude可以使用的工具列表

​
top_k
integer

仅从每个后续token的前K个选项中采样

Required range: x >= 1
​
top_p
number

使用核采样，仅从累积概率达到此值的token中采样

Required range: 0 <= x <= 1

Response

消息创建成功

​
id
string
required

消息的唯一标识符

Example:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

​
type
enum<string>
required

对象类型

Available options:
message
Example:

"message"

​
role
enum<string>
required

对话角色

Available options:
assistant
Example:

"assistant"

​
content
object[]
required

消息内容

Example:
[
  {
    "type": "text",
    "text": "你好！我是Claude，一个由Anthropic开发的AI助手。"
  }
]
​
model
string
required

使用的模型

Example:

"claude-3-5-sonnet-20241022"

​
stop_reason
enum<string>
required

停止生成的原因

Available options:
end_turn,
max_tokens,
stop_sequence,
tool_use
​
stop_sequence
string | null
required

导致停止的序列（如果适用）

​
usage
object
required

使用情况统计