Reflection Beam: modelli aperti, API e agenti di codice

A cosa serve Reflection, in parole semplici?

Reflection sviluppa modelli di intelligenza artificiale e software per usarli. Il sito raccoglie Beam, la piattaforma API, i documenti tecnici e i pesi da scaricare. Beam riceve istruzioni testuali e genera risposte o codice; può essere collegato a un’applicazione oppure a un agente che lavora su un progetto.

Per esempio, puoi chiedere a Mirror CLI di eseguire i test, individuare un difetto e preparare una correzione. Beam fornisce il ragionamento, mentre Mirror dispone degli strumenti per leggere e modificare i file. Chi ha le competenze infrastrutturali può anche gestire il modello direttamente sui propri server.

Scegliere il percorso per il primo utilizzo

Per provare un prompt senza sviluppare un’integrazione, usa il Playground della piattaforma. Per collegare un prodotto, parti dall’API. Per lavorare nel terminale di un progetto, scegli Mirror.

La guida API richiede una chiave creata in API Keys. Il valore completo viene mostrato una volta sola: salvalo in modo sicuro come REFLECTION_API_KEY.

1. Imposta l’URL di base https://api.reflection.ai/openai/v1.
2. Scegli Beam-1.0-501B-A23B e invia un messaggio testuale con Chat Completions.
3. Controlla la risposta in choices[0].message.content.
4. Aggiungi poi cronologia, strumenti o output strutturati, verificando il risultato sul tuo caso d’uso.

Sono disponibili streaming, chiamate a funzioni e JSON Schema. È l’applicazione a eseguire le funzioni richieste e restituire i risultati. Lo sforzo di ragionamento si può regolare, ma il modello continua sempre a ragionare. Pianifica insieme token di ingresso, ragionamento e risposta.

La compatibilità OpenAI copre Chat Completions e Models. Non comprende automaticamente Responses, Embeddings o gli endpoint multimediali.

Un flusso di lavoro verificabile con Mirror

Prepara uv e installa uv tool install reflection-mirror. Configura la chiave Reflection, entra nella cartella del progetto e avvia mirror. Assegna un compito circoscritto, come correggere un test fallito dopo averlo riprodotto.

Esamina le azioni richieste e, al termine, controlla git diff ed esegui nuovamente i test. L’agente può leggere file, modificarli e avviare comandi locali; la verifica del codice rimane necessaria.

La guida agli agenti indica macOS 15 o successivo su Apple Silicon e Linux x86-64/ARM64 con glibc 2.28 o successiva. Windows nativo non è supportato. Sono documentate anche le configurazioni per Pi, OpenCode e Hermes.

Modello aperto, licenza e infrastruttura

Beam usa un’architettura MoE sparsa con circa 501 miliardi di parametri totali e 23 miliardi attivi per token. Accetta e produce testo; il contesto del modello è di circa un milione di token. È stato sviluppato prevalentemente per l’inglese, quindi valuta separatamente i tuoi contenuti in italiano.

I pesi sono disponibili dal 16 ottobre 2026 sotto Apache 2.0 nei formati BF16, FP8 e NVFP4. La configurazione ufficiale di riferimento usa quattro NVIDIA B300 SXM collegate con NVLink, Linux amd64, Docker e NVIDIA Container Toolkit. Scarica modello e DFlash2, segui una guida di serving e controlla il servizio con Beam Verifier.

Questa configurazione non è un minimo universale per ogni quantizzazione. La documentazione elenca stack per fine-tuning e apprendimento per rinforzo; le ricette dettagliate per ciascuno sono ancora previste in seguito.

Costi, limiti e dati del progetto

Verifica del 20 ottobre 2026: la beta pubblica dell’API permette di iniziare gratis. Non è stato confermato un listino ufficiale pubblico unico per token. Consulta fatturazione e quote del tuo account, distinguendole dai prezzi dei provider esterni. L’hosting autonomo comporta costi di GPU, spazio e gestione.

I limiti si applicano all’organizzazione e sono condivisi da progetti e chiavi. Anche i token di ragionamento contano; le quote giornaliere si rinnovano alle 00:00 UTC. Per gli errori 429 segui le indicazioni sui limiti.

L’informativa privacy descrive la raccolta di input e output ospitati e il possibile uso per migliorare i modelli in base alle scelte dell’utente. I contenuti enterprise dipendono dagli accordi con i clienti e l’area europea ha un’informativa separata. Controlla i termini prima di inviare codice riservato.

Domande frequenti

Beam è gratuito?

I pesi sono aperti e la beta ufficiale si può iniziare gratuitamente. Non significa API illimitata e gratuita per sempre, né hardware incluso.

È consentito l’uso commerciale?

Sì, rispettando Apache 2.0. Per un’API ospitata si applicano anche le condizioni del servizio scelto.

Supporta immagini e audio?

Il modello attuale lavora con testo. Gli altri formati richiedono una conversione adeguata prima dell’invio.

Quale hardware serve per eseguirlo?

Dipende dal formato e dal motore di inferenza. Mirror su un computer compatibile può collegarsi all’API remota senza eseguire localmente tutti i pesi.

Documenti e comunità ufficiali

• Documentazione: API, deployment e personalizzazione.
• Mirror su GitHub: sorgente e segnalazioni.
• Discord sviluppatori: confronto nella comunità.
• Reflection su X: annunci ufficiali.
• Contatti aziendali: progetti e collaborazioni.