Gemini 네이티브
콘텐츠 스트림 생성
Google Gemini API 형식을 사용하여 콘텐츠 생성을 스트리밍합니다
Gemini generateContent의 SSE 버전입니다. 이벤트에는 메타데이터만 포함되거나 finishReason이 없는 중간 콘텐츠만 포함될 수 있습니다. 스트림은 자연스러운 EOF에서 종료되며 [DONE] 마커를 추가하지 않습니다.
경로 매개변수
모델 이름 (예: gemini-2.5-pro, gemini-3.5-flash).
쿼리 매개변수
API 키 (헤더 인증의 대안).
인증
콘텐츠 생성과 동일: ?key=, x-goog-api-key, 또는 Authorization: Bearer.
요청 본문
콘텐츠 생성과 동일합니다. 여기에는 비전 요청을 위한 구조화된 inline_data 이미지 파트가 포함된 멀티모달 parts 배열이 포함됩니다.
generationConfig.candidateCount, 도구, 미디어 유형 및 기타 선택적 필드에 대한 지원은 선택한 모델에 따라 달라집니다.
응답
Gemini Server-Sent Events를 반환합니다. 메타데이터 전용 이벤트, finishReason이 없는 중간 청크, 자연스러운 EOF 모두 유효합니다. 이 스트림에는 Chat Completions의 [DONE] 센티널이 추가되지 않습니다. 각 이벤트는 하나의 JSON 청크를 담고 있는 data: 라인입니다. 응답은 항상 SSE이며, alt=sse는 허용되지만 필수는 아닙니다.
첫 번째 이벤트 전에 발생하는 오류는 콘텐츠 생성과 동일한 코드를 가진 JSON Gemini 오류를 반환합니다.
요청
curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Tell me a story"}]
}
]
}'응답
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Once upon a time"}
]
}
}
]
}비전 입력 예시
스트리밍 비전 요청은 비스트리밍 엔드포인트와 동일한 contents[].parts[] 구조를 사용합니다.
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
모델 이름 (예: gemini-2.5-pro)
쿼리 매개변수
API 키 (헤더 인증의 대안)
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
application/json
네이티브 Gemini GenerateContent 요청입니다. ProtoJSON lowerCamelCase와 원본 proto snake_case 이름 모두 허용되며 혼합 요청을 포함하여 보존됩니다. 한 필드에 대해 두 가지 표기법이 모두 존재할 경우, TokenLab은 이를 병합하거나 로컬 우선순위를 선택하지 않습니다. 알 수 없는 필드는 최선의 노력으로 전달됩니다.
응답
text/event-stream
application/json
application/json
application/json
application/json
application/json