4AICode'un Gemini modelleri OpenAI uyumlu chat/completions protokolünü kullanır. Kullanıcıların yalnızca kendi sk-4ai-... token'larını kullanması ve model'i google/gemini-* olarak değiştirmesi gerekir. Platform, kullanılabilirliğe bağlı olarak istekleri AI Studio veya Vertex AI üzerinden yönlendirir.

Kullanılabilir modeller

Model	Önerilen kullanım alanları
`google/gemini-3.1-pro-preview`	Karmaşık muhakeme, uzun bağlam, önizleme özellikleri
`google/gemini-3-flash-preview`	Daha hızlı yanıtlar, önizleme özellikleri
`google/gemini-2.5-flash`	Günlük Soru-Cevap, hafif kodlama, düşük maliyet
`google/gemini-2.5-pro`	Karmaşık görevler, kod analizi, tutarlı kalite

Model yönlendirme

İsteğinizde google/gemini-* model adını kullanın. Platform üst sağlayıcı yönlendirmesini yönetir; güncel model kullanılabilirliği ve fiyatlar konsolda gösterilir. Üst sağlayıcı kota sınırları veya servis kesintileri kullanılabilirliği etkileyebilir.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://relay.4aicode.com/v1",
    api_key="sk-4ai-xxxxxxxxxxxxxxxx",
)

resp = client.chat.completions.create(
    model="google/gemini-2.5-flash",
    messages=[
        {"role": "user", "content": "Introduce Gemini in one sentence"},
    ],
)

print(resp.choices[0].message.content)

TypeScript / Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://relay.4aicode.com/v1",
  apiKey: "sk-4ai-xxxxxxxxxxxxxxxx",
});

const resp = await client.chat.completions.create({
  model: "google/gemini-2.5-flash",
  messages: [{ role: "user", content: "Write a TypeScript hello world" }],
});

console.log(resp.choices[0].message.content);

curl

curl https://relay.4aicode.com/v1/chat/completions \
  -H "Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {"role": "user", "content": "ping"}
    ]
  }'

Akışlı çıktı

curl https://relay.4aicode.com/v1/chat/completions \
  -H "Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "stream": true,
    "messages": [
      {"role": "user", "content": "Write a Go hello world"}
    ]
  }'

Yanıt formatı OpenAI SSE olarak kalır:

data: {"choices":[{"delta":{"content":"Hello"}}]}
data: [DONE]

Görüntü girişi

Gemini şu anda base64 data URL görüntü girişini destekler:

resp = client.chat.completions.create(
    model="google/gemini-2.5-flash",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe this image"},
            {
                "type": "image_url",
                "image_url": {
                    "url": "data:image/png;base64,iVBORw0KGgo..."
                },
            },
        ],
    }],
)

Uzak https://... görüntü URL'leri şu anda açık bir hata döner. Göndermeden önce görüntüyü indirip base64 data URL'ye dönüştürün.

Yaygın hatalar

Hata	Çözüm
`model not supported`	Model adının yukarıda listelenenlerden biri olduğunu doğrulayın
`no available google account`	Üst Gemini servisi geçici olarak kullanılamıyor; destekle iletişime geçin
`quota exceeded`	Yetersiz bakiye veya kota; yükleme yapın veya ekip yöneticinizle iletişime geçin
`upstream error`	Google üst sağlayıcı kararsızlığı veya API anahtarı kota sorunları; daha sonra yeniden deneyin

Google Gemini kullanma