
La Gemini 4 Carbon API è disponibile su PoYo con l'ID modello gemini-4-carbon. Puoi chiamarla tramite l'endpoint Chat Completions compatibile con OpenAI oppure con il formato nativo generateContent di Google, usando un'unica chiave PoYo, a $1.60 per 1M di token in input e $8.00 per 1M di token in output. Provala sulla pagina del modello Gemini 4 Carbon prima di scrivere codice.
Questa panoramica spiega cos'è il modello secondo Google, i limiti attorno a cui progettare, il prezzo su PoYo e presso Google, e quali richieste conviene instradare verso Carbon anziché verso Gemini 4 Argon.
Cos'è Gemini 4 Carbon?
Google ha presentato Gemini 4 Carbon il 28 ottobre 2026 come "il nostro modello più potente, con capacità all'avanguardia in cybersicurezza e su orizzonti lunghi". Si basa su Gemini 4 Argon, lanciato due settimane prima, e secondo Google è "costruito per flussi di lavoro agentici prolungati": individuare la causa radice dei bug e correggerli in codebase di grandi dimensioni, coding multi-agente, migrazioni, lavoro di conoscenza denso e ragionamento scientifico.
L'accesso è arrivato in due fasi:
| Data | Cosa è successo |
|---|---|
| 28 ottobre 2026 | Google annuncia Gemini 4 Carbon; primo accesso per un gruppo di difensori informatici tramite il Fairwind Program |
| 10 novembre 2026 | Disponibile per tutti gli sviluppatori paganti sul piano a pagamento della Gemini API (AI Studio) e per Gemini for business |
| 16 novembre 2026 | Chiamabile su PoYo come gemini-4-carbon |
Google precisa che alcune capacità di cybersicurezza restano ad accesso limitato: gli sviluppatori si candidano al Fairwind Program "per ottenere l'accesso a Carbon per la cybersicurezza su base continuativa". Tienine conto quando pianifichi funzionalità di sicurezza difensiva.
Gemini 4 Carbon API in sintesi
| Voce | Valore |
|---|---|
| ID modello PoYo | gemini-4-carbon |
| Codice modello Google | gemini-4-carbon (un'unica versione stabile, nessun alias elencato) |
| Finestra di contesto | 1.048.576 token, condivisi tra input e output |
| Output massimo | 65.536 token per impostazione predefinita (Google indica fino a 1M solo con "long decode") |
| Tipi di input | Testo, immagine, audio, video, PDF |
| Tipo di output | Testo |
| Knowledge cutoff | Marzo 2026 |
| Piano gratuito presso Google | Nessuno |
| Formati PoYo | Chat Completions e Gemini Native (non Responses né Anthropic Messages) |
La pagina del modello di Google indica il valore di 1M come limite unificato di input e output, quindi un prompt da 1.000.000 di token non lascia quasi spazio alla risposta. La documentazione di PoYo non descrive un'opzione di long decode, quindi su PoYo pianifica con 64K di output per risposta.
Endpoint e autenticazione
Entrambi i formati usano Authorization: Bearer $POYO_API_KEY verso https://api.poyo.ai. Le risposte arrivano nella forma nativa di ciascun formato, senza il wrapper code / data che PoYo usa per i task multimediali.
| Formato | Endpoint | Streaming | Campo per l'output massimo |
|---|---|---|---|
| OpenAI Chat Completions | POST https://api.poyo.ai/v1/chat/completions | "stream": true (SSE) | max_tokens |
| Gemini Native | POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent | :streamGenerateContent (SSE) | generationConfig.maxOutputTokens |
Usa Chat Completions se utilizzi già l'SDK di OpenAI (imposta base_url su https://api.poyo.ai/v1). Usa Gemini Native quando ti servono parti inlineData per immagini e altri file: lo schema Chat Completions di PoYo documenta content come semplice stringa. Inviare il modello a un formato non supportato, come /v1/responses, restituisce HTTP 400 con l'elenco degli URI supportati. La struttura delle richieste è nella documentazione Gemini Native.
Google elenca per questo modello anche function calling, output strutturati, livelli di thinking e grounding con Google Search. Gli schemi pubblicati da PoYo per questi due endpoint documentano solo messaggi, contents / parts, campi di campionamento, generationConfig e safetySettings, quindi controlla la documentazione prima di fare affidamento su altro.
Prezzi della Gemini 4 Carbon API: PoYo vs Google
PoYo fattura per token in crediti (1 credito = $0.005):
| Voce (per 1M di token) | Prezzo PoYo | Crediti PoYo | Google, fino al 30 nov 2026 | Google, dal 1° dic 2026 |
|---|---|---|---|---|
| Input | $1.60 | 320 | $2.00 | $4.00 |
| Output (inclusi i token di thinking) | $8.00 | 1,600 | $10.00 | $20.00 |
| Lettura dalla cache | $0.08 | 16 | $0.10 | $0.20 |
Le tariffe PoYo sono inferiori del 20% ai prezzi introduttivi di Google per input e output. La pagina dei prezzi di Google indica che i token di thinking sono inclusi nella tariffa di output e che Carbon supporta solo il caching implicito del contesto. I prezzi Google qui sopra sono quelli del livello standard. Google pubblica anche tariffe batch, che non fanno parte di questo endpoint PoYo. I prezzi PoYo sono quelli in listino al 16 novembre 2026; la pagina del modello è la fonte aggiornata.
Una revisione di un repository da 200K token con una risposta da 8K token costa 0.2 × $1.60 + 0.008 × $8.00 = $0.384 (76,8 crediti) su PoYo. Gli esempi completi sono in Prezzi della Gemini 4 Carbon API.
Quali richieste instradare verso la Gemini 4 Carbon API
Qui i benchmark contano solo come elementi per decidere l'instradamento. Dalla tabella pubblicata da Google:
| Carico di lavoro | Benchmark | Carbon | Argon | Instradare verso Carbon? |
|---|---|---|---|---|
| Coding agentico da terminale | Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | Sì, per task lunghi a più passaggi |
| Coding agentico su orizzonti lunghi | SWE-sweep | 9.6% | 4.3% | Sì |
| Recupero su 256K–1M token | GraphWalks (BFS F1) | 96.2% | 84.2% | Sì, quando il prompt è enorme |
| Automazione aziendale tra strumenti | AutomationBench (Zapier) | 53.9% | 51.3% | Divario ridotto; prova entrambi |
| Individuazione di vulnerabilità | SEC-bench Pro | 88.2% | 83.4% | Sì, se hai accesso a Fairwind |
| Qualità delle patch per le debolezze | CWE-bench | 71.0% | 68.0% | Sì |
La stessa tabella mostra GPT-6 Astra in vantaggio su FrontierSWE 2 (65,5% contro 61,2%) e Claude Opus 5.5 in vantaggio su OSWorld-2.1 (87,2% contro 81,5%). Per un confronto a tre, vedi Gemini 4 Carbon API vs Claude Opus 5.5 vs GPT-6 Astra.
Carbon vs Argon: una sola regola di instradamento
Carbon e Argon hanno lo stesso prezzo di input e output, sia su PoYo sia presso Google. La differenza sta nei token per task: secondo Google, Carbon lavora "usando più token di Argon per esplorare a fondo, ragionare in profondità ed eseguire cicli di verifica estesi", e "Argon resta la scelta ideale per la maggior parte dell'ingegneria del software e del lavoro di conoscenza". Quindi invia il coding quotidiano e il lavoro sui documenti a gemini-4-argon. Invia il debugging più difficile, le migrazioni, il recupero su milioni di token e il lavoro di sicurezza a gemini-4-carbon. Poiché entrambi usano la stessa struttura di richiesta, il passaggio consiste solo nel cambiare l'ID modello. I dettagli sono in Gemini 4 Carbon API vs Gemini 4 Argon e nella guida alla Gemini 4 Argon API.
Gemini 4 Carbon API: avvio rapido
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-4-carbon",
"messages": [
{"role": "system", "content": "You are a senior engineer. Answer with a numbered plan."},
{"role": "user", "content": "Plan a migration of a Flask service from SQLAlchemy 1.4 to 2.0."}
],
"max_tokens": 8192
}'
La risposta si trova in choices[0].message.content e i conteggi dei token in usage. La stessa richiesta tramite l'SDK di OpenAI, lo streaming, l'input di immagini e il formato nativo sono nella guida alla Gemini 4 Carbon API. Per i loop degli agenti e il coding con contesto lungo, vedi Gemini 4 Carbon API per agenti di coding.
Domande frequenti
Qual è l'ID modello della Gemini 4 Carbon API?
Usa gemini-4-carbon. Passalo in "model" per /v1/chat/completions, oppure nel percorso URL per /v1beta/models/gemini-4-carbon:generateContent.
Quanto costa la Gemini 4 Carbon API?
Su PoYo: $1.60 di input, $8.00 di output e $0.08 di lettura dalla cache per 1M di token (320 / 1.600 / 16 crediti). Google applica $2.00 / $10.00 / $0.10 fino al 30 novembre 2026 e $4.00 / $20.00 / $0.20 dal 1° dicembre 2026.
La Gemini 4 Carbon API è compatibile con l'SDK di OpenAI?
Sì. Imposta base_url="https://api.poyo.ai/v1", usa la tua chiave PoYo e imposta model="gemini-4-carbon" in chat.completions.create.
Qual è la finestra di contesto e l'output massimo di Gemini 4 Carbon?
1.048.576 token condivisi tra input e output, con 65.536 token di output per impostazione predefinita. Gli input possono essere testo, immagini, audio, video e PDF; l'output è testo.
Esiste un piano gratuito per la Gemini 4 Carbon API?
La pagina dei prezzi di Google indica che Gemini 4 Carbon non è disponibile nel piano gratuito. PoYo è a consumo, con crediti.
Meglio la Gemini 4 Carbon API o la Gemini 4 Argon API?
Stesso prezzo per token; Carbon consuma più token per task. Google consiglia Argon per la maggior parte dell'ingegneria del software e del lavoro di conoscenza, e Carbon per i task più difficili su orizzonti lunghi, con contesto lungo e di sicurezza.