curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

Gemini Native

Gemini 네이티브 generate

Google의 Gemini API로 직접 패스스루. model_path 매개변수는 <model>:<action>, 예를 들어 google/gemini-2.5-flash:generateContent 또는 google/gemini-2.5-flash:streamGenerateContent.

지원되는 action:

Action	동작
`:generateContent`	일회성 응답 (JSON)
`:streamGenerateContent`	부분 청크의 SSE 스트림

이 인터페이스에서 할 수 있는 것(요청 형태는 Gemini 네이티브 JSON으로 유지; 각각에 맞는 모델 선택):

채팅 / 추론 — 모든 gemini-* 채팅 모델, generationConfig.thinkingConfig와 함께 사용해 예산 제어.
멀티모달 입력 — text 파트와 함께 이미지 / 오디오 / 비디오 / 파일 컨텐츠를 위한 inline_data 파트.
함수 호출 — tools: [{functionDeclarations: [...]}].
내장 서버 도구 — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
텍스트 음성 변환 — *-tts 미리보기 모델과 generationConfig.responseModalities: ["AUDIO"] 및 speechConfig.voiceConfig 사용.
이미지 생성 — gemini-*-image* 모델; 응답이 이미지를 inlineData 파트로 운반.

인증은 표준 Authorization: Bearer sk-orca-… 헤더와 함께 google-genai SDK 호환성을 위해 Gemini 스타일 x-goog-api-key 헤더와 ?key= 쿼리 문자열을 받습니다 — API 키 발급 참조.

POST

v1beta

models

{model_path}

curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

인증

Authorization

string

header

필수

OrcaRouter API 키는 sk-orca-...처럼 보입니다. Authorization: Bearer sk-orca-... 헤더로 전달하세요.

경로 매개변수

model_path

string

필수

본문

application/json

Gemini 네이티브 요청 본문(Google의 GenerateContentRequest 형태). 일반적인 페이로드는 examples 참조.

응답

성공 응답. :generateContent의 경우 본문은 JSON (GenerateContentResponse). :streamGenerateContent의 경우 본문은 SSE(text/event-stream); 각 이벤트는 부분 GenerateContentResponse.

Gemini 네이티브 GenerateContentResponse.

메시지 생성