메인 콘텐츠로 건너뛰기
OrcaRouter의 /v1beta/ 인터페이스는 Google Gemini API에 대한 직접 패스스루입니다. OpenAI 형태에 맞지 않는 Gemini 기능 — 인라인 오디오/비디오 데이터, googleSearch 같은 네이티브 내장 도구, 완전한 generationConfig.thinkingConfig, 또는 단순히 이미 google-genai SDK를 쓰고 있을 때 — 이 경로를 선택하세요. 일상적인 채팅에는 OpenAI 호환 경로 (POST /v1/chat/completions에 model=google/...)가 보통 더 간단하고 프로바이더 간 동일하게 작동합니다 — SDK 설정은 호환성 / Google GenAI SDK를 참조하세요.

​
경로 레이아웃

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
인식되는 action:
Action동작
:generateContent일회성 응답 (JSON)
:streamGenerateContent부분 청크의 SSE 스트림
다른 Gemini 작업(countTokens, tunedModels.* 등)은 현재 이 인터페이스로 라우팅되지 않습니다.

​
인증

이 인터페이스는 세 가지 헤더 형식을 받아들여 공식 google-genai SDK가 헤더 해킹 없이 작동합니다:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (쿼리 문자열, 헤더를 설정할 수 없는 도구를 위한 최후의 수단)

​
예시

curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Write a one-sentence haiku about the sea."}]}]
  }'

​
내장 도구

Gemini의 세 가지 네이티브 내장 도구는 Google이 문서화한 대로 작동 합니다 — 요청 본문의 tools 배열에 전달하세요:
도구효과
{"googleSearch": {}}웹 그라운딩. 응답에 groundingMetadata가 포함됩니다. OrcaRouter는 청구를 위해 webSearchQueries를 캡처합니다.
{"codeExecution": {}}모델이 샌드박스 Python을 실행하게 합니다.
{"urlContext": {}}모델이 언급한 URL을 가져와 요약할 수 있게 합니다.
동일한 세 가지 도구는 OpenAI 형태 Chat Completions에서도 예약된 함수 이름으로 접근할 수 있습니다 — 고급 기능 / 웹 검색과 고급 기능 / 도구 호출을 참조하세요.

​
관련 항목