Skip to main content

만들 내용

네이티브 Gemini POST /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 네이티브 엔드포인트를 사용하세요:
직접 네이티브 Gemini HTTP 요청을 보낼 때는 x-goog-api-key를 사용하세요:
애플리케이션이 이미 채팅 완성을 사용하는 경우에만 OpenAI 호환 base URL을 사용하세요:

네이티브 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 호환 경로를 사용하세요.
contents, parts, generationConfig, streamGenerateContent 요청은 Gemini 네이티브 엔드포인트로 보내세요. OpenAI 호환 경로는 messages와 채팅 완성 파라미터를 기대합니다.
해당 model ID를 계정에서 사용할 수 있고 호출하려는 경로를 지원하는지 확인하세요. 현재 model ID는 Models page에서 찾을 수 있습니다.
Google GenAI SDK 요청의 경우 base URL을 https://api.cometapi.com으로 설정하세요. OpenAI SDK 요청의 경우 Python에서는 base_url, Node.js에서는 baseURLhttps://api.cometapi.com/v1로 설정하세요.

다음 단계