
Gemini 4 Carbon API를 이제 PoYo에서 모델 ID gemini-4-carbon으로 사용할 수 있습니다. PoYo 키 하나로 OpenAI 호환 Chat Completions 엔드포인트나 Google 네이티브 generateContent 형식으로 호출할 수 있으며, 가격은 입력 100만 토큰당 $1.60, 출력 100만 토큰당 $8.00입니다. 코드를 작성하기 전에 Gemini 4 Carbon 모델 페이지에서 먼저 시험해 보세요.
이 개요에서는 Google이 설명하는 모델의 특징, 설계 시 고려해야 할 제한, PoYo와 Google의 가격, 그리고 Gemini 4 Argon 대신 Carbon으로 보낼 만한 요청이 무엇인지 다룹니다.
Gemini 4 Carbon이란?
Google은 2026년 10월 28일 Gemini 4 Carbon을 "최첨단 사이버 보안 및 장기 과제(long horizon) 역량을 갖춘 가장 강력한 모델"로 소개했습니다. 2주 전에 출시된 Gemini 4 Argon을 기반으로 하며, Google에 따르면 "지속적인 에이전트 워크플로를 위해 설계"되었습니다. 대규모 코드베이스 전반의 버그 근본 원인 분석과 패치, 멀티 에이전트 코딩, 마이그레이션, 고밀도 지식 작업, 과학적 추론이 그 대상입니다.
접근은 두 단계로 열렸습니다.
| 날짜 | 내용 |
|---|---|
| 2026년 10월 28일 | Google이 Gemini 4 Carbon 발표, Fairwind Program을 통해 일부 사이버 방어 담당자에게 최초 제공 |
| 2026년 11월 10일 | Gemini API 유료 등급(AI Studio)의 모든 유료 개발자와 Gemini for business에 제공 |
| 2026년 11월 16일 | PoYo에서 gemini-4-carbon으로 호출 가능 |
Google은 일부 사이버 보안 기능이 여전히 제한된다고 밝혔습니다. 개발자는 Fairwind Program에 신청해 "순차적으로 사이버 보안용 Carbon에 대한 접근 권한을 받게" 됩니다. 방어 보안 기능을 계획할 때는 이 점을 고려하세요.
Gemini 4 Carbon API 한눈에 보기
| 항목 | 값 |
|---|---|
| PoYo 모델 ID | gemini-4-carbon |
| Google 모델 코드 | gemini-4-carbon (단일 안정 버전, 별칭 없음) |
| 컨텍스트 윈도우 | 1,048,576 토큰, 입력과 출력이 공유 |
| 최대 출력 | 기본 65,536 토큰 (Google은 "long decode"에서만 최대 1M으로 표기) |
| 입력 유형 | 텍스트, 이미지, 오디오, 동영상, PDF |
| 출력 유형 | 텍스트 |
| 지식 컷오프 | 2026년 3월 |
| Google 무료 등급 | 없음 |
| PoYo 형식 | Chat Completions 및 Gemini Native (Responses, Anthropic Messages는 미지원) |
Google 모델 페이지는 1M 수치를 입력과 출력을 합친 통합 제한으로 표기하므로, 1,000,000 토큰짜리 프롬프트를 보내면 답변에 쓸 여유가 거의 남지 않습니다. PoYo 문서에는 long decode 전환 옵션이 문서화되어 있지 않으므로, PoYo에서는 응답당 64K 출력을 기준으로 설계하세요.
엔드포인트와 인증
두 형식 모두 https://api.poyo.ai에 대해 Authorization: Bearer $POYO_API_KEY를 사용합니다. 응답은 각 형식 고유의 구조로 반환되며, PoYo가 미디어 작업에 사용하는 code / data 래퍼는 없습니다.
| 형식 | 엔드포인트 | 스트리밍 | 최대 출력 필드 |
|---|---|---|---|
| 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 |
이미 OpenAI SDK를 사용 중이라면 Chat Completions를 쓰세요(base_url을 https://api.poyo.ai/v1로 설정). 이미지나 기타 파일을 위한 inlineData 파트가 필요하다면 Gemini Native를 쓰세요. PoYo의 Chat Completions 스키마는 content를 일반 문자열로 문서화하고 있습니다. /v1/responses처럼 지원하지 않는 형식으로 이 모델을 호출하면 지원되는 URI 목록과 함께 HTTP 400이 반환됩니다. 요청 구조는 Gemini Native 문서에 있습니다.
Google은 이 모델에 대해 함수 호출, 구조화된 출력, 사고 수준(thinking level), Google 검색 그라운딩도 지원한다고 밝히고 있습니다. 하지만 PoYo가 공개한 이 두 엔드포인트의 스키마에는 메시지, contents / parts, 샘플링 필드, generationConfig, safetySettings만 문서화되어 있으므로, 그 밖의 기능에 의존하기 전에 문서를 확인하세요.
Gemini 4 Carbon API 가격: PoYo vs Google
PoYo는 토큰 단위로 크레딧을 과금합니다(1크레딧 = $0.005).
| 미터 (100만 토큰당) | PoYo 가격 | PoYo 크레딧 | Google, 2026년 11월 30일까지 | Google, 2026년 12월 1일부터 |
|---|---|---|---|---|
| 입력 | $1.60 | 320 | $2.00 | $4.00 |
| 출력 (사고 토큰 포함) | $8.00 | 1,600 | $10.00 | $20.00 |
| 캐시 읽기 | $0.08 | 16 | $0.10 | $0.20 |
PoYo 요금은 Google의 도입 기간 입력·출력 가격보다 20% 낮습니다. Google 가격 페이지에 따르면 사고 토큰은 출력 요금에 포함되며, Carbon은 암시적 컨텍스트 캐싱만 지원합니다. 위의 Google 가격은 표준 등급 기준입니다. Google은 배치 요금도 공개하고 있지만, 이 PoYo 엔드포인트에는 해당하지 않습니다. PoYo 가격은 2026년 11월 16일 기준이며, 최신 가격은 모델 페이지에서 확인할 수 있습니다.
200K 토큰 규모의 저장소 리뷰에 8K 토큰 답변을 받으면 PoYo에서 0.2 × $1.60 + 0.008 × $8.00 = $0.384(76.8크레딧)입니다. 전체 계산 예시는 Gemini 4 Carbon API 가격에 있습니다.
어떤 요청을 Gemini 4 Carbon API로 보낼까
여기서 벤치마크는 라우팅 근거로서만 의미가 있습니다. Google이 공개한 표에서 발췌했습니다.
| 워크로드 | 벤치마크 | Carbon | Argon | Carbon으로 보낼까? |
|---|---|---|---|---|
| 터미널 기반 에이전트 코딩 | Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | 예, 긴 다단계 작업이라면 |
| 장기 과제 에이전트 코딩 | SWE-sweep | 9.6% | 4.3% | 예 |
| 256K–1M 토큰 범위 검색 | GraphWalks (BFS F1) | 96.2% | 84.2% | 예, 프롬프트가 매우 클 때 |
| 여러 도구를 아우르는 업무 자동화 | AutomationBench (Zapier) | 53.9% | 51.3% | 차이가 작음, 둘 다 테스트 |
| 취약점 탐지 | SEC-bench Pro | 88.2% | 83.4% | 예, Fairwind 접근 권한이 있다면 |
| 취약점 패치 품질 | CWE-bench | 71.0% | 68.0% | 예 |
같은 표에서 FrontierSWE 2는 GPT-6 Astra가(65.5% vs 61.2%), OSWorld-2.1은 Claude Opus 5.5가(87.2% vs 81.5%) 앞섭니다. 세 모델 비교는 Gemini 4 Carbon API vs Claude Opus 5.5 vs GPT-6 Astra를 참고하세요.
Carbon vs Argon: 하나의 라우팅 규칙
Carbon과 Argon은 PoYo와 Google 모두에서 입력·출력 가격이 같습니다. 차이는 작업당 토큰 수입니다. Google에 따르면 Carbon은 "철저하게 탐색하고, 깊이 추론하고, 확장된 검증 루프를 실행하기 위해 Argon보다 더 많은 토큰을 사용"하며, "대부분의 소프트웨어 엔지니어링과 지식 작업에는 여전히 Argon이 이상적인 선택"입니다. 따라서 일상적인 코딩과 문서 작업은 gemini-4-argon으로, 가장 어려운 디버깅, 마이그레이션, 100만 토큰 규모의 검색, 보안 작업은 gemini-4-carbon으로 보내세요. 두 모델의 요청 구조가 같으므로 모델 ID만 바꾸면 됩니다. 자세한 내용은 Gemini 4 Carbon API vs Gemini 4 Argon과 Gemini 4 Argon API 가이드에 있습니다.
Gemini 4 Carbon API 빠른 시작
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
}'
답변은 choices[0].message.content에, 토큰 수는 usage에 있습니다. OpenAI SDK를 통한 동일한 요청, 스트리밍, 이미지 입력, 네이티브 형식은 Gemini 4 Carbon API 가이드에 있습니다. 에이전트 루프와 긴 컨텍스트 코딩은 코딩 에이전트를 위한 Gemini 4 Carbon API를 참고하세요.
자주 묻는 질문
Gemini 4 Carbon API의 모델 ID는 무엇인가요?
gemini-4-carbon을 사용하세요. /v1/chat/completions에서는 "model"에, /v1beta/models/gemini-4-carbon:generateContent에서는 URL 경로에 넣습니다.
Gemini 4 Carbon API의 비용은 얼마인가요?
PoYo에서는 100만 토큰당 입력 $1.60, 출력 $8.00, 캐시 읽기 $0.08입니다(320 / 1,600 / 16크레딧). Google은 2026년 11월 30일까지 $2.00 / $10.00 / $0.10, 2026년 12월 1일부터 $4.00 / $20.00 / $0.20을 부과합니다.
Gemini 4 Carbon API는 OpenAI SDK와 호환되나요?
예. base_url="https://api.poyo.ai/v1"을 설정하고 PoYo 키를 사용한 다음, chat.completions.create에서 model="gemini-4-carbon"을 지정하세요.
Gemini 4 Carbon의 컨텍스트 윈도우와 최대 출력은 얼마인가요?
입력과 출력이 공유하는 1,048,576 토큰이며, 출력은 기본 65,536 토큰입니다. 입력은 텍스트, 이미지, 오디오, 동영상, PDF를 받을 수 있고 출력은 텍스트입니다.
Gemini 4 Carbon API에 무료 등급이 있나요?
Google 가격 페이지에 따르면 Gemini 4 Carbon은 무료 등급에서 제공되지 않습니다. PoYo는 크레딧 기반 종량제입니다.
Gemini 4 Carbon API와 Gemini 4 Argon API 중 무엇을 써야 하나요?
토큰당 가격은 같지만 Carbon은 작업당 더 많은 토큰을 사용합니다. Google은 대부분의 소프트웨어 엔지니어링과 지식 작업에는 Argon을, 가장 어려운 장기 과제·긴 컨텍스트·보안 작업에는 Carbon을 권장합니다.