Autenticazione
Chiavi API
Le richieste di inferenza si autenticano con una chiave API MartLLM. 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; MartLLM 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 i propri limiti, impostati 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 Keys o conPATCH /api/v1/keys/{id}. - Rate limit — un tetto di richieste al minuto (da 1 a 10,000). Vuoto significa il limite standard per chiave (300 al minuto).
- Non salvare le mie richieste e risposte — disattivato per impostazione predefinita: MartLLM conserva ogni richiesta e la sua risposta per 90 giorni per correggere le richieste fallite e rispondere alle domande di supporto. Attivalo e le chiamate effettuate con la chiave non verranno salvate. Conserviamo solo il registro di ogni chiamata (ora, modello, conteggio dei token, costo, l'indirizzo da cui proviene, i provider che abbiamo provato e qualsiasi errore che hanno restituito), non ciò che hai inviato o ciò che è tornato, quindi non possiamo esaminare una risposta errata per te. I lavori video e musicali conservano comunque la loro richiesta, quindi un lavoro che un provider interrompe può essere avviato di nuovo. Il provider che serve una richiesta la riceve in ogni caso. Impostalo sulla pagina Keys, o con
no_store(true/false) suPOST /api/v1/keysePATCH /api/v1/keys/{id};GET /api/v1/keyslo restituisce. - BYOK provider — associa la chiave per instradare tramite le tue credenziali del 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 MartLLM. 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
martllm.com, 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.