O singură linie de cod și rulezi în Uniunea Europeană.

Start rapid: primul tău apel API

Creează o cheie în dashboardul tău, la Setări, Chei API. Secretul îl vezi o singură dată. După aceea păstrăm doar un hash și prefixul. Pune-l într-o variabilă de mediu, niciodată în repository.

curl https://api.europeanailab.eu/v1/chat/completions \
  -H "Authorization: Bearer $UNION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eu-standard",
    "messages": [{"role": "user", "content": "Explică taxarea inversă la TVA."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # singura linie care se schimbă
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Explică taxarea inversă la TVA."}],
)
print(resp.choices[0].message.content)

Niveluri de model și ferestre de context

În câmpul model trimiți un nivel, nu un nume de model. Așa, integrarea ta merge în continuare când schimbăm modelul de dedesubt, iar asta se va întâmpla, pentru că modelele open-weight sunt retrase și depășite.

Dacă depășești fereastra de context a unui nivel, primești un 400 cu maximul în mesaj: nu îți trunchiem niciodată promptul pe tăcute.

Răspunsuri în streaming

Streamingul funcționează cum te aștepți, cu o diferență importantă pe care trebuie s-o știi, pentru că e vorba de banii tăi.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Scrie un rezumat."}],
    stream=True,
    # Fără asta nu primești obiectul usage și nu vezi costul.
    stream_options={"include_usage": True},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:                      # ultimul chunk
        print("\n", chunk.usage)

Dacă întrerupi un stream la jumătate, plătești doar ce s-a generat până atunci. Dacă din cauza conexiunii căzute nu mai sosește chunkul cu usage, estimăm consumul și îl corectăm la reconcilierea zilnică cu furnizorul nostru. Până se decontează, linia apare în evidența consumului ca estimated.

Function calling și tool use

Tool-urile urmează schema pe care o știi deja. Dacă un model produce un tool call care nu se potrivește cu schema ta, îl logăm: în versiunea 1 nu îl corectăm pe tăcute, pentru că o reparație discretă a outputului tău e mai rea decât o eroare vizibilă.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Caută o factură după număr.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

resp = client.chat.completions.create(
    model="eu-standard", messages=messages, tools=tools
)

Output structurat cu o schemă JSON

Trimite o schemă JSON și validează răspunsul la tine. Sfatul nostru: validează mereu, chiar dacă modelul de obicei se poartă frumos.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Extrage numele și suma."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

Headere de răspuns: cost, nivel și rutare

Fiecare răspuns îți spune ce s-a întâmplat. Nu e un bonus pentru debugging, e chiar ideea: poți verifica singur că ai primit ce ai plătit.

Limite de cereri și plafoane de cheltuieli

Există o limită pe cheie și pe cont, plus plafoanele pe care le setezi tu. Acestea din urmă contează mai mult decât pare: fără plafon, o cheie scursă sau o buclă infinită în propriul tău cod îți poate goli soldul peste noapte.

• Cereri pe minut, pe cheie și pe cont.
• Plafon zilnic și lunar în euro, configurabil pentru fiecare cheie.
• Conturi noi: maximum 25 € pe zi în primele 48 de ore, indiferent de sold.
• Dacă vedem într-o oră de peste zece ori media ta săptămânală, suspendăm automat cheia și îți trimitem un email. Mai bine o alarmă falsă decât un portofel gol.
• O cerere pornește doar dacă soldul tău este de cel puțin 0,05 €.

Coduri de eroare și ce faci

Cererile eșuate nu te costă nimic: dacă nu s-a întors un răspuns utilizabil, nu se scade nimic din sold.

Utilizare corectă și politica de utilizare

Refuzăm instrucțiuni pentru arme, malware și fraudă, precum și materiale care fac rău copiilor. Aceste refuzuri sunt definitive: nu trimitem niciodată o astfel de cerere la alt model ca să scoatem totuși un răspuns.

Altceva e când un model refuză o întrebare legitimă despre politică, istorie sau un subiect sensibil social: tratăm asta ca pe un defect și trimitem cererea la un model fără acel punct orb. Vezi asta în headerul X-EU-Routed: censorship.

Unul dintre modelele noastre are o licență cu propria politică de utilizare. Acea politică se aplică integral: redirecționarea nu ocolește termenii licenței.

Nu ești sigur că utilizarea ta se încadrează? Scrie la hello@europeanailab.eu. Un răspuns dinainte e mai ieftin pentru amândoi decât o cheie blocată după.

Întrebări frecvente

Întrebările care sosesc pe email înainte ca cineva să-și facă o cheie: cu ce e compatibil API-ul, cât costă o cerere și unde rulează.

Mutarea unei integrări existente înseamnă trei linii: cheia, base URL-ul și numele unui nivel. Toată schimbarea, plus ce nu se poate porta, e în trecerea în trei linii. Mai ai întrebări? Tarifele pe nivel sunt pe pagina de prețuri, modelul și licența din spatele fiecărui nivel la Transparență AI, iar ce se întâmplă la o pană pe pagina de status. Două lecturi mai lungi: cât costă un API AI pe token și unde ajung de fapt prompturile tale.