Skip to main content

​
Claude 基础对话示例

以下示例展示如何使用Claude的 /v1/messages 接口进行基础文本对话。

​
快速开始

只需要替换 YOUR_API_KEY 为你的实际API密钥即可运行。 
curl -X POST "https://model-api.skyengine.com.cn/v1/messages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-3-7-sonnet-20250219",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ]
  }'

​
结果示例

{
  "id": "d464daaecced48c0955463907cd814f3",
  "content": [
    {
      "citations": null,
      "text": "你好！我是Claude，由Anthropic创建的AI助手。我被设计来进行有帮助、无害且诚实的对话。我可以回答问题、提供信息、协助创意写作、讨论各种话题，以及帮助完成多种任务。\n\n我具有广泛的知识，但我的训练\n\n我致力于提供准确、有益且符合道德的回应，同时尊重隐私和安全。如果有什么我能帮助你的，请告诉我！",
      "type": "text",
      "signature": "",
      "thinking": "",
      "data": "",
      "id": "",
      "input": null,
      "name": "",
      "content": {
        "OfWebSearchResultBlockArray": null,
        "error_code": "",
        "type": "web_search_tool_result_error"
      },
      "tool_use_id": ""
    }
  ],
  "model": "claude-3-7-sonnet-20250219",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": "",
  "type": "message",
  "usage": {
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "input_tokens": 20,
    "output_tokens": 198,
    "server_tool_use": {
      "web_search_requests": 0
    },
    "service_tier": ""
  }
}

​
重要参数说明

  • model: Claude模型名称，如 claude-3-7-sonnet-20250219、claude-3-haiku-20240307 等
  • max_tokens: 最大生成token数量，Claude要求必须指定此参数
  • messages: 对话消息数组，包含角色（role）和内容（content）
  • anthropic-version: API版本号，建议使用 2023-06-01

​
支持的模型

  • claude-sonnet-4-20250514
  • claude-opus-4-250514
  • claude-3-7-sonnet-20250219
  • claude-3-5-sonnet-20241022

​
Claude API特点

  • 响应格式: Claude返回的内容在 content 数组中，每个元素包含 text 字段
  • 必需头部: 需要包含 anthropic-version 头部
  • token限制: 必须指定 max_tokens 参数，不能省略

​
错误处理

Claude API的常见错误码：
  • 400 Bad Request: 请求参数错误
  • 401 Unauthorized: API密钥无效
  • 429 Rate Limit Exceeded: 请求频率超限
  • 500 Internal Server Error: 服务器内部错误