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υποχρεωτικό

  ID μοντέλου με μορφή Messages — 776 αναγνωριστικά: Claude, καθώς και GPT, Gemini, DeepSeek, Qwen και άλλα.

• messagesarrayυποχρεωτικό

  Μηνύματα user και assistant; content — συμβολοσειρά ή τμήματα (text, image, tool_use, tool_result).

• max_tokensintegerυποχρεωτικό

  Μέγιστος αριθμός token απάντησης. Συνυπολογίζεται στη δέσμευση· αν το υπόλοιπο δεν επαρκεί για ολόκληρο το όριο, το 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.