En rad kod, och du kör inom Europeiska unionen.

Snabbstart: ditt första API-anrop

Skapa en nyckel i din dashboard under Inställningar, API-nycklar. Du ser hemligheten exakt en gång. Därefter sparar vi bara en hash och prefixet. Lägg den i en miljövariabel, aldrig i ditt 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": "Förklara omvänd skattskyldighet för moms."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # den enda raden som ändras
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Förklara omvänd skattskyldighet för moms."}],
)
print(resp.choices[0].message.content)

Modellnivåer och kontextfönster

Du anger en nivå i fältet model, inte ett modellnamn. Då fortsätter din integration att fungera när vi byter modellen under, och det kommer vi att göra, eftersom open-weight-modeller pensioneras och blir omsprungna.

Går du över en nivås kontextfönster får du en 400 med maxvärdet i: vi kortar aldrig tyst av din prompt.

Strömmade svar

Streaming fungerar som du förväntar dig, med en viktig skillnad som du behöver känna till eftersom den gäller dina pengar.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Skriv en sammanfattning."}],
    stream=True,
    # Utan detta finns inget usage-objekt och du ser inte kostnaden.
    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:                      # sista chunken
        print("\n", chunk.usage)

Avbryter du en ström halvvägs betalar du bara för det som genererats fram till dess. Om den brutna anslutningen gör att ingen usage-chunk kommer fram uppskattar vi förbrukningen och rättar den i den dagliga avstämningen med vår leverantör. En sådan rad står som estimated i din förbrukningsöversikt tills den är avstämd.

Function calling och verktyg

Verktyg följer det välkända schemat. Om en modell producerar ett verktygsanrop som inte matchar ditt schema loggar vi det: i version 1 rättar vi det inte i tysthet, eftersom att i smyg laga din output är värre än ett synligt fel.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Slå upp en faktura via fakturanummer.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

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

Strukturerad output med ett JSON schema

Skicka med ett JSON schema och validera svaret på din sida. Vårt råd: validera alltid, även när modellen oftast sköter sig.

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

Svarshuvuden: kostnad, nivå och routing

Varje svar berättar vad som hände. Det är ingen extrafunktion för felsökning, det är själva poängen: du kan själv kontrollera att du fick det du betalade för.

Rate limits och kostnadstak

Det finns en gräns per nyckel och per konto, plus de tak du sätter själv. De senare betyder mer än det låter: utan tak kan en läckt nyckel eller en oändlig loop i din egen kod tömma ett saldo över en natt.

• Anrop per minut, per nyckel och per konto.
• Dags- och månadstak i euro, inställbart per nyckel.
• Nya konton: högst 25 € per dag de första 48 timmarna, oavsett saldo.
• Ser vi mer än tio gånger ditt veckosnitt inom en timme pausar vi nyckeln automatiskt och mejlar dig. Hellre ett falskt larm än en tom plånbok.
• Ett anrop startar bara när ditt saldo är minst 0,05 €.

Felkoder och vad du gör

Misslyckade anrop kostar dig ingenting: kom inget användbart svar tillbaka dras inget från ditt saldo.

Skälig användning och användarpolicy

Vi vägrar instruktioner för vapen, skadlig kod och bedrägeri, och material som skadar barn. De vägranden är slutgiltiga: vi skickar aldrig en sådan förfrågan vidare till en annan modell för att ändå få fram ett svar.

När en modell vägrar en legitim fråga om politik, historia eller ett samhällskänsligt ämne är det en annan sak: det ser vi som en brist, och vi skickar frågan till en modell utan den blinda fläcken. Du ser det i huvudet X-EU-Routed: censorship.

En av våra modeller är licensierad med en egen användarpolicy. Den policyn gäller fullt ut: omdirigering kringgår inga licensvillkor.

Osäker på om ditt användningsfall passar? Mejla hello@europeanailab.eu. Ett svar i förväg är billigare för oss båda än en blockerad nyckel i efterhand.

Vanliga frågor

Frågorna som kommer per mejl innan någon skapar en nyckel: vad API:et är kompatibelt med, vad ett anrop kostar och var det körs.

Att flytta en befintlig integration är tre rader: nyckeln, bas-URL:en och ett nivånamn. Hela ändringen, plus det som inte följer med, finns i byt på tre rader. Fortfarande frågor? Priserna per nivå finns på prissidan, modellen och licensen bakom varje nivå under AI-transparens och vad som händer vid ett avbrott på statussidan. Två längre texter: vad ett AI-API kostar per token och vart dina prompter faktiskt tar vägen.