Come usare Xiaomi MiMo v2.6 Pro su AIHubMix: guida alla configurazione

Aggiornamento (23 ottobre 2026): mimo-v2.5-pro è stato ritirato il 21 ottobre 2026 e AIHubMix non accetta più richieste per questo modello. Usa mimo-v2.6-pro, che ha lo stesso costo.

In breve: imposta l'endpoint ufficiale openai Python SDK su https://aihubmix.com/v1, usa l'ID modello mimo-v2.6-pro e autentica le richieste con la tua chiave AIHubMix. L'API è compatibile con OpenAI (le chiamate usano lo stesso formato di OpenAI), quindi non serve un client speciale. La configurazione richiede circa cinque minuti.

Punti chiave

• API compatibile con OpenAI — modifica base_url, nient'altro
• A pagamento mimo-v2.6-pro · gratuito xiaomi-mimo-v2.6-pro-free [1] [2]
• $0.48/M in input · $0.96/M in output [1]
• Piano gratuito 5 richieste/min · 100/giorno · 1M token/giorno [2]
• Contesto 1.05M token · output massimo 131K token [1]
• Requisiti: Python 3.9+, una chiave API AIHubMix

Valori di riferimento

Meglio usare v2.6 Pro o v2.5 Pro?

Usa v2.6 Pro. Costa uguale e accetta più tipi di input.

Le note di rilascio di Xiaomi affermano che V2.6 «adotta gli stessi prezzi API della serie V2.5» e assegnano a V2.6-Pro 46 punti nell'Artificial Analysis Intelligence Index — il punteggio più alto tra i modelli open source al momento della stesura, superiore a Kimi K3 e Qwen3.8 Max e inferiore a Claude Fable 5.1 e GPT-6 Astra [4]. Il confronto più chiaro tra una generazione e l'altra nelle note riguarda il modello meno costoso: V2.6-Flash «ha superato nettamente MiMo-V2.5-Pro» [4].

Due aspetti da tenere a mente. Xiaomi non ha pubblicato una tabella di benchmark che confronti direttamente V2.6-Pro e V2.5-Pro, quindi il confronto qui sopra riguarda specifiche e prezzo. Inoltre, mimo-v2.5-pro è programmato per il ritiro il 21 ottobre 2026, con mimo-v2.6-pro indicato come modello di migrazione [5], quindi qualsiasi nuovo progetto basato su v2.5 dovrebbe essere migrato quasi subito.

Perché AIHubMix

• Devi modificare solo base_url. Il gateway usa il formato OpenAI Chat Completions, quindi l'SDK ufficiale funziona senza modifiche. Con la stessa chiave sono disponibili anche il formato Anthropic /v1/messages (beta) e le chiamate Gemini native [6].
• Una sola chiave per molti fornitori. GET /v1/models ha restituito 416 ID modello il giorno della configurazione, di cui 21 varianti MiMo [3]. Per cambiare modello basta modificare una stringa nello script.
• Puoi prima provarlo gratuitamente. xiaomi-mimo-v2.6-pro-free è gratuito entro i limiti di 5 richieste/min, 100/giorno e 1M token/giorno [2] — abbastanza per verificare che la configurazione funzioni prima di spendere.
• Nessun abbonamento. La fatturazione è a consumo, senza iscrizione né canone mensile [6], e la tariffa di MiMo a pagamento corrisponde a quella indicata nella pagina del modello: $0.48/M in input e $0.96/M in output [1].
• Il debug è più rapido. Se una chiamata non riesce, prova a indirizzare lo stesso script verso il modello di un altro fornitore. Se funziona, la chiave, l'URL e il formato della richiesta sono corretti e il problema riguarda il modello: basta una chiamata invece di un intero pomeriggio.

Come configurarlo

1. Crea il progetto

mkdir mimo-demo && cd mimo-demo
python3 -m venv .venv
.venv/bin/pip install "openai>=1.40" "python-dotenv>=1.0"

2. Salva la chiave

printf 'AIHUBMIX_API_KEY=your_key_here\n' > .env
chmod 600 .env
printf '.env\n.venv/\n__pycache__/\n' > .gitignore

Non inserire mai la chiave direttamente nello script e non eseguire mai il commit di .env.

3. Crea il client

Salva il file come chat.py:

import os
import sys

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

prompt = sys.argv[1] if len(sys.argv) > 1 else "Introduce yourself in one sentence."

