API Dokümantasyonu — GlomaxGPT Geliştirici Yardım Merkezi

GlomaxGPT API

OpenAI uyumlu REST API ile GlomaxGPT'nin tüm özelliklerine programatik erişim sağlayın. Metin, görsel, ses, embedding ve daha fazlası tek bir API üzerinden.

Base URL

api.glomaxgpt.com/v1

Format

application/json

Auth

Bearer Token

Uyumluluk

OpenAI API v1

💡

OpenAI uyumlu: Mevcut OpenAI SDK'larını base_url="https://api.glomaxgpt.com/v1" parametresiyle kullanabilirsiniz. Herhangi bir kod değişikliği gerekmez.

Kimlik Doğrulama

Tüm API isteklerinde Authorization başlığına Bearer token olarak API anahtarınızı ekleyin.

Authorization: Bearer sk-glomax-xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

API Anahtarı Alma

developer.glomaxgpt.com adresine gidin
Hesabınıza giriş yapın
Dashboard > API Keys bölümüne gidin
"Create new secret key" butonuna tıklayın
Anahtarı kopyalayın ve güvenli saklayın (bir kez gösterilir)

⚠️

API anahtarınızı asla kaynak koduna yazmayın veya public repoya yüklemeyin. GLOMAXGPT_API_KEY ortam değişkeni kullanın.

Modeller

API isteklerinde kullanabileceğiniz model adları.

Model ID	Açıklama	Bağlam	Giriş	Çıkış
`glomaxgpt-ultra`	En güçlü model, frontier reasoning	1.05M	$10/1M	$50/1M
`glomaxgpt-pro`	Yüksek performans, hız/kalite dengesi	1.05M	$4/1M	$20/1M
`glomaxgpt-standard`	Dengeli performans, üretim için	1.05M	$2/1M	$12/1M
`glomaxgpt-mini`	Ekonomik, yüksek hacim görevler	1.05M	$0.20/1M	$1.20/1M
`glomaxgpt-image`	Görsel oluşturma modeli	—	$0.04/görsel	—
`glomaxgpt-embed`	Metin vektörleştirme	8K	$0.02/1M	—

Tüm modelleri karşılaştır ↗

Rate Limiting

Her plan için dakika başına istek (RPM) ve token (TPM) limitleri.

Plan	RPM	TPM	Günlük Limit
Ücretsiz	20	40,000	100 istek
Standard	200	200,000	5,000 istek
Pro	500	800,000	Sınırsız
Ultra	2,000	4,000,000	Sınırsız

ℹ️

Rate limit aşıldığında 429 Too Many Requests hatası döner. Yanıt başlığındaki Retry-After değeri kadar bekleyin.

Chat Completions

Yapay zeka modelleriyle sohbet tamamlama. Sistem mesajı, kullanıcı mesajı ve asistan geçmişi ile bağlamlı konuşmalar oluşturun.

POST /v1/chat/completions Sohbet tamamlama isteği

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
`model`	string	Zorunlu	Model ID (`glomaxgpt-pro`)
`messages`	array	Zorunlu	Mesaj dizisi [{role, content}]
`temperature`	float	Opsiyonel	0-2 arası yaratıcılık (varsayılan: 1)
`max_tokens`	integer	Opsiyonel	Maksimum çıkış token sayısı
`stream`	boolean	Opsiyonel	SSE akışlı yanıt (varsayılan: false)
`top_p`	float	Opsiyonel	Nucleus sampling (varsayılan: 1)

Python Örneği

from glomaxgpt import GlomaxGPT

client = GlomaxGPT(api_key="sk-glomax-...")

response = client.chat.completions.create(
    model="glomaxgpt-pro",
    messages=[
        {"role": "system", "content": "Sen yardımcı bir asistansın."},
        {"role": "user",   "content": "Python'da bir web scraper yaz."}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)
print(f"Kullanılan token: {response.usage.total_tokens}")

cURL Örneği

curl https://api.glomaxgpt.com/v1/chat/completions \
  -H "Authorization: Bearer $GLOMAXGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glomaxgpt-pro",
    "messages": [
      {"role": "user", "content": "Merhaba! Türkiye hakkında bilgi ver."}
    ],
    "max_tokens": 500
  }'

Örnek Yanıt

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "glomaxgpt-pro",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Türkiye, Anadolu ve Trakya'yı kapsayan..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 142,
    "total_tokens": 160
  }
}

Image Generation

