模型选择与能力对照

Claude 模型通常按能力和成本分为 Opus、Sonnet、Haiku 三类。实际可用模型名称以 Xikapi 后台模型列表和 Anthropic 官方模型列表为准，本文示例使用 Anthropic Messages API 的兼容调用方式。

新手先确认

Claude 接入时最容易混淆的是“Anthropic 原生格式”和“OpenAI 兼容格式”。本页示例使用 Anthropic Messages API 兼容路径：

text

https://xikapi.com/v1/messages

如果你的工具选择的是 OpenAI Compatible，通常应改看该工具的 Xikapi 配置页，并使用 https://xikapi.com/v1 作为 Base URL。

要确认的内容	正确做法	常见误区
API Key	使用 Xikapi API Key	填了 Anthropic 官方 Key，但地址写 Xikapi
Base URL	Anthropic SDK 填 `https://xikapi.com`	在 Anthropic SDK 里额外写 `/v1/messages`
模型名	填 Xikapi 后台启用的 Claude 模型 ID	文档里的示例名和后台实际名不一致
`max_tokens`	Messages API 请求必须设置合理输出长度	漏掉后以为模型无响应
图像能力	选择支持视觉输入的 Claude 模型	用纯文本模型发送图片

常见模型类型

类型	适合场景	特点
Claude Opus	复杂推理、高价值任务、深度分析	能力强，成本较高
Claude Sonnet	日常生产、代码、客服、文档分析	性价比均衡
Claude Haiku	批量分类、快速响应、低成本任务	速度快，成本低

按场景选择

场景	推荐模型类型	说明
普通聊天	Sonnet / Haiku	成本与质量均衡
复杂推理	Opus / Sonnet	适合复杂、多步骤任务
长文档分析	Sonnet / Opus	关注上下文长度和稳定性
代码分析	Sonnet	适合代码解释、重构、审查
批量分类	Haiku	成本低、速度快
企业客服	Sonnet	稳定性和质量均衡
图像理解	Sonnet / Opus	适合截图、票据、图表分析

选择模型时关注什么

任务复杂度
输入长度
输出稳定性
成本预算
响应速度
是否需要图像理解
是否需要工具调用

基础调用示例

curl：

bash

curl https://xikapi.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $XIKAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Explain in three sentences what Claude Sonnet is best suited for"
      }
    ]
  }'

JavaScript：

javascript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.XIKAPI_API_KEY,
  baseURL: "https://xikapi.com",
});

const message = await client.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "Help me choose a Claude model for customer support" }
  ],
});

console.log(message.content);

Python：

python

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_XIKAPI_API_KEY",
    base_url="https://xikapi.com",
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Help me choose a Claude model for document Q&A"}
    ],
)

print(message.content)

常见排错

现象	优先检查
`401`、`invalid x-api-key`	是否使用 Xikapi Key，Header 是否为 `x-api-key`
`404`	Anthropic SDK 的 `baseURL` 是否写成 `https://xikapi.com`，不要重复拼 `/v1/messages`
`model not found`	后台是否启用该 Claude 模型，模型名大小写和后缀是否完全一致
`max_tokens` 相关报错	Messages API 通常需要明确传 `max_tokens`
图片请求失败	模型是否支持视觉输入，图片格式和大小是否符合上游限制
工具调用不生效	当前模型和兼容层是否支持 Anthropic 工具调用格式，先用普通文本请求验证

模型选择与能力对照 ​

新手先确认 ​

常见模型类型 ​

按场景选择 ​

选择模型时关注什么 ​

基础调用示例 ​

常见排错 ​

推荐接入策略 ​