开发集成

Claude 模型调用

Yomi API 提供 Claude 系列模型，支持 OpenAI 兼容与 Anthropic 原生两种调用方式，可按现有技术栈自由选择。

可用模型

模型 id	上下文	定位
`claude-opus-4-8`	200K	顶级推理，长文档与复杂代理
`claude-sonnet-5`	1M	速度与智能平衡，生产 Agent 主力

OpenAI 兼容调用

沿用 OpenAI SDK 与 /v1/chat/completions,仅替换 model 参数:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yomiapi.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "解释什么是幂等接口"}]
)
print(response.choices[0].message.content)

Anthropic 原生调用

平台实现了 Anthropic Messages 接口，可直接使用官方 anthropic SDK,或按原生格式发起 HTTP 请求:

POST https://api.yomiapi.com/v1/messages

Python 示例

pip install anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.yomiapi.com"
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "解释什么是幂等接口"}]
)
print(message.content[0].text)

cURL 示例

curl https://api.yomiapi.com/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": "解释什么是幂等接口"}]
  }'

原生格式下 base_url 填 https://api.yomiapi.com(不带 /v1),SDK 会自动拼接 /v1/messages;鉴权可用 x-api-key 头，也可用 Authorization Bearer。原生格式中 max_tokens 为必填参数。

如何选择

OpenAI 兼容: 已有 OpenAI 技术栈，或需要在多家模型之间用同一套代码切换时首选。
Anthropic 原生: 项目基于 anthropic SDK,或需要按 Anthropic 文档使用原生请求结构(system 字段、内容块等)时选择。

使用建议

长文档分析、复杂多步代理任务选 claude-opus-4-8;日常生产与 Agent 主力负载选 claude-sonnet-5,响应速度更快。
两种调用方式计费一致，按所选模型的公开价格和实际用量计算，费用明细可在「用量统计」中查询。