Anthropic Messages

Sử dụng endpoint Messages tương thích với Anthropic Claude cho các client gửi payload Messages theo định dạng Anthropic.

POST https://getrouter.ai/v1/messages

Yêu cầu cơ bản

curl https://getrouter.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 512,
    "system": "Answer clearly and concisely.",
    "messages": [
      {"role": "user", "content": "Explain the purpose of a Base URL."}
    ]
  }'

Phản hồi tuân theo cấu trúc tin nhắn tương thích với Claude, gồm các khối nội dung và thông tin sử dụng khi có.

Các trường bắt buộc

TrườngMô tả
modelModel ID tương thích với Claude
messagesCác tin nhắn hội thoại
max_tokensSố token đầu ra tối đa

Các trường tùy chọn

Lược đồ API gồm các trường như:

  • system
  • temperature, top_ptop_k
  • stream
  • stop_sequences
  • toolstool_choice
  • thinking
  • context_management
  • output_configoutput_format
  • metadata
  • speedservice_tier

Khả năng hỗ trợ phụ thuộc vào model. Không gửi một tùy chọn chỉ vì nó xuất hiện trong lược đồ; hãy xác nhận model được chọn có hỗ trợ.

Streaming

Đặt stream thành true để streaming theo Anthropic Messages khi được hỗ trợ:

{
  "model": "MODEL_ID",
  "max_tokens": 512,
  "stream": true,
  "messages": [
    {"role": "user", "content": "Write a short release note."}
  ]
}

Hãy dùng bộ phân tích sự kiện Claude thay vì bộ phân tích OpenAI Chat Completions hoặc OpenAI Responses.

Hỗ trợ công cụ và suy luận

Định nghĩa công cụ, khối kết quả công cụ và cấu hình suy luận tương thích với Claude yêu cầu model có các chức năng tương ứng. Hãy kiểm thử toàn bộ quy trình trước khi bật cho các agent AI chạy không giám sát.

Warning

Cùng một model ID Claude nhưng khi dùng qua endpoint tương thích với OpenAI và khi dùng qua /v1/messages có thể yêu cầu cách xử lý yêu cầu và phản hồi khác nhau. Hãy cấu hình đúng giao thức mà client của bạn cần.

Tích hợp công cụ

Các công cụ như client dành cho lập trình tương thích với Claude có thể yêu cầu thêm biến môi trường hoặc cấu hình nhà cung cấp. Hãy làm theo hướng dẫn chuyên biệt trong mục Tích hợp thay vì chỉ thay tên máy chủ.

Bước tiếp theo