Chat Completions

curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "Εξήγησε με δύο προτάσεις τι είναι το API."}
    ]
  }' 

from openai import OpenAI
import os

client = OpenAI(max_retries=0, 
    base_url="https://api.ailoot.ai/v1",
    api_key=os.environ["AILOOT_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Εξήγησε με δύο προτάσεις τι είναι το API."}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai/v1",
  apiKey: process.env.AILOOT_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "Εξήγησε με δύο προτάσεις τι είναι το API." }],
});
console.log(resp.choices[0].message.content);

{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Το API είναι μια συμφωνία για το πώς ένα πρόγραμμα ζητά από ένα άλλο να κάνει κάτι…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}

Έλεγχος ταυτότητας

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

  Κλειδί στη μορφή Bearer sk-…. Μπορείτε επίσης να χρησιμοποιήσετε τις κεφαλίδες x-api-key ή x-goog-api-key.

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

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

  ID μοντέλου από τον κατάλογο, για παράδειγμα claude-sonnet-5-5. Το μοντέλο πρέπει να υποστηρίζει τη μορφή OpenAI Chat.

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

  Ιστορικό συνομιλίας: αντικείμενα με role (system, developer, user, assistant, tool) και content — συμβολοσειρά ή πίνακας τμημάτων (κείμενο, image_url).

• streambooleanπροαιρετικό

  Απάντηση στη μορφή Server-Sent Events. Από προεπιλογή false. Το χρεώσιμο κείμενο φτάνει σε ένα ενιαίο τμήμα μετά τον υπολογισμό του κόστους, και όχι λέξη προς λέξη.

• stream_optionsobjectπροαιρετικό

  {"include_usage": true} — αποστολή του τελικού usage ως τελευταίου συμβάντος της ροής.

• max_tokensintegerπροαιρετικό

  Μέγιστος αριθμός token απάντησης. Το νέο όνομα είναι max_completion_tokens. Αν δεν ορίσετε όριο, το Ailoot χρησιμοποιεί 4096 (ή λιγότερα, αν το μοντέλο έχει μικρότερο όριο απάντησης· το Grok έχει δικό του όριο). Για μεγάλες απαντήσεις, ορίστε ρητά το όριο, αλλιώς η απάντηση θα σταματήσει στα 4096 token με finish_reason: "length". Το όριο συνυπολογίζεται στη δέσμευση: όσο μεγαλύτερο είναι, τόσο περισσότερο διαθέσιμο υπόλοιπο χρειάζεται.

• temperaturenumberπροαιρετικό

  Τυχαιότητα απάντησης, συνήθως από 0 έως 2. Ενδέχεται να αγνοείται από τα μοντέλα συλλογισμού.

• top_pnumberπροαιρετικό

  Εναλλακτική του temperature: το μέρος της μάζας πιθανότητας που λαμβάνεται υπόψη κατά την επιλογή token.

• stopstring | arrayπροαιρετικό

  Συμβολοσειρές στις οποίες σταματά η παραγωγή.

• toolsarrayπροαιρετικό

  Περιγραφές συναρτήσεων που μπορεί να καλέσει το μοντέλο. Η μορφή είναι ίδια με του OpenAI: {"type": "function", "function": {...}}.

• tool_choicestring | objectπροαιρετικό

  auto, none, required ή συγκεκριμένη συνάρτηση.

• response_formatobjectπροαιρετικό

  {"type": "json_object"} ή {"type": "json_schema", ...} για δομημένη απάντηση — εφόσον το υποστηρίζει το μοντέλο.

• reasoning_effortstringπροαιρετικό

  Βάθος συλλογισμού για τα μοντέλα συλλογισμού: low, medium, high.

Οι υπόλοιπες παράμετροι OpenAI μεταβιβάζονται ως έχουν· ο δημιουργός του μοντέλου καθορίζει αν το συγκεκριμένο μοντέλο τις υποστηρίζει.

Απάντηση

• choices[].messageobject

  Απάντηση μοντέλου: content, όταν καλούνται εργαλεία — tool_calls.

• choices[].finish_reasonstring

  stop — η απάντηση ολοκληρώθηκε· length — έφτασε το όριο max_tokens (η απάντηση αυτή εξακολουθεί να θεωρείται πλήρης και χρεώνεται βάσει της πραγματικής χρήσης)· tool_calls — το μοντέλο καλεί εργαλείο.

• usageobject

  prompt_tokens, completion_tokens, total_tokens — βάσει αυτών υπολογίζεται η χρέωση.