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

Sinh bản địa Gemini

Passthrough trực tiếp đến API Gemini của Google. Tham số model_path có dạng <model>:<action>, ví dụ google/gemini-2.5-flash:generateContent hoặc google/gemini-2.5-flash:streamGenerateContent.

Các action được hỗ trợ:

Action	Tác dụng
`:generateContent`	Phản hồi một lượt (JSON)
`:streamGenerateContent`	Luồng SSE của các phần dữ liệu

Những gì bạn có thể làm trên bề mặt này (hình dạng yêu cầu giữ nguyên JSON bản địa của Gemini; chọn đúng mô hình cho từng việc):

Chat / suy luận — bất kỳ mô hình chat gemini-* nào, kết hợp với generationConfig.thinkingConfig để kiểm soát ngân sách.
Đầu vào đa phương thức — các phần inline_data cho nội dung hình ảnh / âm thanh / video / tệp bên cạnh các phần text.
Function calling — tools: [{functionDeclarations: [...]}].
Công cụ server dựng sẵn — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
Chuyển văn bản thành giọng nói — các mô hình preview *-tts với generationConfig.responseModalities: ["AUDIO"] và speechConfig.voiceConfig.
Tạo hình ảnh — các mô hình gemini-*-image*; phản hồi mang hình ảnh dưới dạng một phần inlineData.

Xác thực chấp nhận header chuẩn Authorization: Bearer sk-orca-…, cộng thêm header kiểu Gemini x-goog-api-key và chuỗi truy vấn ?key= cho tương thích SDK google-genai — xem Lấy khóa 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."
        }
      ]
    }
  ]
}
'

{}

Ủy quyền

Authorization

string

header

bắt buộc

Khóa API của OrcaRouter có dạng sk-orca-.... Truyền chúng trong header Authorization: Bearer sk-orca-....

Tham số đường dẫn

model_path

string

bắt buộc

Nội dung

application/json

Thân yêu cầu bản địa Gemini (dạng GenerateContentRequest của Google). Xem các ví dụ để biết payload phổ biến.

Phản hồi

Phản hồi thành công. Với :generateContent thân là JSON ("GenerateContentResponse"). Với :streamGenerateContent thân là SSE (text/event-stream); mỗi sự kiện là một "GenerateContentResponse" một phần.

GenerateContentResponse bản địa của Gemini.

Tạo một message