Entegrasyonlar — OpenAI uyumlu her araç Maximize ile çalışır

Tek base URL, tek anahtar: OpenAI API'si konuşan herhangi bir aracı https://www.themaximize.ai/v1 adresine yönlendirin, Maximize üzerinde çalışsın — arkasında TL faturalama, KVKK veri-yerleşimi filtresi (/v1/models?kvkk_yurtici=true) ve yerli destek.

Tam API referansı →

🤖 AI Ajanları🧩 IDE Eklentileri📚 Geliştirici Kütüphaneleri💬 Hazır Arayüzler⚙️ Otomasyon Platformları

🤖 AI Ajanları

Hermes Agent

Nous Research'ün açık kaynak, kalıcı hafızalı otonom ajanı — kendi makinenizde çalışır.

# ~/.hermes/config.yaml  (veya: hermes model → Custom endpoint)
model: claude-sonnet-5
provider: custom
base_url: https://www.themaximize.ai/v1
api_key: sk-...

Not: base_url doluysa provider yok sayılır; /model custom model listesini /v1/models'ten kendisi keşfeder.

aider

Terminalde çalışan açık kaynak yapay zekâ kodlama ajanı.

export OPENAI_API_BASE=https://www.themaximize.ai/v1
export OPENAI_API_KEY=sk-...
aider --model openai/claude-sonnet-5

Not: Model adına openai/ öneki ZORUNLU — öneksiz ad başka sağlayıcıya yönlenir. Bilinmeyen model uyarısı çalışmayı engellemez.

OpenAI Agents SDK

OpenAI'ın resmî Python ajan çatısı — özel endpoint ile çalışır.

from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, set_tracing_disabled

set_tracing_disabled(True)   # yoksa trace'ler api.openai.com'a gider -> 401
client = AsyncOpenAI(base_url="https://www.themaximize.ai/v1", api_key="sk-...")
agent = Agent(name="Asistan", instructions="...",
              model=OpenAIChatCompletionsModel(model="claude-sonnet-5", openai_client=client))

Not: OpenAIChatCompletionsModel şart — SDK varsayılanı Responses API'dir ve özel endpoint'te 404 döner.

🧩 IDE Eklentileri

Cline

VS Code'da otonom kodlama ajanı.

VS Code → Cline → Settings → API Configuration:
  API Provider : OpenAI Compatible
  Base URL     : https://www.themaximize.ai/v1
  API Key      : sk-...
  Model        : claude-sonnet-5

Not: Model kimliği elle yazılır; Base URL /v1 son ekini içermeli.

Roo Code

VS Code'da çoklu-mod kodlama ajanı.

VS Code → Roo Code → Settings → Providers:
  API Provider : OpenAI Compatible
  Base URL     : https://www.themaximize.ai/v1
  API Key      : sk-...
  Model        : claude-sonnet-5

Not: Roo Code yalnız native tool-calling kullanır — Maximize'ın OpenAI formatındaki tools desteğiyle birebir çalışır. Model metaverisi (bağlam penceresi vb.) elle tanımlanır.

Continue.dev

VS Code ve JetBrains için açık kaynak yapay zekâ asistanı.

# ~/.continue/config.yaml
models:
  - name: Claude Sonnet 5 (Maximize)
    provider: openai
    model: claude-sonnet-5
    apiBase: https://www.themaximize.ai/v1
    apiKey: sk-...
    roles: [chat, edit, apply]
    capabilities: [tool_use]

Not: Agent modu için capabilities: [tool_use] ekleyin; config.json artık kullanımdan kalktı, config.yaml kullanın.

📚 Geliştirici Kütüphaneleri

OpenAI SDK (Python / Node.js)

Mevcut OpenAI kodunuz iki satır değişiklikle çalışır.

