Chuyển đến nội dung chính
Bề mặt /v1beta/ của OrcaRouter là passthrough trực tiếp đến API Gemini của Google. Chọn đường này khi bạn muốn các tính năng Gemini không khớp định dạng OpenAI — dữ liệu âm thanh/video nội tuyến, các công cụ bản địa dựng sẵn như googleSearch, generationConfig.thinkingConfig đầy đủ, hoặc đơn giản vì bạn đã đang dùng SDK google-genai. Với chat hàng ngày, đường tương thích OpenAI (POST /v1/chat/completions với model=google/...) thường đơn giản hơn và hoạt động giữa các nhà cung cấp — xem Khả năng tương thích / Google GenAI SDK để thiết lập SDK.

​
Bố cục đường dẫn

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Các action được nhận diện:
ActionTác dụng
:generateContentPhản hồi một lượt (JSON)
:streamGenerateContentLuồng SSE của các phần dữ liệu
Các action Gemini khác (countTokens, tunedModels.*, v.v.) hiện chưa được định tuyến qua bề mặt này.

​
Xác thực

Gateway chấp nhận ba dạng header trên bề mặt này, để SDK chính thức google-genai hoạt động không cần thủ thuật header nào:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (chuỗi truy vấn, dùng cuối cùng cho công cụ không hỗ trợ đặt header)

​
Ví dụ

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."}]}]
  }'

​
Các công cụ dựng sẵn

Ba công cụ bản địa dựng sẵn của Gemini hoạt động đúng như Google công bố — truyền chúng trong mảng tools của thân yêu cầu:
Công cụTác dụng
{"googleSearch": {}}Tìm kiếm có chứng cứ web. Phản hồi mang theo groundingMetadata. OrcaRouter thu thập webSearchQueries cho mục đích tính phí.
{"codeExecution": {}}Cho phép mô hình chạy Python trong sandbox.
{"urlContext": {}}Cho phép mô hình tải và tóm tắt các URL bạn đề cập.
Ba công cụ tương tự có thể truy cập từ Chat Completions định dạng OpenAI thông qua các tên hàm dành riêng — xem Nâng cao / Tìm kiếm web và Nâng cao / Gọi công cụ.

​
Xem thêm