Migrazione

Un URL di base e una chiave spostano un client OpenAI. Questa pagina dichiara anche cosa l'API non fa, perché una migrazione che lo scopre in produzione non è una migrazione.

La forma drop-in

Punta l'URL di base del client a https://api.llmeu.com/v1 e dagli una chiave API dalla console. La forma della richiesta non cambia.

from openai import OpenAI

client = OpenAI(base_url="https://api.llmeu.com/v1", api_key="llmeu_live_xxxxxxxx.your-secret")

resp = client.chat.completions.create(
    model="llmeu-auto",
    messages=[{"role": "user", "content": "Say hello from EU hosting."}],
)
print(resp.choices[0].message.content)

Cosa accetta l'endpoint di chat

Il validatore delle richieste in apps/api/src/app.mjs controlla quanto segue; ciò che non controlla viene passato o ignorato anziché rifiutato, così un client più recente continua a funzionare.

model e messages sono obbligatori; messages deve essere un array non vuoto.
Ogni messaggio necessita di un ruolo (system, user, assistant, tool o developer) e contenuto come stringa o array di parti.
stream deve essere un booleano quando presente.
temperature, top_p, max_tokens, presence_penalty, frequency_penalty, seed e n devono essere numeri quando presenti.
max_tokens deve essere almeno 1.
n deve essere esattamente 1; qualsiasi altro valore viene rifiutato.
stop può essere una stringa o un array di stringhe.
tools deve essere un array quando presente.
llmeu deve essere un oggetto; non è mai obbligatorio.
tool_choice e response_format vengono inoltrati al backend insieme ai campi sopra; un campo extra sconosciuto non viene rifiutato.

Extra della richiesta sotto llmeu

Un oggetto llmeu con namespace nel corpo della richiesta; un client che ignora i campi sconosciuti può inviarlo in sicurezza.

Campo	Valore	Effetto
residency	eu-hosted \| eu-owned \| de \| any	Restringe il routing agli endpoint in quella residenza; un insieme ammissibile vuoto restituisce 409 no_endpoint_for_policy invece di ampliare il filtro.
task	un nome di attività	L'attività a cui il router adatta il modello.
retention	zero	Solo zero è implementato. Richiedere più di quanto consenta la policy restituisce 403 retention_exceeds_policy; un valore effettivo consentito diverso da zero restituisce 501 retention_not_implemented.
data_class	public \| internal \| confidential \| restricted	Verificato rispetto alle classi di dati consentite dalla policy: una classe al di fuori di esse restituisce 403 data_class_not_allowed, e una classe sconosciuta restituisce 400 invalid_data_class.
policy_id	uuid	Nomina una policy della stessa organizzazione; un id sconosciuto restituisce 404 policy_not_found.
max_usd_per_1m	un numero	Un tetto di prezzo per milione di token per questa richiesta.
allow_partners	true \| false	Se gli endpoint dei partner possono essere usati per questa richiesta.

Le chiavi sconosciute all'interno di llmeu vengono ignorate; una chiave nota con un valore non valido viene rifiutata, perché una data_class errata deve fallire in modo chiuso anziché significare silenziosamente nessuna classe di dati.

curl https://api.llmeu.com/v1/chat/completions \
  -H "Authorization: Bearer $LLMEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llmeu-auto",
    "messages": [{"role": "user", "content": "Summarise this contract."}],
    "llmeu": {"residency": "eu-owned", "data_class": "confidential", "retention": "zero"}
  }'

Cosa non esiste

Queste risposte sono intenzionali, e un client che se le aspetta vede il codice di errore invece di una sostituzione silenziosa.

Richiesta	Risultato
POST /v1/completions	501 `not_implemented` — l'endpoint legacy delle completions non è offerto; usare /v1/chat/completions.
n > 1	400 `unsupported_n` — è supportato solo n = 1.
POST /v1/embeddings	Gli embeddings richiedono un modello di embedding, e l'id richiesto predefinito è bge-m3. Nessuno viene servito in questo deployment, quindi la route non è offerta qui invece di restituire vettori segnaposto.
/v1/files, /v1/batches, /v1/assistants, /v1/fine_tuning, /v1/audio, /v1/images	404 `unknown_route` — non instradato affatto; un percorso /v1 che il router non conosce risponde 404 unknown_route, e qualsiasi altro percorso risponde 404 not_found.

Esportare i tuoi dati

L'esportazione dell'account me.json contiene campi selezionati dell'account, organizzazioni, metadati delle chiavi API senza segreti, policy correnti, le ultime 200 tracce per organizzazione e aggregati di utilizzo giornaliero per 365 giorni. Non è una copia completa di tutti i dati personali e non è un registro storico delle policy.

L'esportazione di audit NDJSON è predefinita a 7 giorni, consente al massimo 90 giorni e limita le tracce a 5000; il suo manifest contiene counts.truncated, che contrassegna un'esportazione che ha raggiunto il limite.

GET /app/exports/me.json
GET /app/exports/audit.ndjson?days=7
GET /app/exports/traces.json
GET /app/exports/usage.json
GET /app/exports/policies.json

L'eliminazione dell'account stesso avviene nella pagina del profilo ed è soggetta alla regola di proprietà nella pagina della console.

Un cookie di sessione non è una credenziale API

Una sessione del browser autentica la console, non l'API. Un client OpenAI che ne invia una viene rifiutato con 403 api_key_required e deve invece usare una chiave API.

Un rifiuto qui indica un codice, quindi una migrazione può ramificare su di esso, e il blocco llmeu su ogni risposta dice cosa è realmente successo.