Jedna linijka kodu i działasz w Unii Europejskiej.

Szybki start: pierwsze wywołanie API

Utwórz klucz w swoim panelu w Ustawieniach, w sekcji Klucze API. Sekret zobaczysz dokładnie raz. Potem przechowujemy już tylko jego hash i prefiks. Trzymaj go w zmiennej środowiskowej, nigdy w repozytorium.

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": "Wyjaśnij mechanizm odwrotnego obciążenia w VAT."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # jedyna linijka, która się zmienia
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Wyjaśnij mechanizm odwrotnego obciążenia w VAT."}],
)
print(resp.choices[0].message.content)

Tiery modeli i okna kontekstu

W polu model podajesz tier, a nie nazwę modelu. Dzięki temu twoja integracja działa dalej, gdy wymienimy model pod spodem. A wymienimy, bo modele open-weight są wycofywane i wyprzedzane przez nowsze.

Jeśli przekroczysz okno kontekstu tieru, dostaniesz 400 z podanym maksimum: nigdy nie obcinamy twojego promptu po cichu.

Streaming odpowiedzi

Streaming działa tak, jak się spodziewasz, z jedną ważną różnicą, o której musisz wiedzieć, bo dotyczy twoich pieniędzy.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Napisz podsumowanie."}],
    stream=True,
    # Bez tego nie ma obiektu usage i nie widzisz kosztu.
    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:                      # ostatni chunk
        print("\n", chunk.usage)

Jeśli przerwiesz strumień w połowie, płacisz tylko za to, co zostało wygenerowane do tego momentu. Jeśli przez zerwane połączenie nie dotrze chunk z zużyciem, szacujemy je i korygujemy w codziennym uzgodnieniu z naszym dostawcą. Do czasu rozliczenia taka pozycja ma w twoim przeglądzie zużycia status estimated.

Function calling i narzędzia

Narzędzia korzystają ze znanego schematu. Jeśli model wygeneruje wywołanie narzędzia niezgodne z twoim schematem, logujemy to: w wersji 1 nie poprawiamy tego po cichu, bo ciche naprawianie twojego wyniku jest gorsze niż widoczny błąd.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Wyszukaj fakturę po numerze.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

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

Ustrukturyzowane odpowiedzi ze schematem JSON

Przekaż schemat JSON i waliduj odpowiedź po swojej stronie. Nasza rada: waliduj zawsze, nawet jeśli model zwykle działa poprawnie.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Wyciągnij imię i nazwisko oraz kwotę."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

Nagłówki odpowiedzi: koszt, tier i routing

Każda odpowiedź mówi, co się stało. To nie dodatek do debugowania, tylko sedno sprawy: możesz sam sprawdzić, że dostałeś to, za co zapłaciłeś.

Limity zapytań i limity wydatków

Jest limit na klucz i na konto, do tego limity, które ustawiasz sam. Te drugie są ważniejsze, niż się wydaje: bez limitu wyciek klucza albo nieskończona pętla we własnym kodzie potrafi wyczyścić saldo w ciągu jednej nocy.

• Zapytania na minutę, na klucz i na konto.
• Dzienny i miesięczny limit w euro, ustawiany osobno dla każdego klucza.
• Nowe konta: maksymalnie 25 € dziennie przez pierwsze 48 godzin, niezależnie od salda.
• Jeśli w ciągu godziny zobaczymy ponad dziesięciokrotność twojej średniej tygodniowej, automatycznie wstrzymujemy klucz i wysyłamy ci maila. Lepiej jeden fałszywy alarm niż pusty portfel.
• Zapytanie startuje dopiero wtedy, gdy masz na saldzie co najmniej 0,05 €.

Kody błędów i co z nimi zrobić

Nieudane zapytania nic cię nie kosztują: jeśli nie wróciła żadna użyteczna odpowiedź, nic nie schodzi z twojego salda.

Fair use i zasady korzystania

Odmawiamy instrukcji dotyczących broni, złośliwego oprogramowania i oszustw oraz materiałów krzywdzących dzieci. Te odmowy są ostateczne: nigdy nie przekazujemy takiego zapytania do innego modelu, żeby jednak wyciągnąć z niego odpowiedź.

Czym innym jest sytuacja, gdy model odmawia odpowiedzi na uzasadnione pytanie o politykę, historię albo drażliwy temat społeczny: traktujemy to jako wadę i wysyłamy zapytanie do modelu bez tej ślepej plamki. Widzisz to w nagłówku X-EU-Routed: censorship.

Jeden z naszych modeli ma licencję z własnymi zasadami korzystania. Te zasady obowiązują w całości: przekierowanie nie omija warunków licencji.

Nie wiesz, czy twój przypadek użycia się mieści? Napisz na hello@europeanailab.eu. Odpowiedź z góry jest tańsza dla obu stron niż zablokowany klucz po fakcie.

Najczęściej zadawane pytania

Pytania, które przychodzą mailem, zanim ktokolwiek utworzy klucz: z czym API jest zgodne, ile kosztuje zapytanie i gdzie to działa.

Przeniesienie istniejącej integracji to trzy linijki: klucz, base URL i nazwa tieru. Całą zmianę, łącznie z tym, czego nie da się przenieść, opisujemy w tekście przejście w trzech linijkach. Coś jeszcze niejasne? Stawki za każdy tier są w cenniku, model i licencja za każdym tierem na stronie Przejrzystość AI, a to, co dzieje się podczas awarii, na stronie statusu. Dwie dłuższe lektury: ile kosztuje API AI za token i dokąd naprawdę trafiają twoje prompty.