Messages

curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Xin chào! Bạn làm được những gì?"}]
  }' 

import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # không có /v1: SDK tự thêm /v1/messages
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Giải thích API là gì trong hai câu."}],
)
print(msg.content[0].text)

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

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // không có /v1
  apiKey: process.env.AILOOT_API_KEY,
});

const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Giải thích API là gì trong hai câu." }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);

{
  "id": "msg_01H…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "Xin chào! Tôi có thể viết và giải thích mã, trả lời câu hỏi…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}

Xác thực

• x-api-keyheaderbắt buộc

  Khóa sk-…. Cũng có thể dùng Authorization: Bearer sk-… — Claude Code dùng cách này với ANTHROPIC_AUTH_TOKEN.

• anthropic-versionheaderkhông bắt buộc

  Phiên bản API, ví dụ 2023-06-01. SDK tự gửi giá trị này.

Phần thân yêu cầu

• modelstringbắt buộc

  ID mô hình hỗ trợ định dạng Messages — 776 mã định danh: Claude cùng GPT, Gemini, DeepSeek, Qwen và các mô hình khác.

• messagesarraybắt buộc

  Tin nhắn user và assistant; content — chuỗi hoặc các khối (text, image, tool_use, tool_result).

• max_tokensintegerbắt buộc

  Số token tối đa của phản hồi. Giới hạn này được tính vào khoản tiền giữ trước; nếu số dư không đủ cho toàn bộ giới hạn, Ailoot giảm giới hạn nhưng không thấp hơn 256 (1025 khi bật suy nghĩ) và thông báo giới hạn mới trong header X-Ailoot-Max-Tokens-Capped.

• systemstring | arraykhông bắt buộc

  Chỉ dẫn hệ thống.

• streambooleankhông bắt buộc

  Luồng sự kiện SSE (message_start, content_block_delta, …, message_stop). Văn bản tính phí được gửi thành một khối sau khi tính chi phí.

• temperaturenumberkhông bắt buộc

  Mức độ ngẫu nhiên của phản hồi từ 0 đến 1.

• toolsarraykhông bắt buộc

  Công cụ: name, description, input_schema.

• tool_choiceobjectkhông bắt buộc

  auto, any, tool hoặc none.

• thinkingobjectkhông bắt buộc

  {"type": "enabled", "budget_tokens": N} — suy nghĩ đối với các mô hình hỗ trợ.

• stop_sequencesarraykhông bắt buộc

  Các chuỗi khiến quá trình tạo nội dung dừng lại.

Phản hồi

• contentarray

  Các khối phản hồi: text, thinking, tool_use.

• stop_reasonstring

  end_turn, max_tokens, stop_sequence hoặc tool_use.

• usageobject

  input_tokens, output_tokens, đối với bộ nhớ đệm — cache_read_input_tokens và cache_creation_input_tokens.