
Gemini 4 Carbon API와 Gemini 4 Argon API는 같은 요청을 받고 입력·출력 토큰당 가격도 같으므로, 둘 중 하나를 고르는 일은 마이그레이션이 아니라 라우팅 결정입니다. PoYo에서는 문자열 하나만 바꾸면 전환됩니다. gemini-4-carbon(모델 페이지) 또는 gemini-4-argon(모델 페이지)입니다. 이 글에서는 API 수준에서 무엇이 다른지, Google의 벤치마크 차이가 어떤 요청을 Carbon으로 보내야 한다고 말하는지, 그리고 코드에 바로 넣을 수 있는 라우터를 다룹니다.
Carbon이 처음이라면 Gemini 4 Carbon API 개요와 첫 요청 가이드부터 시작하세요. Argon 자체에 대해서는 Gemini 4 Argon API 가이드를 참고하세요.
Gemini 4 Carbon API vs Gemini 4 Argon API 한눈에 보기
| Gemini 4 Carbon | Gemini 4 Argon | |
|---|---|---|
| PoYo 모델 ID | gemini-4-carbon | gemini-4-argon |
| PoYo 엔드포인트 | POST /v1/chat/completions, POST /v1beta/models/gemini-4-carbon:generateContent / :streamGenerateContent | 같은 두 형식, gemini-4-argon 사용 |
| 컨텍스트 윈도우 | 1M 토큰 | 1M 토큰 |
| 응답당 최대 출력 | 64K 토큰 | 더 큼: Google은 입력·출력 통합 1M 제한으로 설명 (Argon 가이드 참고) |
| 입력 유형 | 텍스트, 이미지, 오디오, 동영상, PDF | 텍스트, 이미지, 오디오, 동영상, PDF |
| Google의 포지셔닝 | 가장 강력한 추론 모델, 탐색·추론·검증에 더 많은 토큰 사용 | 효율적인 모델: 더 빠른 응답, 턴당 더 적은 토큰 사용 |
| Google의 권장 사항 | 가장 어려운 다단계 코딩, 디버깅, 개방형 리서치 | "대부분의 소프트웨어 엔지니어링과 지식 작업에 이상적인 선택" |
요청 구조는 동일합니다. Chat Completions에서는 모델 ID가 model 필드에, Gemini Native에서는 URL 경로에 들어갑니다. 두 모델 모두 스트리밍을 지원합니다("stream": true 또는 :streamGenerateContent). 오류도 같습니다. 잘못된 필드나 형식은 400, 잘못된 키는 401, 알 수 없는 모델 ID는 404, 크레딧이 소진되면 402입니다.
라우팅을 강제하는 유일한 제한은 출력 크기입니다. Carbon의 문서화된 상한은 응답당 64K 출력 토큰입니다. 단일 응답이 그보다 길어야 한다면(예: 여러 파일을 한 번에 전부 다시 쓰는 경우) Argon으로 보내세요.
마이그레이션 diff: JSON에서 바뀌는 부분
Chat Completions에서 요청을 Argon에서 Carbon으로 옮기는 경우입니다.
{
- "model": "gemini-4-argon",
+ "model": "gemini-4-carbon",
"messages": [
{"role": "user", "content": "Find the root cause of the failing test and propose a patch."}
],
- "max_tokens": 120000,
+ "max_tokens": 64000,
"stream": true
}
Gemini Native에서는 경로만 바뀝니다.
POST https://api.poyo.ai/v1beta/models/gemini-4-argon:generateContent
POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent
Carbon을 호출할 때는 max_tokens(Chat Completions) 또는 generationConfig.maxOutputTokens(Gemini Native)를 64,000 이하로 제한하세요. 본문의 다른 부분은 바꿀 필요가 없습니다.
토큰당 가격: 캐시 읽기를 제외하면 동일
현재 모델 페이지 기준 PoYo 가격입니다(1크레딧 = $0.005).
| 미터 (100만 토큰당) | PoYo의 Gemini 4 Carbon | PoYo의 Gemini 4 Argon | Google 공식 (두 모델 공통, 도입 기간) |
|---|---|---|---|
| 입력 | $1.60 (320크레딧) | $1.60 (320크레딧) | $2.00 |
| 출력 (사고 포함) | $8.00 (1,600크레딧) | $8.00 (1,600크레딧) | $10.00 |
| 캐시 읽기 | $0.08 (16크레딧) | $0.16 (32크레딧) | $0.10 (입력 대비 95% 할인) |
Google은 Carbon을 Argon의 도입 가격으로 출시했습니다. 제공 개시 게시물에 따르면 도입 기간은 2026년 11월 30일에 끝나며, 12월 1일부터 100만 토큰당 입력 $4, 출력 $20이 적용됩니다. Carbon 가격 글에서 Google의 두 요금과 현재 PoYo 가격을 비교합니다.
차이는 캐시 읽기 행에 있습니다. PoYo에서 Carbon의 캐시 읽기는 Argon의 절반입니다. 실제로 절약되긴 하지만 그 폭은 작습니다. 캐시된 토큰 100만 개당 $0.08이며, 추가 출력 토큰 10,000개(100만 토큰당 $8.00 기준 $0.08)면 상쇄됩니다. Google에 따르면 Carbon은 작업당 Argon보다 더 많은 토큰을 쓰므로, 캐시가 더 저렴하더라도 대부분의 워크로드에서 작업당 비용은 Carbon이 더 높을 것으로 예상하세요.
토큰 수가 동일한 계산 예시(캐시 읽기 400K, 신규 입력 50K, 출력 20K)입니다.
| Carbon | Argon | |
|---|---|---|
| 계산식 | 0.4 × $0.08 + 0.05 × $1.60 + 0.02 × $8.00 | 0.4 × $0.16 + 0.05 × $1.60 + 0.02 × $8.00 |
| 비용 | $0.272 (54.4크레딧) | $0.304 (60.8크레딧) |
같은 작업에 Carbon이 20K가 아닌 30K 출력 토큰을 쓴다면 비용은 $0.352입니다. 그래서 토큰당 비용이 아니라 완료된 작업당 비용을 측정해야 합니다. 측정 스크립트는 아래에 있습니다.
라우팅 근거로서의 벤치마크 차이
아래는 Gemini 4 Carbon 출시 표에 실린 Google 자체 수치이므로, 독립적인 테스트가 아닌 벤더의 비교로 받아들이세요. 차이 열은 추가 토큰이 어디에서 효과를 내는지 알려 줍니다.
| 벤치마크 | Carbon | Argon | 차이 |
|---|---|---|---|
| ExploitGym | 54.8% | 42.0% | +12.8 |
| GraphWalks 256K–1M (BFS F1) | 96.2% | 84.2% | +12.0 |
| AA Intelligence Index v5.0 | 59 | 50 | +9 |
| Agents' Last Exam v1.1 | 77.4% | 69.0% | +8.4 |
| Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | +8.1 |
| OSWorld-2.1 (offline subset) | 81.5% | 74.7% | +6.8 |
| FrontierSWE 2 | 61.2% | 55.0% | +6.2 |
| SWE-sweep | 9.6% | 4.3% | +5.3 |
| SEC-bench Pro | 88.2% | 83.4% | +4.8 |
| RiemannBench | 80.0% | 76.0% | +4.0 |
| CWE-bench | 71.0% | 68.0% | +3.0 |
| AutomationBench (Zapier) | 53.9% | 51.3% | +2.6 |
| Vals Index v2.2 | 70.4% | 69.2% | +1.2 |
라우팅 표로 읽으면 다음과 같습니다.
- 차이가 크다: Carbon으로 보내세요. 256K–1M 토큰 범위의 긴 컨텍스트 검색, 터미널 기반 에이전트 작업, 다단계 에이전트 작업, 익스플로잇 검증.
- 차이가 작다: Argon에 두세요. 업무 자동화(+2.6), 일반 지식 작업(Vals Index, +1.2), CWE-bench의 패치 생성(+3.0). 이 영역에서는 Argon이 턴당 더 적은 토큰으로 점수 대부분을 얻습니다.
- 사이버 보안 관련 주의 사항. Google의 사이버 보안 결과는 Fairwind Program을 통한 접근을 반영하며, 제공 개시 게시물에 따르면 사이버 보안용 Carbon은 이 프로그램을 통해서만 제공됩니다. 공개 API가 이 점수를 재현한다고 가정하지 말고, 자신의 작업으로 테스트하세요.
점수는 하나의 표 안에서만 비교하세요. 저희 Argon 가이드는 Google의 Argon 출시 표를 인용하는데, 그 표에서 Argon의 Terminal-Bench 4.0은 57.4%입니다. Carbon 표는 Artificial Analysis 하네스를 사용합니다(57.1%).
라우팅 전략: 기본은 Argon, 필요할 때 Carbon으로 승격
Google의 권장 사항과 벤치마크 차이는 같은 설계를 가리킵니다.
- 모든 요청의 기본값을
gemini-4-argon으로 하세요. - 어렵다고 알려진 작업 유형은 바로
gemini-4-carbon으로 보내세요: 저장소 전체 디버깅, 터미널 에이전트, 256K 토큰을 넘는 컨텍스트에 대한 질문, 보안 트리아지. - 실패 시 승격하세요. Argon의 답변이 검사(테스트, 스키마 검증, 채점기)를 통과하지 못하거나
finish_reason: "length"로 끝나면 Carbon으로 한 번 재시도하세요. - 응답이 64K 토큰을 넘어야 하면 Argon을 강제하세요.
이 라우터는 PoYo의 Chat Completions 엔드포인트를 가리키는 OpenAI SDK를 사용합니다. 문서화된 필드인 model, messages, max_tokens만 보냅니다.
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["POYO_API_KEY"], base_url="https://api.poyo.ai/v1")
ARGON, CARBON = "gemini-4-argon", "gemini-4-carbon"
CARBON_MAX_OUTPUT = 64_000
# PoYo USD per 1M tokens, from the model pages on 2026-11-16
PRICE = {ARGON: (1.60, 8.00), CARBON: (1.60, 8.00)}
# Task types where Google's table shows the widest Carbon lead
CARBON_TASKS = {"repo_debug", "terminal_agent", "long_context_qa", "security_triage"}
def pick_model(task_type: str, max_tokens: int) -> str:
if max_tokens > CARBON_MAX_OUTPUT:
return ARGON
return CARBON if task_type in CARBON_TASKS else ARGON
def call(model: str, messages: list, max_tokens: int) -> dict:
resp = client.chat.completions.create(model=model, messages=messages, max_tokens=max_tokens)
u = resp.usage
price_in, price_out = PRICE[model]
cost = u.prompt_tokens / 1e6 * price_in + u.completion_tokens / 1e6 * price_out
return {
"model": resp.model,
"text": resp.choices[0].message.content,
"finish_reason": resp.choices[0].finish_reason,
"prompt_tokens": u.prompt_tokens,
"completion_tokens": u.completion_tokens,
"cost_usd": round(cost, 6),
}
def run(task_type: str, messages: list, check, max_tokens: int = 16_000) -> list:
"""Returns every attempt so you can log cost per task, including escalations."""
first = pick_model(task_type, max_tokens)
attempts = [call(first, messages, max_tokens)]
a = attempts[-1]
failed = a["finish_reason"] == "length" or not check(a["text"])
if first == ARGON and failed and max_tokens <= CARBON_MAX_OUTPUT:
attempts.append(call(CARBON, messages, max_tokens))
return attempts
check는 직접 작성하는 수락 테스트입니다. 예를 들어 "패치가 적용되고 테스트가 통과한다"나 "JSON이 내 스키마대로 파싱된다" 같은 것입니다. 비용 추정은 모든 프롬프트 토큰을 캐시되지 않은 입력으로 취급합니다. PoYo의 문서화된 usage 필드는 캐시된 토큰을 따로 구분하지 않으므로 이 값은 상한입니다.
작업당 비용을 직접 측정하기
토큰당 가격이 같으므로 두 API를 구분하는 유일한 수치는 수락된 작업당 비용입니다. run()의 모든 시도를 로그로 남기세요.
| 기록할 필드 | Chat Completions 출처 | Gemini Native 출처 |
|---|---|---|
| 실제로 사용된 모델 | model | URL 경로 |
| 입력 토큰 | usage.prompt_tokens | usageMetadata.promptTokenCount |
| 출력 토큰 | usage.completion_tokens | usageMetadata.candidatesTokenCount + thoughtsTokenCount |
| 출력 상한 도달 여부 | finish_reason == "length" | finishReason |
| 검사 통과 여부 | 직접 만든 채점기 | 직접 만든 채점기 |
Google은 사고 토큰을 포함해 출력 가격을 매기므로, Gemini Native에서는 thoughtsTokenCount를 출력으로 계산하세요. 스트리밍에서는 Chat Completions의 마지막 청크에 usage가 담깁니다. 그다음 작업 유형별로 다음을 계산합니다.
cost per accepted task = sum(cost_usd of all attempts, incl. escalations) / tasks that passed
Argon을 기본값으로 실제 트래픽을 일주일간 처리하고, Carbon으로 바로 보낸 샘플과 비교하세요. Argon이 승격을 필요로 했던 작업을 Carbon이 통과한다면 그 작업 유형을 CARBON_TASKS에 추가하세요. 어떤 유형에서 Carbon의 통과율이 Argon과 같다면 그 유형은 Argon에 두세요. 처음 수백 건의 호출은 PoYo 대시보드와 로그를 대조해 확인하세요.
다른 벤더의 모델도 함께 검토 중이라면 Gemini 4 Carbon API vs Claude Opus 5.5 API vs GPT-6 Astra API를 참고하세요. 예산 가드가 있는 에이전트 루프는 코딩 에이전트를 위한 Gemini 4 Carbon API를 참고하세요.
자주 묻는 질문
Gemini 4 Carbon API가 Gemini 4 Argon API보다 비싼가요?
토큰당으로는 아닙니다. 둘 다 PoYo에서 100만 토큰당 입력 $1.60, 출력 $8.00이며, Google 도입 가격으로는 $2.00 / $10.00입니다. PoYo에서는 Carbon의 캐시 읽기가 더 저렴합니다(100만 토큰당 $0.08 vs $0.16). 작업당으로는 보통 Carbon이 더 비쌉니다. Google에 따르면 추론과 검증에 더 많은 토큰을 사용하기 때문입니다.
Gemini 4 Argon API에서 Gemini 4 Carbon API로 어떻게 전환하나요?
Chat Completions에서 "model": "gemini-4-argon"을 "model": "gemini-4-carbon"으로 바꾸거나, Gemini Native URL 경로의 모델을 바꾸세요. Carbon에서는 max_tokens를 64,000 이하로 유지하세요.
Gemini 4 Carbon API의 최대 출력은 Argon과 비교해 어떤가요?
Carbon은 1M 토큰 컨텍스트 윈도우와 함께 응답당 최대 64K 출력 토큰을 반환합니다. Argon은 훨씬 긴 단일 응답을 허용하므로, 64K를 넘는 출력은 Argon으로 보내세요.
코딩에는 Gemini 4 Argon과 Gemini 4 Carbon 중 무엇을 써야 하나요?
Google은 대부분의 소프트웨어 엔지니어링에는 여전히 Argon이 이상적인 선택이라고 말합니다. Carbon은 Google 표에서 차이가 가장 큰 영역, 즉 가장 어려운 다단계 디버깅과 터미널 기반 에이전트 작업에 사용하세요. Terminal-Bench 4.0 (AA) 65.2% vs 57.1%, SWE-sweep 9.6% vs 4.3%입니다.
Gemini 4 Carbon과 Argon은 같은 API 엔드포인트를 사용하나요?
예. 둘 다 같은 PoYo API 키로 POST https://api.poyo.ai/v1/chat/completions(OpenAI 호환)와 POST https://api.poyo.ai/v1beta/models/{model}:generateContent 또는 :streamGenerateContent(Gemini Native)에서 동작합니다.