Anthropic SDK / Messages 格式

除了 OpenAI 格式，AI 星图还提供 Anthropic 原生格式的 POST /v1/messages 接口，可以直接使用 Anthropic 官方 SDK，也是 Claude Code 的接入方式。

和 OpenAI 格式的区别复制锚点链接

调用示例复制锚点链接

示例中的 your-model-id 请替换为模型广场中的模型 ID（也可以调用 GET /v1/models 查看）。

import os

import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["MYAIEXP_API_KEY"],
    base_url="https://ai.myaiexp.com",  # 注意：Anthropic SDK 的 base_url 不带 /v1
)

message = client.messages.create(
    model="your-model-id",  # 替换为模型广场中的模型 ID
    max_tokens=256,
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)

print(message.content[0].text)

安装 SDK：

pip install anthropic

如果你的工具只支持 Bearer 鉴权，把 curl 里的 x-api-key: $MYAIEXP_API_KEY 换成 Authorization: Bearer $MYAIEXP_API_KEY 即可；Anthropic SDK 里对应的是 auth_token / authToken 参数。

扩展思考（thinking）复制锚点链接

支持扩展思考的模型可以先思考再回答：在请求中传 thinking 参数即可。thinking 是 Anthropic Messages API 的标准参数，本站按 Anthropic API 的定义原样透传。参数格式请以 Anthropic 官方文档 为准；哪些模型支持扩展思考，以 模型广场 为准。

注意事项：

• 思考内容以 type: "thinking" 的内容块返回，排在正文之前；读取正文时不要直接取 content[0]，应按 type == "text" 筛选。
• 思考 token 计入输出 token 并按输出计费，max_tokens 要留足空间，否则可能思考没完就被截断。
• 思考耗时较长，建议配合 流式输出 使用。

提高缓存命中率复制锚点链接

多轮对话、长 system 提示词等场景，可以在内容块上加 cache_control 开启提示词缓存，重复的输入按厂商的缓存读取刊例价计费。详见 提示词缓存。

选对模型复制锚点链接

• /v1/messages 只接受支持 Claude 原生格式的模型 ID；用不支持该格式的模型调用会报错。在 模型广场 选择一个支持 /v1/messages 的模型，使用它的模型 ID。
• 模型 ID 区分大小写。当前 Key 能用的模型以 GET /v1/models 返回为准，完整列表与价格见 模型广场。
• 如果创建 Key 时设置了模型限制，请确认要用的模型在允许列表里，见 API 密钥。

支持的能力复制锚点链接