Messages
MarkdownAnthropic Messages formátum. A Claude Code, az Anthropic SDK és számos ügynök ezt használja.
Teljes útmutató
https://api.ailoot.ai/v1/messagescurl 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": "Szia! Mit tudsz csinálni?"}]
}' import anthropic
import os
client = anthropic.Anthropic(max_retries=0,
base_url="https://api.ailoot.ai", # /v1 nélkül: az SDK maga hozzáfűzi a /v1/messages útvonalat
api_key=os.environ["AILOOT_API_KEY"],
)
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Magyarázza el két mondatban, mi az az API."}],
)
print(msg.content[0].text)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ maxRetries: 0,
baseURL: "https://api.ailoot.ai", // /v1 nélkül
apiKey: process.env.AILOOT_API_KEY,
});
const msg = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Magyarázza el két mondatban, mi az az 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": "Szia! Tudok kódot írni és magyarázni, kérdésekre válaszolni…" }
],
"stop_reason": "end_turn",
"usage": { "input_tokens": 14, "output_tokens": 52 }
}Hitelesítés
- x-api-keyheaderkötelező
Kulcs
sk-…. A következő is használható:Authorization: Bearer sk-…— a Claude Code így működik, a következő változóval:ANTHROPIC_AUTH_TOKEN. - anthropic-versionheadernem kötelező
API-verzió, például
2023-06-01. Az SDK-k automatikusan elküldik.
A kérés törzse
- modelstringkötelező
Messages formátumot támogató modell azonosítója — 776 azonosító: Claude, valamint GPT, Gemini, DeepSeek, Qwen és más modellek.
- messagesarraykötelező
Üzenetek:
userésassistant;content— karakterlánc vagy blokkok (text,image,tool_use,tool_result). - max_tokensintegerkötelező
A válasz tokenjeinek maximális száma. Beleszámít a zárolt összegbe; ha az egyenleg nem fedezi a teljes korlátot, az Ailoot csökkenti, de nem 256 alá (bekapcsolt gondolkodásnál nem 1025 alá), és az új korlátot a következő fejlécben jelzi:
X-Ailoot-Max-Tokens-Capped. - systemstring | arraynem kötelező
Rendszerutasítás.
- streambooleannem kötelező
SSE-eseményfolyam (
message_start,content_block_delta, …,message_stop). A díjköteles szöveg a költség kiszámítása után egyetlen blokkban érkezik. - temperaturenumbernem kötelező
A válasz véletlenszerűsége 0 és 1 között.
- toolsarraynem kötelező
Eszközök:
name,description,input_schema. - tool_choiceobjectnem kötelező
auto,any,toolvagynone. - thinkingobjectnem kötelező
{"type": "enabled", "budget_tokens": N}— gondolkodás az ezt támogató modelleknél. - stop_sequencesarraynem kötelező
Karakterláncok, amelyeknél a generálás leáll.
Válasz
- contentarray
Válaszblokkok:
text,thinking,tool_use. - stop_reasonstring
end_turn,max_tokens,stop_sequencevagytool_use. - usageobject
input_tokens,output_tokens, a gyorsítótárhoz pedigcache_read_input_tokenséscache_creation_input_tokens.