Autenticazione
Chiavi API
Le richieste di inferenza si autenticano con una chiave API UberLLM. Le chiavi iniziano con ull_
seguito da un suffisso casuale. Passala come bearer token:
Authorization: Bearer ull_your_key_here
L'interfaccia Anthropic accetta la chiave anche nell'header x-api-key.
La tua prima chiave viene creata per te alla tua prima visita alla dashboard e mostrata lì con una prima chiamata che puoi incollare. Crea, modifica, elenca ed elimina le chiavi sotto Dashboard → API Keys. Il segreto completo viene mostrato una sola volta al momento della creazione — conservalo immediatamente; UberLLM conserva solo un hash e non potrà mai mostrarlo di nuovo. L'eliminazione di una chiave (Dashboard → API keys → Delete) ha effetto immediato: le app che la utilizzano smettono di funzionare e il suo utilizzo passato rimane nei tuoi totali.
Controlli per chiave
Ogni chiave può avere le proprie regole di protezione, impostate al momento della creazione o successivamente con Modifica su Dashboard → API keys. Una modifica si applica alla richiesta successiva della chiave.
- Limite di spesa — un tetto in USD su un periodo di
daily,monthlyolifetime. Le richieste che lo supererebbero vengono rifiutate con402 key_spend_cap_exceeded. Vuoto significa nessun limite. - Limite giornaliero —
daily_limit_usd, in aggiunta al limite di spesa. Una richiesta deve rientrare in entrambi, e il limite giornaliero si resetta a mezzanotte UTC. Una richiesta che supera uno dei due limiti viene rifiutata con402 key_spend_cap_exceedede non viene addebitato nulla. Impostalo sulla pagina Chiavi o conPATCH /api/v1/keys/{id}. - Limite di frequenza — un tetto di richieste al minuto (da 1 a 10,000). Vuoto significa il limite standard per chiave (300 al minuto).
- Provider BYOK — blocca la chiave per instradare tramite le tue credenziali di provider (vedi sotto).
Email saldo basso
Su Dashboard → Crediti puoi richiedere di ricevere un'email quando il tuo saldo scende al di sotto di un importo da te scelto. È disattivata per impostazione predefinita, invia un'email ogni volta che il saldo scende al di sotto di quell'importo e viene inviata ai proprietari dell'account. Se il denaro accantonato per una richiesta di immagine, video, musica o parlato è ancora trattenuto 15 minuti dopo la fine del lavoro, i proprietari dell'account ricevono un'email che elenca tali lavori e il nostro team viene informato. Quel denaro è ancora tuo e verrà rilasciato.
BYOK — porta la tua chiave
Aggiungi una credenziale di provider sotto Dashboard → BYOK. Le richieste instradate tramite un provider BYOK utilizzano direttamente la tua credenziale; nessun credito viene riservato e il costo per token è zero sul tuo saldo UberLLM. Le credenziali memorizzate sono crittografate e vengono mostrate solo come un ultimo-4 mascherato.
Sessioni della Dashboard
Accedi alla dashboard web con Google (un clic: il prompt "Continua come" su
uberllm.dev, o il pulsante Google), o con la tua email: ti inviamo un
codice di 6 cifre (e un link di accesso) che scade in 15 minuti. Non c'è nessuna
password. L'accesso crea una sessione di breve durata, memorizzata in un cookie httpOnly. Questa sessione è separata dalle tue
ull_ chiavi di inferenza — gli endpoint della dashboard sotto /api/v1/* usano il cookie;
il gateway (/v1/*) usa la API key.
Errori
I fallimenti di autenticazione restituiscono un envelope di errore in stile OpenAI:
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
Vedi Errori e limiti per l'elenco completo.