Messages (định dạng Anthropic)

Endpoint POST /v1/messages nhận yêu cầu theo định dạng Anthropic Messages. Gateway tự chuyển đổi định dạng, nên bạn có thể gọi cả model không thuộc Anthropic bằng cùng cú pháp này.

#Thông tin endpoint

Các trường thường dùng: model, max_tokens, messages, và tuỳ chọn system, stream.

#Gửi yêu cầu

1. Chuẩn bị khoá

   Tạo khoá ở Khoá API và đặt vào biến môi trường.

   bashSao chép

   $ export REXAPF_API_KEY="sk_9r_..."

2. Chọn model

   Sao chép ID model ở API Gateway › Model. Xem Model & bảng giá.

3. Gửi yêu cầu

   curlTypeScriptPythonSao chép

   $ curl https://rexapf.com/v1/messages \
     -H "x-api-key: $REXAPF_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "<model-id>",
       "max_tokens": 1024,
       "system": "Bạn là trợ lý ngắn gọn.",
       "messages": [{"role": "user", "content": "Tóm tắt HTTP/2 trong 3 ý."}]
     }'

4. Xem kết quả trên bảng điều khiển

   Mở API Gateway › Sử dụng › Lịch sử để xem token và chi phí của yêu cầu.

#Stream phản hồi

Đặt "stream": true để nhận sự kiện SSE theo định dạng Anthropic.

const stream = client.messages.stream({
  model: "<model-id>",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Viết một bài haiku về mưa." }],
});

for await (const event of stream) {
  if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
    process.stdout.write(event.delta.text);
  }
}

#Đếm token

Endpoint POST /v1/messages/count_tokens trả về input_tokens cho phần messages bạn gửi.

$ curl https://rexapf.com/v1/messages/count_tokens \
  -H "Content-Type: application/json" \
  -d '{"model": "<model-id>", "messages": [{"role": "user", "content": "Xin chào"}]}'

#Dùng với Claude Code

Claude Code gọi endpoint Messages. Bạn chỉ cần đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN:

$ export ANTHROPIC_BASE_URL="https://rexapf.com/v1"
$ export ANTHROPIC_AUTH_TOKEN="sk_9r_..."

$env:ANTHROPIC_BASE_URL="https://rexapf.com/v1"
$env:ANTHROPIC_AUTH_TOKEN="sk_9r_..."

Hướng dẫn đầy đủ, kèm lệnh cấu hình một dòng, ở Claude Code.

#Lỗi thường gặp

Chi tiết ở Mã lỗi & giới hạn.

#Liên quan