Định dạng gốc của Gemini

Đối với các ứng dụng được phát triển dựa trên Google GenAI SDK, 4ALL API cung cấp khả năng tương thích với giao thức gốc của Gemini:

POST https://api.4allapi.com/v1beta/models/{model}:generateContent
POST https://api.4allapi.com/v1beta/models/{model}:streamGenerateContent

Ví dụ yêu cầu

curl "https://api.4allapi.com/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $AIPROXY_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "用三句话介绍黑洞"}]
    }]
  }'

Các điểm chính:

• Xác thực sử dụng header x-goog-api-key (cũng hỗ trợ tham số truy vấn ?key=);
• Đầu vào đa phương thức được truyền qua mảng parts với inline_data (ảnh base64), v.v.;
• Luồng sử dụng :streamGenerateContent, trả về các khối JSON gia tăng;
• Tham số sinh được đặt trong generationConfig (temperature, maxOutputTokens, v.v.).

Nên dùng gốc hay tương thích OpenAI?

Tình huống	Khuyến nghị
Dự án mới / chuyển đổi nhiều mô hình	Dùng giao diện tương thích OpenAI, đổi mô hình chỉ cần sửa model
Code hiện có dùng Google SDK	Dùng giao thức gốc, chỉ cần đổi base_url
Cần các trường đặc thù của Gemini (như thiết lập safety)	Dùng giao thức gốc