Metin açıklamasından yüksek kaliteli görsel oluşturun veya mevcut görseli düzenleyin.

POST /v1/images/generations Görsel oluştur

Parametre	Tip	Zorunlu	Açıklama
`prompt`	string	Zorunlu	Görsel açıklaması (max 4000 karakter)
`model`	string	Opsiyonel	`glomaxgpt-image` (varsayılan)
`size`	string	Opsiyonel	`1024x1024`, `1792x1024`, `1024x1792`
`quality`	string	Opsiyonel	`standard` veya `hd`
`n`	integer	Opsiyonel	Görsel sayısı (1-4)

response = client.images.generate(
    model="glomaxgpt-image",
    prompt="İstanbul Boğazı gün batımı, yağlı boya tablo stili, 4K",
    size="1792x1024",
    quality="hd",
    n=1
)

print(response.data[0].url)

Embeddings

Metni anlamsal vektöre dönüştürün. Semantik arama, RAG uygulamaları ve kümeleme için kullanın.

POST /v1/embeddings Metin vektörleştir

Parametre	Tip	Zorunlu	Açıklama
`input`	string/array	Zorunlu	Vektörleştirilecek metin(ler)
`model`	string	Zorunlu	`glomaxgpt-embed`
`dimensions`	integer	Opsiyonel	Vektör boyutu (256-3072)

response = client.embeddings.create(
    model="glomaxgpt-embed",
    input=["GlomaxGPT yapay zeka platformu", "AI asistan"]
)

for emb in response.data:
    print(f"Vektör boyutu: {len(emb.embedding)}")

Audio (TTS & STT)

Metni sese dönüştürün (TTS) veya sesi metne çevirin (STT).

POST /v1/audio/speech Metin → Ses (TTS)

response = client.audio.speech.create(
    model="glomaxgpt-tts",
    voice="alloy",  # alloy, echo, fable, onyx, nova, shimmer
    input="Merhaba! GlomaxGPT'ye hoş geldiniz."
)
response.stream_to_file("output.mp3")

POST /v1/audio/transcriptions Ses → Metin (STT)

with open("ses.mp3", "rb") as f:
    transcript = client.audio.transcriptions.create(
        model="glomaxgpt-whisper",
        file=f,
        language="tr"
    )
print(transcript.text)

Model Listesi

Kullanılabilir modellerin listesini alın.

GET /v1/models Tüm modelleri listele

models = client.models.list()
for model in models.data:
    print(model.id)

Hata Kodları

API'nin döndürdüğü HTTP hata kodları ve anlamları.

Kod	Anlamı	Çözüm
`400`	Geçersiz istek	Parametreleri kontrol edin
`401`	Kimlik doğrulama hatası	API anahtarını kontrol edin
`403`	Erişim reddedildi	Plan yetkinizi kontrol edin
`404`	Kaynak bulunamadı	Endpoint URL'ini kontrol edin
`429`	Rate limit aşıldı	Retry-After başlığını bekleyin
`500`	Sunucu hatası	Tekrar deneyin veya destek alın
`503`	Servis geçici kapalı	Status sayfasını kontrol edin

Python SDK

# Kurulum
pip install glomaxgpt

# Ortam değişkeni
export GLOMAXGPT_API_KEY="sk-glomax-..."

# Kullanım
from glomaxgpt import GlomaxGPT
client = GlomaxGPT()  # API key otomatik okunur

Node.js SDK

// Kurulum
npm install glomaxgpt

// Kullanım
import GlomaxGPT from 'glomaxgpt';
const client = new GlomaxGPT({ apiKey: process.env.GLOMAXGPT_API_KEY });

const response = await client.chat.completions.create({
  model: 'glomaxgpt-pro',
  messages: [{ role: 'user', content: 'Merhaba!' }]
});
console.log(response.choices[0].message.content);

cURL ile Kullanım

# Çevre değişkeni ayarla
export GLOMAXGPT_API_KEY="sk-glomax-..."

# İlk isteği gönder
curl https://api.glomaxgpt.com/v1/chat/completions \
  -H "Authorization: Bearer $GLOMAXGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glomaxgpt-pro","messages":[{"role":"user","content":"Merhaba!"}]}'

Daha fazla bilgi için

→ developer.glomaxgpt.com — Tam API referansı ve Playground → Quickstart Rehberi — 5 dakikada ilk API çağrısı → Agents SDK — Otonom AI ajanları oluşturun → Destek — API entegrasyonunda yardım alın