API MiniMax: prima richiesta in cinque minuti

Installa l'SDK OpenAI

Inizia installando l'SDK ufficiale OpenAI per il tuo linguaggio preferito. La libreria gestisce automaticamente la formattazione delle richieste e lo streaming. Assicurati di avere Python 3.8+ o Node.js 18+ installati. Esegui pip install openai per Python o npm install openai per Node. L'SDK semplifica l'interazione con l'endpoint /v1/chat/completions. Gestisce le intestazioni, i retry e l'analisi SSE così puoi concentrarti sul prompt. Funziona perché la nostra API segue lo standard OpenAI chat completions. Non hai bisogno di una libreria client personalizzata. I metodi SDK standard mappano direttamente ai nostri endpoint. Questo riduce i tempi di integrazione e sfrutta le conoscenze esistenti degli sviluppatori.

Configura URL base e chiave

Imposta la tua chiave API e l'URL base nelle variabili di ambiente. Il nostro URL base è https://api.minimaxapikey.com/v1. Questo ti permette di usare client OpenAI standard senza modifiche. Crea un account per generare la tua chiave. La chiave viene mostrata subito dopo la registrazione. Non serve la carta per la prova. Memorizza la chiave in modo sicuro. Passala come intestazione o variabile di ambiente. L'SDK usa OPENAI_API_KEY di default. Puoi sovrascrivere l'URL base per puntare ai nostri server. Questo assicura che tutte le richieste vadano al modello senza censura. Verifica che la tua chiave funzioni con un semplice ping. Questo passaggio previene errori di autenticazione in seguito.

Invia una chat completion di base

Esegui la tua prima richiesta per generare testo. Usa il metodo POST su /v1/chat/completions. Specifica il modello come uncensored. Passa un array di messaggi con un prompt utente. L'API restituisce un token di completamento. Questa è la funzione principale di generazione di testo. Supporta una finestra di contesto da 100k. Puoi inviare prompt lunghi o cronologie delle conversazioni. La risposta include il testo generato e l'utilizzo dei token. È ideale per la scrittura creativa o il dialogo senza restrizioni. Assicurati che il contenuto sia legale. Il modello non rifiuta argomenti per adulti. Blocca solo i contenuti sessuali che coinvolgono minori. Inizia in modo semplice per verificare la connettività.

Abilita lo streaming (SSE)

Per l'output in tempo reale, abilita lo streaming. Imposta il parametro stream su true. L'API restituisce Server-Sent Events (SSE). Ogni chunk contiene parte della risposta. Questo riduce la latenza percepita. Gli utenti vedono il testo apparire mentre viene generato. L'SDK gestisce automaticamente l'analisi degli chunk. Puoi visualizzare il testo in modo incrementale in un'interfaccia utente. È cruciale per le interfacce chat. Lo streaming funziona con tutte le risposte del modello. Non influisce sul conteggio dei token. Ogni chunk include i dati di utilizzo alla fine. Usalo per una migliore esperienza utente. Sembra più reattivo rispetto all'attesa della risposta completa. Configura il tuo client per memorizzare correttamente gli chunk.

Usa la chiamata di funzioni

Supporta output strutturati con la chiamata di funzioni. Definisci gli strumenti nel corpo della richiesta. Il modello può chiamare funzioni in base al prompt. Questo abilita l'integrazione con sistemi esterni. Passa le definizioni degli strumenti e i messaggi utente. La risposta include un oggetto di chiamata di funzione. Esegui la funzione e invia di nuovo i risultati. Questo funziona con gli SDK OpenAI standard. Permette flussi di lavoro complessi. Puoi costruire agenti o assistenti. Il modello mantiene il contesto tra le chiamate. È potente per l'automazione. Assicurati che le definizioni degli strumenti siano precise. L'API gestisce il routing degli output degli strumenti. Mantiene coerente la conversazione. Usalo per la generazione di contenuti dinamici.

Verifica i modelli disponibili

Verifica l'elenco dei modelli tramite GET /v1/models. Questo endpoint restituisce i modelli disponibili. La nostra API serve un modello: uncensored. È un modello a pesi aperti. Non è GPT, Claude o Gemini. La risposta conferma l'ID del modello. Usalo per debug delle configurazioni client. Assicurati che il tuo codice punti al modello corretto. L'endpoint è veloce e affidabile. Restituisce dati JSON. Puoi analizzarlo per le visualizzazioni UI. Conferma che la tua chiave API sia valida. Usalo per controlli di integrità automatizzati. Fa parte dello standard OpenAI. Non serve configurazione extra. Questo assicura la compatibilità con gli strumenti esistenti.

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)