Anthropic Format

Anthropic-compatible phù hợp khi ứng dụng đã dùng Claude native hoặc cần tính năng Messages API như system prompt, tool use, vision và streaming event.

Cài đặt

npm install @anthropic-ai/sdk

Khởi tạo Client

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

const anthropic = new Anthropic({
  apiKey: process.env.CHEAPKEYAI_API_KEY,
  baseURL: "https://cheapkeyai.shop"
});

const message = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Tóm tắt repository này." }]
});

console.log(message.content[0].text);

Messages API

const message = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  system: "Bạn là senior engineer, trả lời ngắn và chính xác.",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Review đoạn code này." }]
});

const stream = await anthropic.messages.stream({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Viết kế hoạch migration." }]
});

stream.on("text", (text) => process.stdout.write(text));
const final = await stream.finalMessage();
console.log(final.usage);

const message = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 1024,
  messages: [{
    role: "user",
    content: [
      { type: "image", source: { type: "url", url: "https://example.com/screenshot.png" } },
      { type: "text", text: "Phân tích lỗi UI trong ảnh." }
    ]
  }]
});

Tool Use

Tool use cho phép model trả về yêu cầu gọi hàm. Ứng dụng của bạn thực thi hàm, đưa kết quả trở lại messages, sau đó gọi tiếp để model tạo câu trả lời cuối.

Count Tokens

curl https://cheapkeyai.shop/v1/messages/count_tokens \
  -H "Authorization: Bearer <your-api-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-3-5-sonnet-20241022","messages":[{"role":"user","content":"Hello"}]}'

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách xử lý
401	Sai API key	Kiểm tra Bearer token và group key.
404 model	Model không nằm trong group	Đổi model hoặc mua key group phù hợp.
stream closed	Mạng/proxy ngắt kết nối	Retry và log request ID nếu có.
max_tokens	Giá trị vượt giới hạn model	Giảm max_tokens hoặc đổi model context lớn hơn.