Claude Messages API

Anthropic（Claude）格式的对话接口，也就是 Messages API。用 Anthropic SDK 或 Claude Code 这类工具时走这一套。

POST https://open.feiyutoken.com/v1/messages

SDK 与工具里填的 base_url 是 https://open.feiyutoken.com —— 不带 /v1， Anthropic 系的客户端会自己补 /v1/messages。填成带 /v1 的会变成 /v1/v1/messages。

请求头

-H "x-api-key: <你的飞鱼Token API Key>"
-H "anthropic-version: 2023-06-01"
-H "Content-Type: application/json"

请求参数

参数	类型	必填	说明
`model`	string	是	模型名，沿用厂商官方命名
`max_tokens`	integer	是	Anthropic 规范里这个字段必填
`messages`	array	是	对话历史，`role` 用 `user` / `assistant`（`system` 单独传）
`system`	string \| array	否	系统提示词，与 `messages` 平级
`stream`	boolean	否	`true` 时走 SSE 流式
`temperature`	number	否	采样温度
`top_p`	number	否	核采样
`stop_sequences`	array	否	遇到这些字符串就停止生成

参数表只列了最常用的几个；其余 Anthropic 参数（如 tools、tool_choice、top_k）按原样透传，用法与 Anthropic 官方一致。

请求示例

curl https://open.feiyutoken.com/v1/messages \
  -H "x-api-key: <你的飞鱼Token API Key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "max_tokens": 256,
    "system": "你是一个简洁的助手。",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是 API 网关。"}
    ]
  }'

响应

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "<模型名>",
  "content": [
    { "type": "text", "text": "..." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 32,
    "output_tokens": 48
  }
}

stop_reason 的含义：end_turn 正常结束、max_tokens 达到上限被截断、stop_sequence 命中自定义停止词、tool_use 请求调用工具。

用 Claude Code 的话不用自己写请求，看接入 Claude Code —— 那里有环境变量的配法。