Crea la chiave in cinque passaggi
Per ottenere una chiave API Mimo per questo servizio, segui questi passaggi. Nulla qui richiede una carta o una telefonata.
- Registrati. Usa Google, o registrati con un indirizzo email e una password.
- Apri la pagina della chiave. Dopo la registrazione, vai alla pagina della chiave API. La tua chiave viene mostrata lì.
- Richiedi il credito di prova. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic su quella pagina. Il credito è valido per 7 giorni, non richiede carta ed è limitato a uno per persona.
- Copia la chiave e archiviala in un luogo sicuro, come un gestore di password o una variabile d'ambiente.
- Invia una richiesta di test con il comando curl nella sezione successiva.
Il servizio è un'API testuale ospitata compatibile con OpenAI. Esegue un unico modello a pesi aperti fornito da un provider indipendente, ottimizzato per rispondere senza rifiuti di contenuto per un uso adulto lecito. Non è l'API ufficiale di alcun fornitore di modelli. La tua chiave funziona con questo unico modello, il cui ID è uncensored, all'URL di base https://api.mimoapi.top/v1.
Testa la chiave con una richiesta
Esegui il test in un terminale prima di collegare la chiave alla tua app. Se fallisce qui, il problema è la chiave o l'account e non devi cercare nel tuo codice.
export LLM_API_KEY="paste-your-key-here"
curl -i https://api.mimoapi.top/v1/chat/completions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write one sentence about keys."}],
"max_tokens": 60
}'
Un buon risultato è uno stato 200 e un corpo JSON con un array choices. Le intestazioni contengono X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency. L'intestazione del saldo è un modo rapido per vedere quanto è costata la richiesta: eseguila due volte e confronta. Se vuoi solo confermare la chiave senza spendere nulla, chiama GET /v1/models con la stessa intestazione.
La stessa richiesta in Python, usando il pacchetto ufficiale OpenAI:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one sentence about keys."}],
max_tokens=60,
)
print(resp.choices[0].message.content)Cosa può e non può fare la chiave di prova
La prova serve per i test, non per la produzione. Una chiave di prova consente 2 richieste parallele e 60 richieste al minuto, con una durata di 7 giorni. Una chiave completa, che ottieni dopo aver aggiunto credito, consente 8 richieste parallele e 300 al minuto. Entrambe condividono lo stesso modello, la stessa finestra di contesto da 100.000 token e le stesse funzionalità: streaming su SSE, chiamata di funzioni, modalità JSON e i normali parametri di campionamento.
Quanto arriva con $0,50? A $0,15 per 1M token di input e $0,50 per 1M token di output, una richiesta con 1.000 token di input e 300 token di output costa 1.000 x $0,15 / 1.000.000 = $0,00015 per l'input più 300 x $0,50 / 1.000.000 = $0,00015 per l'output, che è $0,0003. Il credito copre circa 1.666 richieste di quelle dimensioni ($0,50 / $0,0003). È sufficiente per testare i prompt, creare un prototipo e provare lo streaming o gli strumenti.
Usa il credito di prova per le misurazioni. Scegli i cinque prompt che la tua app invierà più spesso, eseguili alcune volte e registra la variazione del saldo. Alla fine della settimana avrai un costo reale per richiesta e una visione di come il modello si comporta sui tuoi dati. Le richieste fallite o rifiutate non vengono addebitate.
Mantieni la chiave privata
Una chiave API è una password che spende anche denaro. Chiunque la abbia può eseguire richieste contro il tuo saldo. Alcune regole prevengono la maggior parte delle fughe di dati:
- Variabili d'ambiente, non file sorgente. Leggi la chiave con
os.environoprocess.env. Per il lavoro locale, un file.envelencato in.gitignoreva bene. - Solo lato server. Non chiamare l'API dal JavaScript del browser o da un'app mobile, perché chiunque può leggere la chiave dalla pagina o dal pacchetto dell'app. Metti un piccolo server tra il tuo front-end e l'API.
- Un unico posto per la chiave. Tieni la chiave in un unico archivio dei segreti e copiala in ogni deployment da lì, così sai sempre dove si trova.
- Nessuna chiave in chat, ticket o screenshot. Quando chiedi assistenza, condividi l'ID di richiesta
X-Request-Iddella risposta, non la chiave. - Sostituisci in caso di sospetto. Se pensi che una chiave sia stata esposta, smetti di usarla e contatta il supporto per farla sostituire.
Controlla anche l'intestazione X-Balance-USD. Un saldo che diminuisce mentre la tua app è inattivo è il primo segno che qualcun altro sta usando la tua chiave.
Vai oltre il credito di prova: ricarica e paga
Quando il credito di prova finisce, aggiungi credito. Funziona qualsiasi importo intero da $20 a $500. I bonus vengono aggiunti automaticamente: 5% da $50, 10% da $100 e 15% da $200. Quindi una ricarica di $100 dà $110 di credito, e $200 dà $230. Puoi pagare con cripto (USDT su TRC20, USDC su Base).
Non c'è abbonamento. Paghi per token dal tuo saldo e il credito non scade mai, il che si adatta ai progetti con traffico irregolare. L'elenco completo dei prezzi è nella pagina dei prezzi. I prompt inviati tramite l'API non vengono utilizzati per l'addestramento.
Una prima ricarica ragionevole è di $20. Con una richiesta di dimensioni simili a una chat usata in precedenza in questa pagina ($0,0003 ciascuna), questo copre circa 66.000 richieste. Verifica la tua media dopo alcuni giorni e regola.
Risoluzione dei problemi di una chiave che non funziona
La maggior parte dei problemi con le chiavi ha cause semplici.
- Errore di autenticazione subito. Un carattere è stato perso o aggiunto durante la copia. Cerca uno spazio iniziale o finale, o un a capo. Controlla che l'intestazione sia
Authorization: Bearerseguita dalla chiave. - Funziona in curl, non nella tua app. L'app probabilmente non sta leggendo la variabile d'ambiente. Stampa i primi quattro caratteri del valore che vede, non l'intera chiave.
- Non trovato. L'URL di base è errato. Deve essere
https://api.mimoapi.top/v1, sul sottodominioapi. La guida rapida contiene un elenco client per client. - HTTP 429. Il codice
concurrencysignifica troppe richieste contemporaneamente;rate_limitedsignifica troppe al minuto. Le chiavi di prova raggiungono questo limite prima (2 alla volta, 60 al minuto). Un 429 conRetry-After: 5significa sovraccarico breve; aspetta cinque secondi. - Credito di prova mancante. Il credito di prova si richiede con un clic nella pagina della chiave ed è uno per persona. Scade dopo 7 giorni.
Se nulla di tutto ciò lo risolve, raccogli il valore X-Request-Id da una risposta fallita e contatta il supporto con esso. Quell'ID permette di tracciare il problema senza inviare la chiave.
Cosa costruire per primo
Con una chiave funzionante, scegli un piccolo progetto che utilizzi le funzionalità che ti serviranno in seguito. Un loop di chat da riga di comando insegna la cronologia dei messaggi. Uno script che restituisce un oggetto JSON con response_format insegna l'output strutturato. Una funzione che il modello può chiamare insegna l'uso degli strumenti. Ognuno richiede meno di un'ora e ognuno funziona sul saldo di prova. Se stai valutando questo servizio rispetto ad altri modelli ospitati, il confronto nelle Alternative all'API Mistral elenca le domande da porsi prima di impegnarti.
Mantieni l'uso legale e riservato agli adulti. Il modello è ottimizzato per rispondere senza rifiuti di contenuti, ed è una caratteristica per la finzione, il roleplay e la ricerca, non un permesso per infrangere le regole: i contenuti sessuali che coinvolgono i minorenni non sono mai consentiti.
