Anthropic Claude API

把官方文档和模型目录对齐。

这里保留 Claude 官方入口、当前模型族和 TokenAI 的模型目录维护建议。

打开官方模型页

API 文档/Anthropic Claude API

官方文档

先看官方入口，再决定接哪条 API。

Anthropic 原生 API 用 `x-api-key` 传密钥，`anthropic-version` 固定版本，模型目录维护先读 `/v1/models`，再按需用 `messages` 校验真实可用性。

Models overview

查看 Claude 模型列表、别名和定价概览。

https://platform.claude.com/docs/en/about-claude/models/overview

Getting started

查看认证、Content-Type 和基础接入说明。

https://docs.anthropic.com/en/api/getting-started

Messages examples

查看 Messages API 的请求和响应示例。

https://docs.anthropic.com/en/api/messages-examples

模型目录

维护模型目录时优先保留当前官方模型族。

这些是当前模型目录里最值得优先保留的 Claude 模型名。

模型	用途
byt-claude-opus-4-7	最新旗舰推理与编码能力
byt-claude-opus-4-1-20250805	上一代旗舰快照模型
byt-claude-sonnet-4-20250514	高性能通用模型
byt-claude-3-7-sonnet-20250219	稳定的通用生产模型
byt-claude-3-5-sonnet-20241022	成熟的高质量主力模型
byt-claude-3-5-haiku-20241022	低成本、低延迟场景
byt-claude-3-haiku-20240307	更轻量的快速模型

API 入口

先打 models，再跑 messages。

GET /v1/models

读取可用模型列表。模型目录维护会先依赖它确认 Key 是否有效。

POST /v1/messages

Claude 原生生成入口。需要额外校验时可用它发一条最短请求。

x-api-key / anthropic-version

Anthropic 原生鉴权头与版本头。服务端建议只把 Key 留在渠道配置里。

读取模型

curl https://api.anthropic.com/v1/models \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json"

生成内容

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-4-7",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "Hello Claude" }
    ]
  }'

文件联动

先传文件，再在 messages 里引用 file_id。

TokenAI 这边，Anthropic token 访问 `/v1/files*` 会直接走 Anthropic Files API。典型链路是先上传文件，再把返回的 `file_id` 填进 `messages` 请求体。

Step 1: POST /v1/files

上传原始文件，拿到 `file_id`。这一步要带 `anthropic-beta: files-api-2025-04-14`。

Step 2: POST /v1/messages

在 `messages[].content[]` 里放一个 `type=document` 块，并把 `source.type=file`、`file_id=...` 填进去。

边界

这里只是代理 Anthropic 原生协议，不把文件内容改写成别的格式。要兼容官网，就按官方字段直接发。

上传文件

curl https://tokenapi.bytrabbit.com/v1/files \
  --header "Authorization: Bearer $TOKENAI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: files-api-2025-04-14" \
  --form "purpose=user_data" \
  --form "[email protected]"

在 messages 里引用文件

curl https://tokenapi.bytrabbit.com/v1/messages \
  --header "Authorization: Bearer $TOKENAI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "byt-claude-sonnet-4-20250514",
    "max_tokens": 256,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "file",
              "file_id": "file_123"
            }
          },
          {
            "type": "text",
            "text": "请总结这个文件的重点。"
          }
        ]
      }
    ]
  }'

目录维护

模型目录优先参考真实 API，再用官方文档校对。

如果渠道里已经配了可用 API Key，`job-worker` 会先拉取实际可见模型，再补上官方文档里的模型目录。

先配置 Anthropic Claude 渠道的 Base URL 和 API Key。
由 `job-worker` 执行模型目录拉取与校对。
如果 API 可用，系统会先读取 `/v1/models`，必要时再补一条 `messages` 校验。
如果 API 不可达，系统会退回到官方文档和内置目录。
目录更新后再按需调整单个模型的价格和状态。

Anthropic Claude API

把官方文档和模型目录对齐。

这里保留 Claude 官方入口、当前模型族和 TokenAI 的模型目录维护建议。

打开官方模型页

API 文档/Anthropic Claude API

官方文档

先看官方入口，再决定接哪条 API。

