Maximize AI API

Claude AI modellerine erişim sağlayan, token bazlı fiyatlandırmalı REST API. OpenAI uyumlu format kullanır — mevcut entegrasyonlarınızı kolayca taşıyabilirsiniz.

Base URL: https://www.themaximize.ai

Kimlik Doğrulama

Her istekte X-API-Key header'ı ile API key'inizi gönderin.

curl https://www.themaximize.ai/v1/chat/completions \
  -H "X-API-Key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{...}'

API key'inizi asla paylaşmayın veya client-side kodda kullanmayın.

Modeller & Fiyatlar

Tüm modeller aynı endpoint üzerinden kullanılır. model parametresiyle seçim yapın.

claude-haiku-4-5

Hızlı ve ekonomik — chatbot, sınıflandırma, özet

Input $2 · Output $10
/ 1M token

claude-sonnet-4-6

Dengeli — kod yazma, analiz, uzun içerik

Input $6 · Output $30
/ 1M token

claude-opus-4-8

En güçlü — karmaşık görevler, araştırma, akıl yürütme

Input $10 · Output $50
/ 1M token

💚 Ekonomi Modelleri

Açık kaynak modeller — bütçe dostu, yüksek hacimli işler için. Claude'dan çok daha ucuz.

llama-3.3-70b

Ekonomik & güçlü — genel amaçlı, Claude'dan ~10× ucuz

Input $0.60 · Output $0.90
/ 1M token

llama-3.1-8b

Ultra ucuz & hızlı — basit görevler, yüksek hacim

Input $0.15 · Output $0.20
/ 1M token

Chat Completions

POST /v1/chat/completions

Claude modelleri ile sohbet tamamlama isteği gönderir.

İstek Parametreleri

Parametre	Tip	Açıklama
messages*	array	Sohbet mesajları dizisi
model?	string	Model ID (varsayılan: claude-haiku-4-5)
max_tokens?	integer	Maksimum çıktı token (varsayılan: 512)
temperature?	float	Yaratıcılık 0-1 arası (varsayılan: 0.7)
stream?	boolean	Akış modu (varsayılan: false)

Örnek İstek

{
  "model": "claude-haiku-4-5",
  "messages": [
    {"role": "system", "content": "Sen yardımcı bir asistansın."},
    {"role": "user",   "content": "Python'da hello world yaz."}
  ],
  "max_tokens": 200,
  "temperature": 0.7
}

Örnek Yanıt

{
  "id": "msg_01abc...",
  "object": "chat.completion",
  "model": "claude-haiku-4-5",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "print('Hello, World!')"
    },
    "finish_reason": "end_turn"
  }],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 12,
    "total_tokens": 40
  }
}

Billing

GET /billing/usage

Kullanım istatistiklerinizi ve kalan bakiyenizi görüntüler.

curl https://www.themaximize.ai/billing/usage \
  -H "X-API-Key: sk-your-api-key"

Araçlar (Function Calling)

Kendi fonksiyonlarınızı tanımlayın — Claude hangisini ne zaman çağıracağına karar verir, siz kendi sisteminizde çalıştırıp sonucu geri gönderirsiniz. OpenAI tools formatıyla birebir uyumlu.

Akış: 1) Araçlarınızı gönderin → 2) Claude bir aracı çağırır (tool_calls) → 3) Fonksiyonu çalıştırıp sonucu tool rolüyle geri gönderin → 4) Claude nihai cevabı üretir.

Örnek (OpenAI SDK)

from openai import OpenAI
import json

client = OpenAI(api_key="sk-...", base_url="https://www.themaximize.ai/v1")

def get_weather(city):
    return f"{city}: 22 derece, gunesli"   # kendi fonksiyonunuz

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Bir sehrin hava durumunu doner",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

messages = [{"role": "user", "content": "Ankara'da hava nasil?"}]

while True:
    resp = client.chat.completions.create(
        model="claude-haiku-4-5", messages=messages, tools=tools)
    msg = resp.choices[0].message
    if not msg.tool_calls:
        print(msg.content)   # nihai cevap
        break
    messages.append(msg)
    for tc in msg.tool_calls:
        args = json.loads(tc.function.arguments)
        result = get_weather(**args)        # fonksiyonu calistir
        messages.append({"role": "tool", "tool_call_id": tc.id, "content": result})

Not: Araç kullanırken stream: true desteklenmez — tam tool_calls gerekir.

Webhooks

Dashboard'dan webhook URL'nizi kaydedin. Bakiye olaylarında sisteminize imzalı POST isteği göndeririz. Her istek X-Webhook-Signature ve X-Webhook-Timestamp header'larıyla gelir.

Olay Tipleri

Olay	Açıklama
balance.low	Bakiye $2.00 altına düştü
balance.depleted	Bakiye sıfırlandı
webhook.test	Test bildirimi

Örnek Payload

{
  "event": "balance.low",
  "created": 1719273600,
  "data": {
    "name": "Müşteri Adı",
    "balance_usd": 1.85,
    "threshold": 2.0
  }
}

İmza Doğrulama (Python)

import hmac, hashlib

def verify(secret, timestamp, body, signature):
    msg = f"{timestamp}.{body}".encode()
    expected = hmac.new(secret.encode(), msg, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

# Flask örneği:
# sig = request.headers["X-Webhook-Signature"]
# ts  = request.headers["X-Webhook-Timestamp"]
# verify(MY_SECRET, ts, request.get_data(as_text=True), sig)

Hata Kodları

Kod	Açıklama
401	Geçersiz veya eksik API key
402	Yetersiz bakiye — bakiye yükleyin
429	Rate limit aşıldı — bekleyin ve tekrar deneyin
500	Sunucu hatası

OpenAI Kütüphanesiyle Kullanım

Mevcut OpenAI kodunuzu değiştirmeden kullanabilirsiniz — sadece base_url ve api_key değiştirin. Tüm OpenAI SDK'ları (Python, Node.js, LangChain, vb.) çalışır.

base_url: https://www.themaximize.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://www.themaximize.ai/v1"
)

response = client.chat.completions.create(
    model="claude-haiku-4-5",
    messages=[{"role": "user", "content": "Merhaba!"}]
)

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

Node.js için:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://www.themaximize.ai/v1"
});

const response = await client.chat.completions.create({
  model: "claude-haiku-4-5",
  messages: [{ role: "user", content: "Merhaba!" }]
});

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

Python Örneği (requests)

import requests

API_KEY = "sk-your-api-key"
BASE_URL = "https://www.themaximize.ai"

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
    json={
        "model": "claude-haiku-4-5",
        "messages": [{"role": "user", "content": "Merhaba!"}],
        "max_tokens": 100
    }
)

print(response.json()["choices"][0]["message"]["content"])

Node.js Örneği

const response = await fetch(
  "https://www.themaximize.ai/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "X-API-Key": "sk-your-api-key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "claude-haiku-4-5",
      messages: [{ role: "user", content: "Merhaba!" }],
      max_tokens: 100
    })
  }
);

const data = await response.json();
console.log(data.choices[0].message.content);

cURL Örneği

curl https://www.themaximize.ai/v1/chat/completions \
  -H "X-API-Key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Merhaba!"}],
    "max_tokens": 100
  }'