TokenLab

Gemini 네이티브

콘텐츠 스트림 생성

Google Gemini API 형식을 사용하여 콘텐츠 생성을 스트리밍합니다

POST
/v1beta/models/{model}:streamGenerateContent

Gemini generateContent의 SSE 버전입니다. 이벤트에는 메타데이터만 포함되거나 finishReason이 없는 중간 콘텐츠만 포함될 수 있습니다. 스트림은 자연스러운 EOF에서 종료되며 [DONE] 마커를 추가하지 않습니다.

경로 매개변수

modelstringpath필수

모델 이름 (예: gemini-2.5-pro, gemini-3.5-flash).

쿼리 매개변수

keystringquery

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"}]
      }
    ]
  }'

응답

Stream Chunk
{
  "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..."
          }
        }
      ]
    }
  ]
}

인증

AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

model*string

모델 이름 (예: gemini-2.5-pro)

쿼리 매개변수

key?string

API 키 (헤더 인증의 대안)

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. 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