Anthropic 原生 API 用 `x-api-key` 传密钥，`anthropic-version` 固定版本，模型目录维护先读 `/v1/models`，再按需用 `messages` 校验真实可用性。

Models overview

查看 Claude 模型列表、别名和定价概览。

https://platform.claude.com/docs/en/about-claude/models/overview

Getting started

查看认证、Content-Type 和基础接入说明。

https://docs.anthropic.com/en/api/getting-started

Messages examples

查看 Messages API 的请求和响应示例。

https://docs.anthropic.com/en/api/messages-examples

模型目录

维护模型目录时优先保留当前官方模型族。

这些是当前模型目录里最值得优先保留的 Claude 模型名。

模型	用途
byt-claude-opus-4-7	最新旗舰推理与编码能力
byt-claude-opus-4-1-20250805	上一代旗舰快照模型
byt-claude-sonnet-4-20250514	高性能通用模型
byt-claude-3-7-sonnet-20250219	稳定的通用生产模型
byt-claude-3-5-sonnet-20241022	成熟的高质量主力模型
byt-claude-3-5-haiku-20241022	低成本、低延迟场景
byt-claude-3-haiku-20240307	更轻量的快速模型

API 入口

先打 models，再跑 messages。

GET /v1/models

读取可用模型列表。模型目录维护会先依赖它确认 Key 是否有效。

POST /v1/messages

Claude 原生生成入口。需要额外校验时可用它发一条最短请求。

x-api-key / anthropic-version

Anthropic 原生鉴权头与版本头。服务端建议只把 Key 留在渠道配置里。

读取模型

curl https://api.anthropic.com/v1/models \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json"

生成内容

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-4-7",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "Hello Claude" }
    ]
  }'

文件联动

先传文件，再在 messages 里引用 file_id。

TokenAI 这边，Anthropic token 访问 `/v1/files*` 会直接走 Anthropic Files API。典型链路是先上传文件，再把返回的 `file_id` 填进 `messages` 请求体。

Step 1: POST /v1/files

上传原始文件，拿到 `file_id`。这一步要带 `anthropic-beta: files-api-2025-04-14`。

Step 2: POST /v1/messages

在 `messages[].content[]` 里放一个 `type=document` 块，并把 `source.type=file`、`file_id=...` 填进去。

边界

这里只是代理 Anthropic 原生协议，不把文件内容改写成别的格式。要兼容官网，就按官方字段直接发。

上传文件

curl https://tokenapi.bytrabbit.com/v1/files \
  --header "Authorization: Bearer $TOKENAI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: files-api-2025-04-14" \
  --form "purpose=user_data" \
  --form "[email protected]"

在 messages 里引用文件

curl https://tokenapi.bytrabbit.com/v1/messages \
  --header "Authorization: Bearer $TOKENAI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "byt-claude-sonnet-4-20250514",
    "max_tokens": 256,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "file",
              "file_id": "file_123"
            }
          },
          {
            "type": "text",
            "text": "请总结这个文件的重点。"
          }
        ]
      }
    ]
  }'

目录维护

模型目录优先参考真实 API，再用官方文档校对。

如果渠道里已经配了可用 API Key，`job-worker` 会先拉取实际可见模型，再补上官方文档里的模型目录。

先配置 Anthropic Claude 渠道的 Base URL 和 API Key。
由 `job-worker` 执行模型目录拉取与校对。
如果 API 可用，系统会先读取 `/v1/models`，必要时再补一条 `messages` 校验。
如果 API 不可达，系统会退回到官方文档和内置目录。
目录更新后再按需调整单个模型的价格和状态。

页面加载中

把官方文档和模型目录对齐。

先看官方入口，再决定接哪条 API。

维护模型目录时优先保留当前官方模型族。

先打 models，再跑 messages。

先传文件，再在 messages 里引用 file_id。

模型目录优先参考真实 API，再用官方文档校对。

把官方文档和模型目录对齐。

先看官方入口，再决定接哪条 API。

维护模型目录时优先保留当前官方模型族。

先打 models，再跑 messages。

先传文件，再在 messages 里引用 file_id。

模型目录优先参考真实 API，再用官方文档校对。