docs
API

Messages

Markdown

Anthropic Messages formátum. A Claude Code, az Anthropic SDK és számos ügynök ezt használja.

Teljes útmutató
POSThttps://api.ailoot.ai/v1/messages
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": "Szia! Mit tudsz csinálni?"}]
  }' 
200 OK
{
  "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 és assistant; 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, tool vagy none.

  • 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_sequence vagy tool_use.

  • usageobject

    input_tokens, output_tokens, a gyorsítótárhoz pedig cache_read_input_tokens és cache_creation_input_tokens.

Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.Írjon a támogatásnak