1. Autenticazione

Ogni richiesta include la tua API key nell'header X-API-Key. Il segreto si ottiene creando una chiave in API Keys (è mostrato una sola volta).

X-API-Key: LA_TUA_API_KEY

2. Endpoint

Generazione in streaming:

POST https://emma.egomnia.com/api/chat/stream

Content-Type: application/json · Risposta: application/x-ndjson (un evento JSON per riga).

3. Corpo della richiesta

Solo message è obbligatorio. Campi principali:

4. Risposta in streaming

Una sequenza di righe JSON (ndjson). Tipi di evento:

• meta — info iniziali (es. prompt_tokens).
• update — testo parziale incrementale in content.
• done — risposta finale in response + stats (con output_tokens).
• error — messaggio d'errore in message.

{"type": "meta", "prompt_tokens": 20, "mode": "raw", ...}
{"type": "update", "content": "Ciao"}
{"type": "update", "content": "Ciao, come"}
{"type": "done", "response": "Ciao, come stai?", "stats": {"output_tokens": 7, ...}}

5. Esempi

curl

curl -N -X POST https://emma.egomnia.com/api/chat/stream \
  -H "X-API-Key: LA_TUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Ciao, chi sei?"}'

Python

import json, requests

resp = requests.post(
    "https://emma.egomnia.com/api/chat/stream",
    headers={"X-API-Key": "LA_TUA_API_KEY"},
    json={"message": "Ciao, chi sei?"},
    stream=True,
)
for line in resp.iter_lines():
    if not line:
        continue
    event = json.loads(line)
    if event["type"] == "update":
        print(event["content"])
    elif event["type"] == "done":
        print("Risposta:", event["response"])

JavaScript (fetch)

const res = await fetch("https://emma.egomnia.com/api/chat/stream", {
  method: "POST",
  headers: { "X-API-Key": "LA_TUA_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Ciao, chi sei?" }),
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
let buf = "";
while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buf += decoder.decode(value, { stream: true });
  const lines = buf.split("\n");
  buf = lines.pop();
  for (const line of lines) {
    if (!line.trim()) continue;
    const ev = JSON.parse(line);
    if (ev.type === "update") console.log(ev.content);
    if (ev.type === "done") console.log("Risposta:", ev.response);
  }
}

6. Crediti e costi

Ogni chiamata via API consuma crediti in base ai token (input + output) e al listino corrente. Il saldo è in Crediti; lo storico dei movimenti in Fatturazione.

La chat sul sito è gratuita: il consumo di crediti avviene solo via API key.

7. Errori