만들 내용
네이티브 GeminiPOST /v1beta/models/\{model\}:generateContent 요청을 보낸 다음, 이미 채팅 완성 요청 형식을 사용하는 앱을 위한 OpenAI 호환 POST /v1/chat/completions 옵션과 비교합니다.
사전 요구 사항
COMETAPI_KEY에 저장된 CometAPI API 키- Models page에서 확인한 Gemini 텍스트 model ID
curl, Python 3.10+ 또는 Node.js 18+
API 키, base URL, 인증
Gemini 요청 필드를 사용하려면 Gemini 네이티브 엔드포인트를 사용하세요:x-goog-api-key를 사용하세요:
네이티브 Gemini 형식
네이티브 Gemini 요청은contents, parts, generationConfig를 사용합니다. thinking controls, media parts, Google Search grounding 또는 네이티브 스트리밍(Streaming) 연산자 같은 Gemini 전용 필드가 필요할 때 이 경로를 사용하세요.
OpenAI 호환 옵션
기존 OpenAI SDK 또는 채팅 완성 앱을 마이그레이션하고 있으며 Gemini 네이티브 요청 필드가 필요하지 않다면 OpenAI 호환 경로를 사용하세요.흐름 설명
두 요청 형식을 섞어 사용하지 마세요.
contents, generationConfig 같은 네이티브 Gemini 필드는 generateContent 경로에 사용해야 합니다. messages 같은 채팅 완성 필드는 OpenAI 호환 경로에 사용해야 합니다.
문제 해결 / FAQ
어떤 경로로 시작해야 하나요
어떤 경로로 시작해야 하나요
새로운 Gemini 워크플로를 구축하는 경우 네이티브 Gemini
generateContent로 시작하세요. 기존 앱이 이미 OpenAI SDK 또는 채팅 완성 요청 형식에 의존하고 있다면 OpenAI 호환 경로를 사용하세요.채팅 완성에서 네이티브 Gemini 필드가 실패합니다
채팅 완성에서 네이티브 Gemini 필드가 실패합니다
contents, parts, generationConfig, streamGenerateContent 요청은 Gemini 네이티브 엔드포인트로 보내세요. OpenAI 호환 경로는 messages와 채팅 완성 파라미터를 기대합니다.Gemini model ID가 실패합니다
Gemini model ID가 실패합니다
해당 model ID를 계정에서 사용할 수 있고 호출하려는 경로를 지원하는지 확인하세요. 현재 model ID는 Models page에서 찾을 수 있습니다.
SDK가 잘못된 서비스를 가리킵니다
SDK가 잘못된 서비스를 가리킵니다
Google GenAI SDK 요청의 경우 base URL을
https://api.cometapi.com으로 설정하세요. OpenAI SDK 요청의 경우 Python에서는 base_url, Node.js에서는 baseURL을 https://api.cometapi.com/v1로 설정하세요.다음 단계
- 전체
generateContent요청 및 응답 필드는 Gemini 네이티브 API reference를 사용하세요. - OpenAI 호환 요청 형식은 채팅 완성 API reference를 읽어보세요.
- OpenAI SDK 클라이언트는 Use CometAPI with OpenAI SDKs에서 구성하세요.
- 사용 가능한 모델은 List available CometAPI models로 확인하세요.
- 재시도 및 rate-limit 처리는 Error codes and retry strategy를 추가하세요.