IT ▾
mimoapi.topAPI compatibile con OpenAI senza censura per gli sviluppatori
uncensoredhttps://api.mimoapi.top/v1

Chiave API Mimo: creala ed effettua una richiesta

Puoi avere una chiave funzionante in pochi minuti: registrati con Google o email, richiedi il credito di prova da $0,50 nella pagina della chiave, copia la chiave e invia una richiesta di test. Questa guida copre ogni passaggio e cosa fare dopo.

Aggiornato

Chiave dorata su un piedistallo davanti a un terminale astratto, illustrante la creazione di una chiave API per un servizio LLM

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.

  1. Registrati. Usa Google, o registrati con un indirizzo email e una password.
  2. Apri la pagina della chiave. Dopo la registrazione, vai alla pagina della chiave API. La tua chiave viene mostrata lì.
  3. 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.
  4. Copia la chiave e archiviala in un luogo sicuro, come un gestore di password o una variabile d'ambiente.
  5. 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.environ o process.env. Per il lavoro locale, un file .env elencato in .gitignore va 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-Id della 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: Bearer seguita 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 sottodominio api. La guida rapida contiene un elenco client per client.
  • HTTP 429. Il codice concurrency significa troppe richieste contemporaneamente; rate_limited significa troppe al minuto. Le chiavi di prova raggiungono questo limite prima (2 alla volta, 60 al minuto). Un 429 con Retry-After: 5 significa 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.

Domande e risposte

Come ottengo una chiave API Mimo?

Iscriviti con Google o con email e password, poi apri la pagina della chiave API e copia la tua chiave. Puoi richiedere il credito di prova di $0,50 lì con un clic, senza carta.

La chiave API è gratuita?

La chiave stessa non costa nulla. I nuovi utenti ricevono $0,50 di credito di prova valido per 7 giorni, uno per persona. Dopo di che paghi per token dal credito prepagato, partendo da un ricarico di $20.

Per quanto tempo è valido il credito di prova?

Sette giorni dal momento in cui lo richiedi. È $0,50, non richiede carta ed è limitato a uno per persona. Dopo di che, le richieste necessitano di credito ricaricato.

Dove inserisco la chiave nella richiesta?

Nell'intestazione Authorization, come Bearer seguito dalla chiave. Gli SDK OpenAI lo fanno automaticamente quando passi la chiave come api_key.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API