from openai import OpenAI
client = OpenAI(base_url="https://www.themaximize.ai/v1", api_key="sk-...")
resp = client.chat.completions.create(model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Merhaba"}])

Not: Env var yolu: OPENAI_BASE_URL + OPENAI_API_KEY — kod değişikliği bile gerekmez. chat.completions kullanın (responses API'si desteklenmez).

Vercel AI SDK

TypeScript/Next.js uygulamaları için yapay zekâ araç seti.

import { createOpenAI } from '@ai-sdk/openai';
import { generateText } from 'ai';

const maximize = createOpenAI({
  baseURL: 'https://www.themaximize.ai/v1',
  apiKey: process.env.MAXIMIZE_API_KEY,
});
const { text } = await generateText({
  model: maximize.chat('claude-sonnet-5'), prompt: 'Merhaba' });

Not: maximize.chat('...') kullanın — düz maximize('...') v5'te Responses API'ye gidip 404 alabilir.

LangChain

En yaygın Python LLM uygulama çatısı.

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="claude-sonnet-5",
                 base_url="https://www.themaximize.ai/v1", api_key="sk-...")

Not: Env var ikilisine dikkat: LangChain OPENAI_API_BASE okur, openai SDK OPENAI_BASE_URL — ikisi farklı değişken.

LlamaIndex

RAG ve veri-ajanları çatısı.

from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(model="claude-sonnet-5",
                 api_base="https://www.themaximize.ai/v1", api_key="sk-...",
                 is_chat_model=True, is_function_calling_model=True,
                 context_window=200000)

Not: OpenAILike sınıfını kullanın (düz OpenAI sınıfı bilinmeyen model adında hata verir); is_chat_model=True şart — varsayılan False ve eski completions ucuna gider.

CrewAI

Çoklu-ajan ekipleri kurma çatısı.

from crewai import LLM

llm = LLM(model="openai/claude-sonnet-5",   # openai/ öneki şart
          base_url="https://www.themaximize.ai/v1", api_key="sk-...")

Not: Model adına openai/ öneki ekleyin; env var adı OPENAI_BASE_URL (OPENAI_API_BASE değil).

Microsoft AutoGen

Microsoft'un çoklu-ajan konuşma çatısı (0.4+).

from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_core.models import ModelInfo

client = OpenAIChatCompletionClient(
    model="claude-sonnet-5", base_url="https://www.themaximize.ai/v1", api_key="sk-...",
    model_info=ModelInfo(vision=False, function_calling=True,
                         json_output=True, structured_output=True, family="unknown"))

Not: model_info ZORUNLU — verilmezse istemci model yeteneklerini çözemeyip hata verir.

💬 Hazır Arayüzler

Open WebUI

Kendi sunucunuzda barındırılan sohbet arayüzü.

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://www.themaximize.ai/v1 \
  -e OPENAI_API_KEY=sk-... \
  -v open-webui:/app/backend/data ghcr.io/open-webui/open-webui:main

Not: Arayüzden: Admin Settings → Connections → OpenAI → + Add Connection. Model listesi /v1/models'ten otomatik gelir. Env değerleri yalnız İLK açılışta okunur; sonrası panelden.

LibreChat

Açık kaynak, çok sağlayıcılı sohbet arayüzü.

# librechat.yaml
endpoints:
  custom:
    - name: "Maximize"
      apiKey: "${MAXIMIZE_API_KEY}"
      baseURL: "https://www.themaximize.ai/v1"
      models:
        default: ["claude-sonnet-5"]
        fetch: true
      titleConvo: true
      titleModel: "claude-sonnet-5"

Not: titleModel'i mutlaka ayarlayın — verilmezse başlık üretimi var olmayan bir OpenAI modelini çağırıp hata verir.

⚙️ Otomasyon Platformları

n8n

Görsel iş akışı otomasyonu — yapay zekâ düğümleriyle.

n8n → Credentials → New → OpenAI:
  API Key  : sk-...
  Base URL : https://www.themaximize.ai/v1

İş akışında: AI Agent → OpenAI Chat Model düğümü → bu credential
  Model: claude-sonnet-5  (listede yoksa ID olarak elle girin)

Not: n8n 1.73+ kullanın (Base URL credential'a taşındı). AI Agent + OpenAI Chat Model düğümünü tercih edin — 'Message a model' v2 düğümü özel endpoint'lerde 404 verebiliyor.

Flowise

Sürükle-bırak LLM akış tasarımcısı.

Flowise → Credential: OpenAI API (openAIApiKey: sk-...)
Node: ChatOpenAI Custom
  Model Name : claude-sonnet-5
  Additional Parameters → Base Path: https://www.themaximize.ai/v1

Not: Base Path alanı düğümün Additional Parameters bölümünde gizli; özel model adı için ChatOpenAI Custom düğümünü kullanın.

API anahtarınızı 2 dakikada alın

Kaydolun, anahtarınızı kopyalayın, bu sayfadaki herhangi bir araca yapıştırın.

Ücretsiz hesap oluştur → API dokümantasyonu