Jeden řádek kódu a běžíš v Evropské unii.

Rychlý start: tvoje první volání API

Klíč si vytvoříš v dashboardu v Nastavení, API klíče. Tajný klíč uvidíš přesně jednou. Potom si uchováváme jen jeho hash a prefix. Ulož ho do proměnné prostředí, nikdy do repozitáře.

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": "Vysvětli přenesenou daňovou povinnost u DPH."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # jediný řádek, který se mění
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Vysvětli přenesenou daňovou povinnost u DPH."}],
)
print(resp.choices[0].message.content)

Úrovně modelů a kontextová okna

Do pole model předáváš úroveň, ne název modelu. Díky tomu tvoje integrace funguje dál, i když model pod ní vyměníme. A to se stane, protože open-weight modely se vyřazují a předbíhají.

Když překročíš kontextové okno úrovně, dostaneš 400 s uvedeným maximem: tvůj prompt nikdy potichu nezkracujeme.

Streamované odpovědi

Streaming funguje tak, jak čekáš, s jedním důležitým rozdílem, o kterém musíš vědět, protože jde o tvoje peníze.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Napiš shrnutí."}],
    stream=True,
    # Bez tohoto nepřijde objekt usage a cenu neuvidíš.
    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:                      # poslední chunk
        print("\n", chunk.usage)

Když stream v půlce utneš, platíš jen za to, co se do té chvíle vygenerovalo. Pokud kvůli přerušenému spojení nepřijde chunk se spotřebou, spotřebu odhadneme a opravíme ji při denním vyúčtování s naším poskytovatelem. Do vypořádání je takový řádek ve tvém přehledu spotřeby označen jako estimated.

Function calling a používání nástrojů

Nástroje se řídí známým schématem. Když model vytvoří volání nástroje, které neodpovídá tvému schématu, zalogujeme ho: ve verzi 1 ho potichu neopravujeme, protože tiché opravování tvého výstupu je horší než viditelná chyba.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Vyhledej fakturu podle čísla.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

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

Strukturovaný výstup s JSON schema

Předej JSON schema a odpověď ověř na své straně. Naše rada: ověřuj vždycky, i když se model většinou chová slušně.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Vytáhni jméno a částku."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

Hlavičky odpovědi: cena, úroveň a směrování

Každá odpověď ti řekne, co se stalo. Nejde o ladicí bonus, jde o podstatu: sám si ověříš, že jsi dostal to, za co jsi zaplatil.

Limity požadavků a stropy útraty

Platí limit na klíč a na účet a k tomu stropy, které si nastavíš sám. Ty druhé jsou důležitější, než to zní: bez stropu může uniklý klíč nebo nekonečná smyčka ve tvém vlastním kódu vyčerpat zůstatek přes noc.

• Požadavky za minutu, na klíč a na účet.
• Denní a měsíční strop v eurech, nastavitelný pro každý klíč.
• Nové účty: prvních 48 hodin nejvýš 25 € denně bez ohledu na zůstatek.
• Když během hodiny zaznamenáme víc než desetinásobek tvého týdenního průměru, klíč automaticky pozastavíme a pošleme ti e-mail. Radši jeden planý poplach než prázdná peněženka.
• Požadavek se spustí, jen když máš zůstatek aspoň 0,05 €.

Chybové kódy a co s nimi

Neúspěšné požadavky tě nic nestojí: pokud nepřišla použitelná odpověď, ze zůstatku se nic neodečte.

Férové používání a zásady používání

Odmítáme návody na zbraně, malware a podvody a materiál, který škodí dětem. Tato odmítnutí jsou konečná: takový požadavek nikdy nepřepošleme jinému modelu, abychom z něj odpověď přece jen vymáčkli.

Něco jiného je, když model odmítne legitimní otázku o politice, historii nebo společensky citlivém tématu: to bereme jako vadu a pošleme ji modelu bez tohoto slepého místa. Uvidíš to v hlavičce X-EU-Routed: censorship.

Jeden z našich modelů má licenci s vlastními zásadami používání. Ty platí v plném rozsahu: přesměrováním se licenční podmínky obejít nedají.

Nevíš jistě, jestli tvůj případ použití vyhovuje? Napiš na hello@europeanailab.eu. Odpověď předem je pro oba levnější než zablokovaný klíč potom.

Časté dotazy

Otázky, které nám chodí e-mailem dřív, než si kdokoli vytvoří klíč: s čím je API kompatibilní, kolik stojí požadavek a kde běží.

Přesun stávající integrace jsou tři řádky: klíč, base URL a název úrovně. Celá změna i to, co se přenést nedá, je v článku přechod na tři řádky. Ještě něco nejasného? Ceny jednotlivých úrovní najdeš v ceníku, model a licenci za každou úrovní na stránce Transparentnost AI a co se děje při výpadku na stránce stavu služby. Dvě delší čtení: kolik stojí AI API za token a kam tvoje prompty doopravdy jdou.