Configurazione API MiniMax: chiave, base URL e prima richiesta richiesta
Questa è una configurazione passo passo per l'API compatibile con OpenAI su minimaxapikey.com: account, chiave, base URL, prima richiesta. È un servizio indipendente, non l'API ufficiale di alcun fornitore di modelli.
Aggiornato

Punti chiave
- Registrati con Google o email, poi richiedi $0,50 di credito di prova nella pagina della chiave. Non serve la carta.
- Base URL è https://api.minimaxapikey.com/v1, model ID è uncensored, auth è una chiave Bearer.
- Esistono due metodi: POST /v1/chat/completions e GET /v1/models.
- Un 401 indica una chiave errata, e un 429 indica che è stato raggiunto un limite, quindi controlla il codice di errore nel corpo.
Cosa stai configurando
Le persone cercano configurazione API minimax aspettandosi una di due cose: la piattaforma ufficiale per sviluppatori MiniMax, o un endpoint di stile OpenAI pronto all'uso. Questa pagina copre la seconda. Il servizio dietro minimaxapikey.com è un'API testuale ospitata e compatibile con OpenAI che esegue un unico modello a pesi aperti, gestito da un provider indipendente. Non è l'API ufficiale di MiniMax o di qualsiasi altro fornitore di modelli, e non instrada le richieste tra fornitori. Se hai bisogno della piattaforma del fornitore, usa il loro sito.
Quello che ottieni è semplice. Qualsiasi SDK o client OpenAI funziona una volta modificato il base URL e la chiave. Ci sono due metodi, POST /v1/chat/completions e GET /v1/models, un unico model ID, uncensored, e una finestra di contesto da 100.000 token condivisa da prompt e completion. Gestisce solo testo, quindi non ci sono generazione di immagini, audio o video, né embeddings né fine-tuning. Sono supportati streaming, tool calling e modalità JSON.
L'intera configurazione richiede pochi minuti. I passaggi seguenti sono in ordine, e ognuno termina con un controllo così sai che ha funzionato prima di procedere.
Passaggi 1 e 2: crea un account e richiedi la prova
- Apri la pagina della chiave. Vai alla pagina della chiave API e accedi. Puoi usare Google, o un indirizzo email e una password.
- Richiedi il credito di prova. Dopo l'accesso, la pagina della chiave ha un pulsante per $0,50 di credito di prova. Richiede un clic, non serve la carta, è valido per 7 giorni ed è limitato a uno per persona.
La prova è piccola di proposito. A $0,15 per 1M di input token e $0,50 per 1M di output token, $0,50 copre un buon numero di richieste di test. Un prompt di 1.000 token con una risposta da 500 token costa $0,00015 per l'input più $0,00025 per l'output, che fa $0,0004. Dividendo $0,50 per quello ottieni 1.250 richieste di questo tipo, quindi hai molto spazio per sperimentare.
Nota i limiti della chiave di prova: 2 richieste parallele e 60 richieste al minuto. Una chiave completa, che ottieni dopo aver ricaricato, permette 8 richieste parallele e 300 al minuto. Se il tuo loop di test gira in parallelo e vedi errori 429, questo è il primo controllo da fare.
Passaggio 3: crea la chiave e conservala in modo sicuro
Nella stessa pagina, crea una chiave API e copiala. Trattala come una password. Mettila in una variabile d'ambiente o in un gestore di segreti, mai in un repository, un bundle front-end o uno screenshot. Se una chiave trapela, rimuovila e creane una nuova.
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
Il codice lato server dovrebbe leggere la variabile al runtime. Il codice del browser non dovrebbe mai contenere la chiave: invia le richieste dal tuo backend invece, perché tutto ciò che viene inviato al browser è visibile a ogni visitatore.
Passaggio 4: elenca i modelli per confermare la chiave
Il test più economico possibile è l'endpoint dei modelli. Non genera testo, quindi è un controllo pulito della chiave, dell'URL e della tua rete.
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
Dovresti ottenere un elenco JSON che include uncensored. Se ottieni un 401, la chiave è errata o ha uno spazio o una virgoletta di troppo intorno. Se la connessione fallisce, controlla che l'URL termini con /v1 e che tu abbia usato https.
Passaggio 5: invia la prima richiesta di chat
Ora una vera completion. Il corpo segue la struttura standard delle chat completions.
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
La risposta contiene choices[0].message.content e un blocco usage con i conteggi dei token di prompt e completion. Controlla anche le intestazioni di risposta con curl -i. Vedrai X-Request-Id, che il supporto può usare per trovare la tua richiesta, X-Balance-USD, il tuo credito residuo, e le intestazioni del limite di richieste X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency.
Parametri come temperature, top_p, stop, seed e le penalità vengono passati. max_tokens è facoltativo. Se lo ometti, la completion può utilizzare tutto ciò che rimane della finestra.
Passaggio 6: la stessa chiamata da un SDK
Una volta che curl funziona, passa al linguaggio che userai effettivamente. Solo due argomenti cambiano da una configurazione OpenAI standard.
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
Per lo streaming, aggiungi stream: true e leggi gli eventi inviati dal server. I numeri di utilizzo arrivano alla fine dello stream. La pagina docs copre lo streaming, la chiamata di funzioni e la modalità JSON con response_format: {"type":"json_object"}.
Spostamento di un progetto OpenAI esistente
La maggior parte del tempo il progetto che vuoi connettere funziona già con la libreria client di OpenAI. In quel caso raramente modifichi il codice. Gli SDK ufficiali leggono le variabili d'ambiente OPENAI_API_KEY e OPENAI_BASE_URL quando non passi argomenti, quindi un cambiamento di deployment può essere sufficiente.
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
L'unica modifica rimasta è il nome del modello. Una stringa come un ID modello OpenAI non esisterà qui, quindi sostituiscila con uncensored, idealmente tramite un valore di configurazione in modo da poter tornare indietro. Poi controlla il codice alla ricerca delle funzionalità che il servizio non offre. Generazione di immagini, audio, embeddings e fine-tuning non sono disponibili, perché questa è un'API di chat solo testo. Se la tua app chiama embeddings per la ricerca, avrai bisogno di un altro provider per quella parte e puoi mantenere la chat su questo.
Aiuta anche sapere qual è il modello. È un unico modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuto per uso adulto lecito, e un limite rigido si applica indipendentemente dalle impostazioni: nessun contenuto sessuale che coinvolga minorenni. I prompt scritti per un altro modello potrebbero richiedere piccole regolazioni, poiché ogni modello reagisce diversamente allo stesso system prompt. Esegui i tuoi prompt di test fianco a fianco prima di passare il traffico reale.
Impostazioni da scegliere il primo giorno
Alcune decisioni sono più facili da fare al momento della configurazione che dopo il lancio. Nessuna di esse è difficile, ma ognuna evita una sorpresa in seguito.
- Un prompt di sistema. Inserisci le tue istruzioni su tono, formato e ruolo in un messaggio
system. Tienilo breve e specifico, perché ogni richiesta lo ripete come token di input. - Un limite di token.
max_tokensè opzionale, ma un limite è una protezione economica. Senza di esso una singola risposta potrebbe usare il resto della finestra da 100.000 token. - Streaming per uso interattivo. Imposta
stream: truese una persona sta aspettando la risposta. Per i lavori batch, le richieste normali sono più semplici. - Una regola di retry per il 429. Tratta il 429 come un segnale di attesa, non come un fallimento. Quando la risposta include
Retry-After: 5, dormire per quel tempo e ritentare è la mossa giusta. - Dimensione della richiesta. Il limite del corpo è 8 MB. È molto più di quanto un normale prompt abbia bisogno, ma i log incollati o i documenti possono raggiungerlo.
I prompt non vengono usati per l'addestramento, il che è importante se prevedi di inviare documenti interni o messaggi utente. Sei ancora tu il responsabile di ciò che invii, quindi evita di inserire segreti che il modello non deve conoscere in un prompt.
Ricarica dopo la prova
La prova serve a verificare che tutto funzioni. Quando sei pronto per costruire, aggiungi credito prepagato. Non c'è abbonamento: paghi per i token usati, a $0,15 per 1M di input token e $0,50 per 1M di output token, e il credito non scade mai, quindi un saldo inutilizzato non svanisce alla fine del mese.
Qualsiasi importo intero da $20 a $500 funziona. Un ricarico di $50 aggiunge un bonus del 5%, $100 aggiunge il 10% e $200 aggiunge il 15%. Come esempio rapido, un ricarico di $100 con il suo bonus del 10% dà $110 di credito. Al prompt da 1.000 token e alla risposta da 500 token del passaggio due, ogni richiesta costa $0,0004, quindi $110 copre 275.000 richieste. I prompt reali sono di solito più lunghi, quindi scala quella cifra alla tua media.
Risoluzione degli errori comuni di configurazione
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| 401 su ogni chiamata | Chiave mancante, digitata male o revocata | Invia Authorization: Bearer <key>, senza virgolette extra |
| Risposta 404 o HTML | Percorso errato, solitamente una mancanza di /v1 | Usa il base URL completo che termina con /v1 |
| Modello non trovato | Un nome del modello copiato da un altro provider | Usa uncensored |
429 con rate_limited | Superato il limite di richieste al minuto | Rallenta, o ricarica per passare dai limiti di prova ai limiti completi |
429 con concurrency | Troppe richieste contemporaneamente | Limita le chiamate parallele a 8 (2 su una chiave di prova) |
429 con Retry-After: 5 | Sovraccarico temporaneo | Attendi 5 secondi e ritenta |
| 413 o corpo rifiutato | Richiesta superiore a 8 MB | Riduci il prompt o dividi il lavoro |
Quando sei pronto per più della prova, la pagina prezzi elenca le opzioni di ricarico: qualsiasi importo intero da $20 a $500, pagato con cripto (USDT su TRC20, USDC su Base), con un bonus del 5% da $50, 10% da $100 e 15% da $200. Le richieste fallite o rifiutate non vengono addebitate e i prompt non vengono utilizzati per l'addestramento.
Altre guide
Domande e risposte
È questa l'API ufficiale di MiniMax?
No. È un'API indipendente, ospitata e compatibile con OpenAI che serve un unico modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale. Non è l'API ufficiale di alcun fornitore di modelli e non è un router tra fornitori.
Ho bisogno di una carta di credito per provarlo?
No. Dopo la registrazione puoi ottenere $0,50 di credito di prova gratuito con un clic nella pagina della chiave API. È valido per 7 giorni ed è limitato a uno per persona.
Qual è il nome del modello da usare nelle richieste?
Usa uncensored. Il servizio espone questo singolo ID modello e GET /v1/models lo mostrerà.
Come posso aggiungere altro credito in seguito?
Ricarica qualsiasi importo intero da $20 a $500. I bonus si applicano da $50 (+5%), $100 (+10%) e $200 (+15%), e il credito non scade mai.
Posso usare l'SDK OpenAI?
Sì. Imposta base_url su https://api.minimaxapikey.com/v1, usa la tua chiave e invia model uncensored. Nient'altro nel tuo codice deve cambiare.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.