EvoLink API 키 하나로 Gemini 네이티브 API 또는 OpenAI 호환 Chat Completions에서 Gemini 4 Neon을 사용할 수 있습니다. 토큰 요금을 확인하고, 같은 작업을 끝내는 데 드는 비용을 Hydrogen 및 Carbon과 비교하세요.
프로덕션 라우트이 성공률은 플랫폼 측 가용성을 나타냅니다. 확인된 서버 오류(HTTP 500 / 빈 응답)만 실패로 집계됩니다. 사용자 측 문제(콘텐츠 검열, 잘못된 파라미터, 취소)와 속도 제한, 타임아웃, 인증 오류는 제외됩니다. 실제 트래픽이 들어오기 전에는 빈 구간이 가용으로 표시될 수 있습니다.라이브
Gemini 3.x는 출처가 반환되지 않아도 비어 있지 않은 검색 쿼리마다 과금합니다. 요청 하나에서 여러 쿼리가 실행될 수 있습니다. 검색 요금은 토큰 최소 요금을 적용한 후 별도로 더해집니다.
Google 검색$0.014/ 쿼리·0.952 cr / 쿼리
Gemini 4 Neon API란?
EvoLink의 Gemini 4 Neon API는 텍스트, 이미지, 오디오, 동영상, 문서를 입력받아 텍스트, 구조화된 JSON 또는 함수 호출을 반환합니다. 요청마다 사고 수준을 low, medium, high, xhigh 중에서 고를 수 있습니다. 티켓 분류와 배정, 정보 추출, 요약처럼 애플리케이션에서 결과를 검증할 수 있는 작업부터 시작하세요. Gemini 네이티브 API와 OpenAI 호환 Chat Completions에서 모델 ID gemini-4-neon를 사용합니다. 게이트웨이의 다른 모델에도 같은 EvoLink API 키를 쓸 수 있습니다.
더 복잡한 작업을 평가하려면 여러 파일이 관련된 코드 변경이나 시간 정보가 있는 화면 녹화 전사본에서 문제를 찾는 작업을 시도하세요. 코드가 테스트를 통과하는지, 보고된 시각이 녹화와 맞는지 확인합니다. Hydrogen을 기준으로 삼고 재시도와 도구 호출을 포함해 검증을 통과한 결과당 비용을 측정하세요.
Gemini 4 Neon API 사양과 기능
아래 필드는 EvoLink 라우트 설정을 설명합니다. 프로덕션에 사용하기 전에 대표적인 요청으로 모델 동작을 검증하세요.
컨텍스트 윈도우
1.05M 토큰
최대 출력
65.5K 토큰
입력
텍스트 + 이미지 + 영상 + 파일
출력
텍스트 · JSON(구조화 출력) · 도구 호출
추론
추론 강도 설정 가능
도구 사용
여러 단계 도구 시퀀스를 지원하는 함수 호출
프롬프트 캐싱
자동 캐시 읽기, 더 낮은 요금
서버 측 도구
Google 검색, 검색 쿼리당 과금
프로토콜
Chat Completions · Gemini 네이티브 API
모델 ID
gemini-4-neon
Gemini 4 Neon 활용 사례
범위가 명확하고 양이 많으며 답을 자동으로 검증할 수 있는 작업부터 시작하세요. 오류가 사용자나 업무 기록에 영향을 준다면 애플리케이션 검증과 사람의 검토를 유지해야 합니다.
Gemini 4 Neon으로 분류 및 라우팅
티켓, 메시지, 문서를 고정된 카테고리로 라벨링하고 각 항목을 알맞은 대기열로 보냅니다. 허용되는 라벨과 애매한 항목의 처리 규칙을 제시하고, 라벨링된 표본과 출력을 비교해 일치율과 통과한 라벨당 비용을 추적하세요.
Gemini 4 Neon으로 짧은 답변과 요약 작성
제공한 텍스트를 바탕으로 짧은 답변, 알림, 요약 초안을 작성합니다. 원문을 프롬프트에 넣고 답변이 원문 범위를 벗어나지 않도록 요구하세요. 검토 없이 답변을 보내기 전에 채택률, 수정량, 응답 시간을 측정합니다.
Gemini 4 Neon으로 일상적인 텍스트 추출
일반 텍스트에서 이름, 날짜, 금액 같은 고정 필드를 뽑아 애플리케이션이 검증하는 형식으로 정리합니다. 레코드를 저장하기 전에 타입과 필수 필드를 검증하고, 불확실한 항목은 자동 재시도 루프 대신 검토로 보내세요.
여러 단계의 작업에 Gemini 4 Neon 활용
코딩 에이전트에 여러 파일을 수정하는 작업을 맡깁니다. 관련 소스 코드를 Neon에 전달하고 테스트를 실행한 뒤, 결과를 바탕으로 패치를 수정하게 하세요. 화면 녹화는 타임스탬프가 포함된 전사본으로 검토하고, 보고된 문제가 영상과 일치하는지 확인합니다. 첫 시도 통과율, 재시도 횟수, 검토 시간을 기록하세요.
Gemini 4 Neon API 연동 방법
애플리케이션에서 EvoLink API를 호출하거나 터미널 또는 HTTP 요청을 사용할 수 있는 Agent에게 호출을 맡기세요. 두 방식은 동일한 EvoLink API 키, 잔액, 모델 ID, 요청 기록을 사용합니다.
방법 1
애플리케이션에서 호출
적합한 용도: 프로덕트 백엔드, 배치 작업, 자동화 파이프라인
모델 ID, 시스템 지침, 출력 예산을 지정해 Gemini 네이티브 generateContent 엔드포인트로 텍스트 요청을 보내세요.
설정 단계 보기
1콘솔에서 EvoLink API 키를 만드세요
2EvoLink base URL의 generateContent 엔드포인트를 호출하고 위에 표시된 모델 ID를 요청 경로에 넣으세요
3대표 요청을 한 번 보내고 usageMetadata에서 입력·캐시·출력 토큰을 확인하세요
4작업별 출력 예산과 재시도 횟수 상한을 설정하고, 반환된 텍스트를 검증한 뒤 채택하세요.
# Gemini native API
curl -X POST "https://direct.evolink.ai/v1beta/models/gemini-4-neon:generateContent" \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"systemInstruction": { "parts": [{ "text": "Classify the ticket as billing, bug, or other. Reply with the label only." }] },
"contents": [
{ "role": "user", "parts": [{ "text": "I was charged twice for my November invoice." }] }
],
"generationConfig": {
"maxOutputTokens": 256,
"thinkingConfig": { "thinkingLevel": "low" }
}
}'
# Set thinkingLevel to low, medium, high, or xhigh (default: high). Thinking tokens are billed at the output rate.
# For streaming, call streamGenerateContent?alt=sse with the same body.
# The response includes candidates[0].content.parts and usageMetadata
# (prompt, thinking, and output token counts).
잘못된 요청 또는 지원하지 않는 파라미터
API 레퍼런스를 기준으로 모델 ID, contents 배열, 파라미터 범위를 확인하고 이 경로가 지원하지 않는 필드를 제거하세요.
인증 또는 잔액 문제
Authorization Bearer 토큰을 확인하고 콘솔에서 사용 가능한 잔액을 확인하세요.
컨텍스트 길이 초과
입력·사고·출력은 1,048,576토큰 윈도우를 함께 쓰며, 이보다 긴 입력의 요청은 거부됩니다. 입력을 관련 내용으로 줄인 뒤 다시 시도하세요.
속도 제한(429)
지터를 두고 백오프 후 재시도하고, 병렬 버스트 대신 배치나 큐로 보내세요.
콘텐츠 거부 또는 예상과 다른 출력
재시도하기 전에 오류 응답 본문을 확인하고 반환된 텍스트가 작업 규칙에 맞는지 검증하세요.
Gemini 4 Neon 사고 토큰과 비용
사고 수준은 요청을 제어하는 설정일 뿐 고정 토큰 할당량이 아니며 더 나은 답변을 보장하지도 않습니다. 사고 토큰은 출력 요금(100만 토큰당 $14.250)으로 과금됩니다. Chat Completions는 이를 completion tokens에 포함하고, 네이티브 API는 usageMetadata에 따로 보고합니다. 수락 기준을 통과하는 가장 낮은 수준을 유지하세요.
1,048,576토큰 윈도우 하나, 스트리밍 요청 한 번에 최대 65,536토큰
입력·사고·출력은 1,048,576토큰 컨텍스트 윈도우 하나를 함께 쓰며, 이보다 긴 입력의 요청은 거부됩니다. 스트리밍 요청 한 번이 반환하는 것은 사고와 답변을 합쳐 최대 65,536토큰입니다. 더 길게 받으려면 네이티브 API에서 maxOutputTokens를 이 한도보다 크게 설정하세요. 응답이 종료 사유 CONTINUATION으로 끝나면 continuationToken이 함께 오며, 이 토큰을 넣어 같은 요청을 다시 보내면 출력이 이어지고 STOP으로 끝나거나 maxOutputTokens에 도달할 때까지 반복합니다. Chat Completions는 이어받을 수 없으며, 한도에서 잘린 응답은 finish_reason "length"로 끝납니다.
Gemini 4 Neon API 연동에 EvoLink를 사용하는 이유
하나의 EvoLink API 키로 Neon에 연결하고 애플리케이션에 맞는 프로토콜을 사용하세요. 사고 수준과 작업 예산을 조절하고 같은 게이트웨이에서 다른 모델과 비교할 수 있습니다.
01
하나의 API 키로 기존 클라이언트 활용
같은 EvoLink API 키로 Chat Completions와 Gemini 네이티브 프로토콜을 사용할 수 있어 기존 연동을 그대로 활용할 수 있습니다. Chat Completions는 요청 본문의 model을 "gemini-4-neon"로 설정합니다. 네이티브 API는 /v1beta/models/{model}:generateContent 경로에 해당 ID를 사용합니다. 두 프로토콜의 요청 구조는 다릅니다.
통합 연동
02
요청별로 사고 수준 설정
Chat Completions의 reasoning_effort 또는 네이티브 thinkingConfig의 thinkingLevel을 low, medium, high, xhigh로 설정하세요. 지정하지 않으면 high가 적용됩니다. Chat Completions에서는 EvoLink가 none과 minimal을 low로 전송합니다. 사고 토큰은 출력 요금으로 과금되므로 간단한 작업은 low부터 시작하고 선택한 수준을 사용량 로그에 남기세요.
사고 제어
03
작업 전체 비용 관리
요청마다 maxOutputTokens(Chat Completions에서는 max_tokens)를 설정하세요. 출력에는 사고 토큰도 포함됩니다. 작은 요청에는 최소 요금이 적용되므로 애플리케이션이 허용하는 범위에서 아주 짧은 항목은 묶어서 보내고, 전체 작업의 재시도 횟수에 상한을 두세요.
비용 관리
04
같은 게이트웨이에서 모델 비교 및 전환
같은 EvoLink 게이트웨이에서 Neon을 Gemini 4 Hydrogen, Gemini 4 Carbon 또는 현재 사용 중인 모델과 비교하세요. 어려운 사례를 포함한 소규모 대표 데이터로 시험하고, 통과한 결과가 총지출을 뒷받침할 때만 경로를 바꾸세요. 검증된 대체 경로를 남겨 두고 검증에 실패하면 되돌립니다.
모델 선택
Gemini 4 Neon·Hydrogen·Carbon 요금
EvoLink
아래 표는 EvoLink 입력 및 출력 요금을 비교합니다. Hydrogen으로 이미 통과하는 작업은 해당 모델을 기준으로, 더 어려운 추론 작업은 Carbon도 포함해 평가하세요. 세 모델에 같은 입력과 검증 기준을 적용합니다. 재시도를 포함한 모든 시도의 API 및 도구 비용을 합산한 뒤 검증을 통과한 결과 수로 나누세요. 사람이 검토하는 시간도 기록합니다.
direct.evolink.ai에서 EvoLink API 키를 사용하세요. Gemini 네이티브 API 또는 OpenAI 호환 Chat Completions로 텍스트 요청을 보냅니다. 같은 키로 게이트웨이에서 지원하는 다른 모델도 호출할 수 있습니다.
Gemini 4 Neon API에는 어떤 모델 ID를 써야 하나요?
Chat Completions에서는 model 필드에, 네이티브 API에서는 /v1beta/models/{model}:generateContent의 모델 경로에 gemini-4-neon를 지정하세요. 같은 프로토콜을 쓰는 EvoLink 모델에서 전환할 때는 기존 키와 클라이언트 설정을 유지할 수 있습니다. 운영 트래픽을 전환하기 전 지원 요청 필드와 한도를 확인하세요.
EvoLink의 Gemini 4 Neon API 요금은 얼마인가요?
EvoLink에서 토큰 100만 개당 입력은 $2.850, 출력은 $14.250, 캐시 적중 입력은 $0.143입니다. 사고 토큰은 출력 요율로 청구되고 Google 검색 쿼리는 별도로 과금되며, 소량 요청에는 최소 요금이 적용됩니다. 캐시를 사용할 수 있고 해당 요청이 캐시에 적중하는 경우에 캐시 입력 요율이 적용됩니다. Google에 직접 연결할 때는 Gemini API 가격 페이지를 확인하세요.
Gemini 4 Neon은 어떤 용도로 쓸 수 있나요?
텍스트 분류, 짧은 답변, 요약, 필드 추출부터 시도하세요. 난도를 높이려면 테스트로 검증할 수 있는 여러 파일의 변경이나, 녹화와 타임스탬프를 대조할 수 있는 전사본을 사용하세요. 검증을 통과한 결과를 비교하고 사고 토큰, 재시도, 대체 모델 호출도 비용에 포함합니다.
사고 수준은 Gemini 4 Neon 가격에 어떤 영향을 주나요?
reasoning_effort 또는 네이티브 thinkingLevel을 low, medium, high, xhigh로 설정합니다. 지정하지 않으면 Neon은 high를 사용하며, xhigh가 가장 오래 사고합니다. Chat Completions에서는 EvoLink가 none과 minimal을 low로 전송합니다. 사고 토큰은 출력 요금으로 과금되며, 높은 수준이 더 나은 답변을 보장하지는 않습니다. 숫자 사고 예산은 지원하지 않습니다.
EvoLink에서 지원하는 입력, 출력, 도구는 무엇인가요?
텍스트·이미지·오디오·동영상·PDF 입력, 구조화된 JSON 출력, 함수 호출, Google 검색은 두 프로토콜 모두에서 사용할 수 있습니다. Word·PowerPoint·Excel 파일은 Gemini 네이티브 API에서 인라인 데이터나 파일 URL로 사용할 수 있습니다. Chat Completions에서는 Office 파일 URL을 받지 않으므로 base64 파일 데이터로 보내세요. 함수 호출 기록을 다시 보낼 때는 이전 응답의 사고 서명을 함께 넣으세요.
Gemini 4 Neon의 컨텍스트 윈도우와 출력 한도는 얼마인가요?
입력·사고·출력은 1,048,576토큰 윈도우 하나를 함께 쓰며, 이보다 긴 입력의 요청은 거부됩니다. 스트리밍 요청 한 번이 반환하는 것은 사고와 답변을 합쳐 최대 65,536토큰입니다. 네이티브 API에서는 더 긴 출력을 여러 요청에 걸쳐 이어받을 수 있습니다. 응답이 종료 사유 CONTINUATION으로 끝나면 그 continuationToken을 넣어 같은 요청을 다시 보내고, STOP으로 끝날 때까지 반복하세요. maxOutputTokens는 이 요청들 전체의 총 예산입니다.
Gemini 4 Neon, Hydrogen, Carbon 중 어떤 모델을 선택해야 하나요?
일상 작업에서는 Hydrogen을 기준으로 삼고, 복잡한 추론에는 Carbon도 포함하세요. 각 경로에 같은 입력과 테스트를 적용합니다. 토큰 단가가 높더라도 재시도나 수동 검토를 줄여 검증을 통과한 결과당 비용이 낮아지면 선택할 가치가 있습니다.
지금 EvoLink에서 Gemini 4 Neon API를 사용할 수 있나요?
네. EvoLink API 키와 모델 ID gemini-4-neon로 Gemini 네이티브 API 또는 OpenAI 호환 Chat Completions를 통해 호출할 수 있습니다. Google AI Studio, Vertex AI, Gemini 앱을 통한 이용은 Google이 관리하며 EvoLink와는 별개입니다.