MiniMax api: Guida rapida e SDK

Autenticazione e Base URL

Utilizza la chiave API fornita e punta il tuo client all'URL base dedicato. L'endpoint per generare le risposte è https://api.minimaxaiapi.com/v1/chat/completions. Trasmetti la chiave nel Authorization header come token bearer. Questo funziona con qualsiasi SDK OpenAI standard perché seguiamo lo stesso protocollo.

• Nome intestazione: Authorization
• Valore intestazione: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Non è necessaria una configurazione complessa. Aggiorna semplicemente la configurazione nel tuo progetto esistente.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Endpoint Chat Completions

Invia una richiesta POST all'endpoint di completamento della chat per ottenere una risposta testuale. L'identificatore del modello è uncensored. Devi includere un array messages con la cronologia della tua conversazione. Il sistema elabora l'input e restituisce il testo generato in base al tuo prompt.

Questo endpoint gestisce tutta la generazione di testo. Non supporta embedding, audio o video. Puoi trasmettere le risposte o attendere il blocco completo. Il modello gestisce un contesto fino a 100,000 token in totale.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.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)

Streaming e Utilizzo dei Token

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per ogni token generato. Questo consente la visualizzazione in tempo reale dell'output. Le statistiche di utilizzo dei token sono incluse nell'ultimo chunk dello stream. Questo ti aiuta a monitorare i costi con precisione senza analizzare ogni singolo token.

Lo streaming riduce la latenza percepita per le risposte lunghe. È ideale per le interfacce chat e la generazione di contenuti dinamici. Puoi interrompere lo stream anticipatamente se l'utente interrompe la generazione.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.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);

Function Calling e modalità JSON

Usa il tools parametro per abilitare la chiamata delle funzioni. Definisci le tue funzioni nel corpo della richiesta e lascia che il modello scelga quale chiamare. Il tool_choice il parametro ti permette di forzare una funzione specifica o di selezionare automaticamente. Per un output JSON rigoroso, imposta response_format a {"type": "json_object"}. Questo garantisce che la risposta sia JSON valido.

Il function calling è utile per estrarre dati strutturati o attivare azioni. La modalità JSON è perfetta per le integrazioni API che richiedono formati prevedibili. Combina entrambe le funzionalità per una logica di applicazione robusta.

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)

Parametri del modello e vincoli

Regola il comportamento di generazione utilizzando parametri standard come temperature, top_p, e stop. La finestra di contesto massima è di 100.000 token, inclusi prompt e completamento. L'output massimo per richiesta è di 16.000 token. Se non imposti max_tokens, il limite predefinito è 2.048 token.

Usa seed per risultati riproducibili. Imposta presence_penalty e frequency_penalty per controllare la ripetizione. Questi parametri ti danno un controllo fine sulla creatività e sulla coerenza del modello. Testa sempre con il tuo caso d'uso specifico per trovare il giusto equilibrio.

Limiti di frequenza e errori

L'API impone un limite di 300 richieste al minuto e 8 richieste concorrenti per chiave. Se superi questi limiti, riceverai un errore 429. Un errore 401 indica una chiave API non valida o mancante. Un errore 402 significa che il tuo credito prepagato è esaurito.

Gli errori non consumano il tuo credito. Puoi ritentare le richieste fallite senza penalità. La dimensione del corpo della richiesta è limitata a 8 MB. Gestisci attentamente la concorrenza per evitare il throttling. Monitora il tuo utilizzo tramite l'ultimo chunk delle risposte in streaming.