Claude 对话接入

Anthropic Claude 系列模型，支持 OpenAI 兼容格式 与 Anthropic 原生格式 两种调用方式。

支持模型

模型	定位
claude-opus-5	最新旗舰，推理能力最强
claude-opus-4-8	Opus 4.8
claude-sonnet-5	最新 Sonnet，性能与速度平衡
claude-sonnet-4-6	Sonnet 4.6
claude-sonnet-4-6-thinking	带思考过程输出
claude-haiku-4-5	轻量快速，成本低
claude-fable-5	创意写作特化

更多历史版本（Opus 4.x / Sonnet 4.5 等）见控制台「模型广场」。

方式一：OpenAI 兼容格式（推荐）

端点

POST $URL/v1/chat/completions

请求示例

curl

curl $URL/v1/chat/completions \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "写一个 Python 快速排序"}
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="$URL/v1")
resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "写一个 Python 快速排序"}],
)
print(resp.choices[0].message.content)

TypeScript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.YOUR_API_KEY,
  baseURL: '$URL/v1',
})
const resp = await client.chat.completions.create({
  model: 'claude-sonnet-5',
  messages: [{ role: 'user', content: '写一个 Python 快速排序' }],
})
console.log(resp.choices[0].message.content)

方式二：Anthropic 原生格式

如果你已有基于 Anthropic SDK 的代码，可以直接使用原生 Messages API：

端点

POST $URL/v1/messages

请求示例

curl

curl $URL/v1/messages \
  -H "x-api-key: $YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "写一个 Python 快速排序"}
    ]
  }'

Python (Anthropic SDK)

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="$URL",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一个 Python 快速排序"}],
)
print(message.content[0].text)

TypeScript (Anthropic SDK)

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  apiKey: process.env.YOUR_API_KEY,
  baseURL: '$URL',
})

const message = await client.messages.create({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '写一个 Python 快速排序' }],
})
console.log(message.content[0].text)

原生格式要点

差异点	Anthropic 原生	OpenAI 兼容
鉴权头	x-api-key: <KEY>（也兼容 Authorization: Bearer）	Authorization: Bearer <KEY>
max_tokens	必填	选填
system 提示	顶层 system 字段	messages 里 role: system
返回结构	content 为块数组	choices[0].message

选择建议

场景	推荐方式
新项目 / 多模型统一管理	OpenAI 兼容格式
已有 Anthropic SDK 代码、Claude Code 等原生工具	Anthropic 原生格式
需要 extended thinking 等 Claude 特有参数	Anthropic 原生格式