Gemini 네이티브 형식

Google GenAI SDK 기반으로 개발된 애플리케이션을 위해, 4ALL API는 Gemini 네이티브 프로토콜 호환을 제공합니다:

POST https://api.4allapi.com/v1beta/models/{model}:generateContent
POST https://api.4allapi.com/v1beta/models/{model}:streamGenerateContent

요청 예시

curl "https://api.4allapi.com/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $AIPROXY_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "용三句话介绍黑洞"}]
    }]
  }'

주요 사항:

• 인증은 x-goog-api-key 헤더를 사용합니다(?key= 쿼리 파라미터도 호환);
• 멀티모달 입력은 parts 배열을 통해 inline_data(base64 이미지) 등을 전달합니다;
• 스트리밍은 :streamGenerateContent를 사용하며, 증분 JSON 청크를 반환합니다;
• 생성 파라미터는 generationConfig 안에 배치합니다(temperature, maxOutputTokens 등).

네이티브 프로토콜과 OpenAI 호환 중 어느 것을 사용해야 할까요?

상황	권장 사항
신규 프로젝트 / 다중 모델 전환	OpenAI 호환 인터페이스 사용, 모델 변경 시 model만 수정
기존 Google SDK 코드	네이티브 프로토콜 사용, base_url만 변경하면 됨
Gemini 고유 필드 필요 시(예: safety 설정)	네이티브 프로토콜 사용