Claude 官方原生格式

提示

Claude模型同时支持OpenAI请求格式与官方请求格式。
官方请求格式只列出常用参数，更详细的请求参数请阅读 claude官方文档

走OpenAI格式将不会计算缓存，走官方格式会完全走缓存计费方式。官方缓存使用与说明

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

model

string

模型名称

必需

messages

array [object {2}]

必需

role

string

角色 user

必需

content

string

提问消息

必需

temperature

number

温度

可选

使用什么采样温度，介于 0 和 2 之间。较高的值（如 0.8）将使输出更加随机，而较低的值（如 0.2）将使输出更加集中和确定。我们通常建议改变这个或top_p但不是两者同时使用。

top_p

number

可选

一种替代温度采样的方法，称为核采样，其中模型考虑具有 top_p 概率质量的标记的结果。所以 0.1 意味着只考虑构成前 10% 概率质量的标记。我们通常建议改变这个或temperature但不是两者同时使用。

max_tokens

number

最大回复

可选

聊天完成时生成的最大Tokens数量。输入标记和生成标记的总长度受模型上下文长度的限制。

stream

boolean

流式输出

可选

流式输出或非流式输出

top_k

integer

可选

tools

object

函数调用

可选

tools函数详细参数与用法，请阅读官方文档

thinking

object

开启思考

可选

该参数仅支持模型claude-3-7-sonnet-20250219
设置后ai回复将会先思考再回复。

type

string

类型

必需

值必须为 "enabled"

默认值:

enabled

budget_tokens

integer

最大思考

必需

最大思考tokens，必须大于1024，同时 max_tokens参数必须大于此处的值。

>= 1024

示例

{
  "model": "claude-3-5-sonnet-20240620",
  "messages": [
    {
      "role": "user",
      "content": "你好，你是？"
    }
  ],
  "max_tokens": 1688,
  "temperature": 0.5,
  "stream": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

string

必需

type

string

必需

role

string

必需

content

array [object {2}]

必需

type

string

可选

text

string

可选

model

string

必需

stop_reason

string

必需

stop_sequence

null

必需

usage

object

必需

input_tokens

integer

必需

output_tokens

integer

必需

示例

{
  "id": "msg_014AoBefsejHUjbdRntn7euw",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好!很高兴见到你。今天过得怎么样?有什么我可以帮助你的吗?"
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 38
  }
}