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": "Сәлем! Қолыңнан не келеді?"}]
  }' 

import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # /v1 қоспай: SDK /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": "API деген не екенін екі сөйлеммен түсіндір."}],
)
print(msg.content[0].text)

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

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // /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: "API деген не екенін екі сөйлеммен түсіндір." }],
});
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": "Сәлем! Мен код жаза аламын, оны түсіндіремін, сұрақтарға жауап беремін…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}

Авторизация

• x-api-keyheaderміндетті

  Кілт sk-…. Мына нұсқа да болады: Authorization: Bearer sk-… — Claude Code мына айнымалымен осылай жұмыс істейді: ANTHROPIC_AUTH_TOKEN.

• anthropic-versionheaderміндетті емес

  API нұсқасы, мысалы 2023-06-01. SDK оны өздері жібереді.

Сұрау денесі

• modelstringміндетті

  Messages форматындағы модель ID-і — 776 идентификатор: Claude, сондай-ақ GPT, Gemini, DeepSeek, Qwen және басқалары.

• messagesarrayміндетті

  Хабарламалар user және assistant; content — жол немесе блоктар (text, image, tool_use, tool_result).

• max_tokensintegerміндетті

  Жауап токендерінің ең көп саны. Резервке кіреді; толық лимитке баланс жетпесе, Ailoot оны азайтады, бірақ 256-дан төмен түсірмейді (пайымдау қосылғанда 1025-тен төмен емес) және жаңа лимитті мына тақырыпта хабарлайды: X-Ailoot-Max-Tokens-Capped.

• systemstring | arrayміндетті емес

  Жүйелік нұсқау.

• streambooleanміндетті емес

  SSE оқиғалар ағыны (message_start, content_block_delta, …, message_stop). Ақылы мәтін құны есептелгеннен кейін бір блокпен келеді.

• temperaturenumberміндетті емес

  Жауаптың кездейсоқтық деңгейі 0-ден 1-ге дейін.

• toolsarrayміндетті емес

  Құралдар: name, description, input_schema.

• tool_choiceobjectміндетті емес

  auto, any, tool немесе none.

• thinkingobjectміндетті емес

  {"type": "enabled", "budget_tokens": N} — осыны қолдайтын модельдердегі пайымдау.

• stop_sequencesarrayміндетті емес

  Генерацияны тоқтататын жолдар.

Жауап

• contentarray

  Жауап блоктары: text, thinking, tool_use.

• stop_reasonstring

  end_turn, max_tokens, stop_sequence немесе tool_use.

• usageobject

  input_tokens, output_tokens, кэш үшін — cache_read_input_tokens және cache_creation_input_tokens.