Source: https://ailoot.ai/docs/el/api/messages/
Canonical: https://ailoot.ai/docs/el/api/messages/
Language: el

[API](https://ailoot.ai/docs/el/) 

# Messages

[Markdown](https://ailoot.ai/docs/el/api/messages/index.md)

Η μορφή Anthropic Messages. Χρησιμοποιείται από το Claude Code, το Anthropic SDK και πολλούς πράκτορες.

POST`https://api.ailoot.ai/v1/messages`

Messages

```bash
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": "Γεια! Τι μπορείς να κάνεις;"}]
  }' 
```

```python
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)
```

```js
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);
```

200 OK

```json
{
  "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-key` | header | υποχρεωτικό | Κλειδί `sk-…`. Μπορείτε επίσης να χρησιμοποιήσετε το `Authorization: Bearer sk-…` — έτσι λειτουργεί το Claude Code με το `ANTHROPIC_AUTH_TOKEN`. |
| `anthropic-version` | header | προαιρετικό | Έκδοση API, για παράδειγμα `2023-06-01`. Τα SDK τη στέλνουν αυτόματα. |

## Σώμα αιτήματος

| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
| --- | --- | --- | --- |
| `model` | string | υποχρεωτικό | ID μοντέλου με μορφή Messages — 776 αναγνωριστικά: Claude, καθώς και GPT, Gemini, DeepSeek, Qwen και άλλα. |
| `messages` | array | υποχρεωτικό | Μηνύματα `user` και `assistant`; `content` — συμβολοσειρά ή τμήματα (`text`, `image`, `tool_use`, `tool_result`). |
| `max_tokens` | integer | υποχρεωτικό | Μέγιστος αριθμός token απάντησης. Συνυπολογίζεται στη δέσμευση· αν το υπόλοιπο δεν επαρκεί για ολόκληρο το όριο, το Ailoot το μειώνει, αλλά όχι κάτω από 256 (1025 με ενεργοποιημένο συλλογισμό), και γνωστοποιεί το νέο όριο στην κεφαλίδα `X-Ailoot-Max-Tokens-Capped`. |
| `system` | string \| array | προαιρετικό | Οδηγία συστήματος. |
| `stream` | boolean | προαιρετικό | Ροή συμβάντων SSE (`message_start`, `content_block_delta`, …, `message_stop`). Το χρεώσιμο κείμενο φτάνει σε ένα ενιαίο τμήμα μετά τον υπολογισμό του κόστους. |
| `temperature` | number | προαιρετικό | Τυχαιότητα απάντησης από 0 έως 1. |
| `tools` | array | προαιρετικό | Εργαλεία: `name`, `description`, `input_schema`. |
| `tool_choice` | object | προαιρετικό | `auto`, `any`, `tool` ή `none`. |
| `thinking` | object | προαιρετικό | `{"type": "enabled", "budget_tokens": N}` — συλλογισμός στα μοντέλα που τον υποστηρίζουν. |
| `stop_sequences` | array | προαιρετικό | Συμβολοσειρές στις οποίες σταματά η παραγωγή. |

## Απάντηση

| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
| --- | --- | --- | --- |
| `content` | array |  | Τμήματα απάντησης: `text`, `thinking`, `tool_use`. |
| `stop_reason` | string |  | `end_turn`, `max_tokens`, `stop_sequence` ή `tool_use`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, για την κρυφή μνήμη — `cache_read_input_tokens` και `cache_creation_input_tokens`. |

Η καταμέτρηση token (`POST /v1/messages/count_tokens`) δεν είναι προς το παρόν διαθέσιμη για τα μοντέλα του καταλόγου.

Έχετε ερωτήσεις; Στείλτε μας το Request ID και μια περιγραφή — θα σας βοηθήσουμε να βρείτε την αιτία.[Επικοινωνία με την υποστήριξη](mailto:support@ailoot.ai)

## Ailoot · Η εταιρεία και το χαρτοφυλάκιο έργων της





Η Ailoot στηρίζεται στη συσσωρευμένη λειτουργική εμπειρία, τη μεγάλη πελατειακή βάση, τη σταθερή εξυπηρέτηση και τον συνεχή έλεγχο KPI.





Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.





Η Ailoot αξιοποιεί αυτή τη λειτουργική εμπειρία για πρόσβαση μέσω API σε λειτουργίες AI στα προϊόντα, τους πράκτορες, τις εφαρμογές και τους αυτοματισμούς των πελατών.