stream = client.chat.completions.create(
    model="mimo-v2.6-pro",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=1024,
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    piece = chunk.choices[0].delta.content
    if piece:
        print(piece, end="", flush=True)
print()

Mantieni entrambi i controlli all'interno del ciclo. Alcuni chunk arrivano con un array choices vuoto, che causa un IndexError se si accede a un elemento per indice; delta.content è None nel primo e nell'ultimo frame, quindi print lo mostrerebbe come testo letterale None.

4. Eseguilo

.venv/bin/python chat.py "Introduce yourself in one sentence."

Sono MiMo, un modello linguistico di grandi dimensioni sviluppato dal team LLM Core di Xiaomi, e sono qui per aiutarti a rispondere alle domande, scrivere e svolgere un'ampia gamma di attività utili.

Il tempo previsto per ricevere i primi token è di circa sei secondi, rispetto ai 6.4s indicati nella pagina del modello [1].

5. Apporta le modifiche necessarie

Per una chiamata senza streaming, rimuovi stream=True e leggi response.choices[0].message.content. Per cambiare modello, modifica l'argomento model. Aumenta max_tokens per ottenere output più lunghi: il valore predefinito di 1024 indicato sopra è ben al di sotto del limite del modello [1].

Checklist

• [ ] Ambiente virtuale creato; openai e python-dotenv installati
• [ ] .env contiene la tua chiave effettiva, chmod 600
• [ ] .env è elencato in .gitignore
• [ ] base_url è https://aihubmix.com/v1 — il suffisso /v1 è obbligatorio
• [ ] L'ID modello è mimo-v2.6-pro (a pagamento) oppure xiaomi-mimo-v2.6-pro-free (gratuito)
• [ ] Il ciclo di streaming controlla chunk.choices e delta.content
• [ ] Una chiamata di prova restituisce del testo

Domande frequenti

L'API è davvero compatibile con OpenAI? Sì: usa il formato standard Chat Completions. Qualsiasi client compatibile con OpenAI funziona impostando l'URL base su https://aihubmix.com/v1 e passando la chiave AIHubMix come token bearer. La documentazione di AIHubMix specifica che coding-xiaomi-mimo-v2.6-flash supporta solo i formati compatibili con OpenAI [3].

Quale ID modello devo usare? mimo-v2.6-pro per la versione a pagamento, xiaomi-mimo-v2.6-pro-free per quella gratuita. I due piani usano convenzioni di denominazione diverse: le varianti gratuite hanno il prefisso xiaomi-, quelle a pagamento no. È facile sbagliarsi.

Quali altre varianti sono disponibili? mimo-v2.6-pro-ultraspeed, mimo-v2.6-flash, mimo-v2.5-pro e ID ottimizzati per la programmazione, come coding-xiaomi-mimo-v2.6-pro [3]. Puoi elencarli tramite l'API:

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "
import json,sys
for i in sorted(m['id'] for m in json.load(sys.stdin)['data']):
    if 'mimo' in i: print(i)
"

Ricevo l'errore 429 — cosa significa? Dipende dal messaggio: i due casi richiedono comportamenti opposti. «rate limited by provider» indica un limite al numero di richieste al minuto: attendi e riprova. «reached the limit of the free model quota» significa che hai esaurito la quota gratuita del tuo account, condivisa tra i modelli gratuiti. Riprovare non servirà: passa a mimo-v2.6-pro.

Ricevo 400 «cannot be served at the moment». Per prima cosa, verifica l'ID tramite l'API:

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "import json,sys; print('mimo-v2.6-pro' in [m['id'] for m in json.load(sys.stdin)['data']])"

Se il risultato è True, ripeti la chiamata chat con curl e cerca "code": "no_available_channel". Significa che il modello è elencato, ma in quel momento non dispone di capacità upstream: è un problema lato fornitore che nessuna modifica locale può risolvere. Attendi oppure contatta l'assistenza AIHubMix indicando l'ID richiesta presente nella risposta.

Come faccio a capire se il problema dipende da me o dal fornitore? Con la stessa chiave e lo stesso script, chiama il modello di un altro fornitore, per esempio gpt-4o-mini. Se la chiamata riesce, la chiave, l'URL base e il formato della richiesta sono corretti e il problema riguarda quel modello specifico. Se non riesce neanche questa, controlla la chiave e la fatturazione.

Perché l'output si interrompe a metà frase? Hai raggiunto max_tokens, non il limite del modello. Aumentane il valore.

Come posso controllare lo stato del mio account?

curl -s https://aihubmix.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Controlla has_payment_method e i campi relativi ai limiti.

Prossimi passi

Lo script qui sopra è una base funzionante. Le funzionalità elencate per MiMo v2.6 Pro includono chiamate agli strumenti, output strutturati, input visivo e audio e memorizzazione nella cache dei prompt [1] — tutto tramite la stessa interfaccia compatibile con OpenAI, quindi estendere il client consiste soprattutto nell'aggiungere parametri standard. Inizia con il piano gratuito per verificare la configurazione, poi passa all'ID modello mimo-v2.6-pro per l'uso regolare.

Fonti

• [1] Pagina del modello AIHubMix, mimo-v2.6-pro: https://aihubmix.com/model/mimo-v2.6-pro (consultata il 28 settembre 2026)
• [2] Pagina del modello AIHubMix, xiaomi-mimo-v2.6-pro-free: https://aihubmix.com/model/xiaomi-mimo-v2.6-pro-free (consultata il 28 settembre 2026)
• [3] ID delle varianti e note sui formati ricavati dall'endpoint GET /v1/models e dalle pagine dei modelli AIHubMix (consultati il 28 settembre 2026)
• [4] Note di rilascio di Xiaomi MiMo, serie V2.6: https://mimo.mi.com/docs/en-US/news/latest/v2-6 (consultate il 28 settembre 2026)
• [5] Pagina del modello AIHubMix, mimo-v2.5-pro: https://aihubmix.com/model/mimo-v2.5-pro (consultata il 28 settembre 2026)
• [6] Documentazione del prodotto AIHubMix: https://docs.aihubmix.com/en (consultata il 28 settembre 2026)