İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Kişisel API anahtarları

Kodlama araçları ve kendi projeleriniz için kişisel bir API anahtarı oluşturun ve yönetin.

Kişisel bir API anahtarı, Workspace'inizin modellerine ajan dışından ulaşmanızı sağlar; böylece Claude Code, GitHub Copilot veya Codex gibi kodlama araçlarında ya da kendi projenizde kullanabilirsiniz. Anahtar sizin adınıza kimlik doğrular; bu da kullanım bütçenizi harcadığı ve yalnızca completion uç noktalarına ulaştığı anlamına gelir.

Hesap ayarlarınızda API keys görünmeden önce yöneticinizin size erişim vermesi gerekir. Bu erişim sayfanın görünüp görünmeyeceğini kontrol eder. Kişisel API kullanımı etkili kişisel bütçenize ve Workspace harcama limitine sayılır. Etkili kişisel bütçeniz tükenirse kişisel API istekleri yedek modele geçmek yerine hata döndürür. Workspace harcama limitine ulaşılırsa kişisel API istekleri yedek modele geçmek yerine hata döndürür. Workspace yöneticiniz limiti yükseltmeli veya Unlimited yapmalı ya da mevcut fatura döneminin sıfırlanmasını beklemelisiniz.

Kişisel bir API anahtarı oluşturma

API keys'i açın

Settings > Account > API keys sayfasına gidin.

Anahtar ayrıntılarını girin

Create API key'e tıklayın. Daha sonra hangi aracı güncelleyeceğinizi bilmeniz için anahtara nerede kullanıldığını anlatan bir ad verin ve ne zaman sona ereceğini seçin.

Anahtarı oluşturun ve kopyalayın

Create API key'e tıklayın, ardından anahtarı kopyalayın ve güvenli bir yerde saklayın. ajan onu bir kez gösterir ve bir daha asla göstermez.

Kişisel bir API anahtarını asla paylaşmayın. Sizin adınıza kimlik doğrular ve bütçenizi harcar; bu yüzden onu elinde tutan herkes sizin yerinize çalışır. Paylaşılan uygulamalar ve otomasyonlar için bir Workspace API anahtarı kullanın; anahtarları güvenli saklamak için API key best practices sayfasına bakın.

Sayfa ayrıca bütçenizin ne kadarını kullandığınızı ve ne zaman sıfırlandığını da takip eder. Bireysel limitinizde bir şey kalmamışsa kişisel API istekleri yedek modele geçmek yerine hata döndürür. Kullanım istekleri etkinleştirildiğinde daha yüksek bir limit talep edebilir veya Workspace yöneticinizden isteyebilirsiniz. Workspace harcama limitine ulaştıysa bireysel limitinizi artırmak API erişimini geri getirmez. Workspace yöneticiniz Workspace limitini yükseltmeli veya Unlimited yapmalı ya da mevcut fatura döneminin sıfırlanmasını beklemelisiniz.

Bir araç bağlama

Connect your tools, Claude Code, Claude Desktop, OpenCode, Codex, GitHub Copilot ve cURL ile doğrudan API çağrıları için kurulumda size yol gösterir. Aynı anahtarla Cursor'ı da bağlayabilirsiniz. Kullanılabilir bir model seçin; örnekler buna göre güncellenir, ardından aracınız için adımları izleyin.

Aşağıdaki rehberler bu kuruluma uyar. Kullanılabilir API'lere genel bakış için ajan Completion APIs sayfasına bakın. YOUR_API_KEY yerine anahtarınızı, your-model-id yerine Available models içinden bir kimlik koyun. Workspace'inizin model bölgesine uyması için eu veya us kullanın. global bölgesinde OpenAI uyumlu bir model için /openai/global/v1 kullanın ve modelleri /openai/global/v1/models adresinde listeleyin. Dedicated deployments'ta temel URL https://api.ajan.io yerine dağıtımınızın origin'iyle başlar.

Claude Code, ajan üzerinden Anthropic Messages API'yi kullanır.

Kullanılabilir Claude modellerini kontrol edin

bash
        curl https://api.ajan.io/anthropic/eu/v1/models \
          -H "Authorization: Bearer YOUR_API_KEY"

Ayarlarınızı ekleyin

Bunu ~/.claude/settings.json dosyasına ekleyin (Windows'ta: %USERPROFILE%\.claude\settings.json); yoksa oluşturun. Model kimliklerini önceki adımdakilerle değiştirin ve ANTHROPIC_API_KEY ayarlı olmadığından emin olun:

json
        {
          "env": {
            "ANTHROPIC_BASE_URL": "https://api.ajan.io/anthropic/eu",
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_MODEL": "your-model-id",
            "ANTHROPIC_SMALL_FAST_MODEL": "your-model-id"
          }
        }

Claude Code'u başlatın

bash
        claude

Claude Code, ajan'ın yukarıdaki temel URL'de sunduğu Anthropic Messages API'yi konuşur. Tüm istekler artık Workspace'iniz üzerinden yönlendirilir.

Claude Desktop, üçüncü taraf çıkarım üzerinden ajan modellerinde sohbet çalıştırabilir.

Developer Mode'u etkinleştirin

Claude Desktop'ta Help → Troubleshooting → Enable Developer Mode'u açın.

Gateway'i yapılandırın

Developer → Configure third-party inference'ı açın. Inference provider'ı Gateway olarak ayarlayın. Gateway credentials altında şunları girin:

        Gateway base URL:    https://api.ajan.io/anthropic/eu
        Gateway API key:     YOUR_API_KEY
        Gateway auth scheme: bearer
        Credential kind:     Static API key

Test edin ve uygulayın

Model discovery'yi etkin tutun, ardından Test connection ve Test model discovery'ye tıklayın. Claude Workspace'inizde kullanılabilir Anthropic modellerini keşfeder. Save Changes'e, ardından Apply Changes'e tıklayın. Claude yeniden başlar; istenirse Continue with Gateway'i seçin.

Cursor'ın Connect your tools altında henüz yerleşik bir kartı yoktur. OpenAI sağlayıcısını ajan'a yönlendirin:

Model ayarlarını açın

Cursor'da Cursor Settings > Models'ı açın.

Anahtarınızı ve temel URL'nizi ekleyin

Kişisel API anahtarınızı OpenAI sağlayıcı alanına yapıştırın ve Save'e tıklayın. Override OpenAI Base URL'i açın ve sondaki eğik çizgi olmadan /v1 ile şu URL'yi girin:

        https://api.ajan.io/openai/eu/v1

Bir Workspace modeli ekleyin

Available models içinden bir modelin tam kimliğini girin, ardından Add Custom Model'e tıklayın. Sohbet için o modeli seçin.

Cursor'daki özel API anahtarları yalnızca sohbet modellerini kapsar. Tab tamamlama Cursor'ın yerleşik modellerini kullanmaya devam eder. Agent mode HTTP 400 hatasıyla başarısız olur çünkü ajan'ın Chat Completions uç noktası yalnızca function türündeki araçları kabul eder. Ajanik kodlama için bunun yerine Claude Code, Codex, GitHub Copilot veya OpenCode kullanın.

Codex, ajan'ın OpenAI Responses uç noktasını kullanır (wire_api = "responses").

Yapılandırmanızı ekleyin

Bunu ~/.codex/config.toml dosyasına ekleyin (Windows'ta: %USERPROFILE%\.codex\config.toml); yoksa oluşturun:

toml
        model = "your-model-id"
        model_provider = "workspace"

        [model_providers.workspace]
        name = "ajan"
        base_url = "https://api.ajan.io/openai/eu/v1"
        wire_api = "responses"
        experimental_bearer_token = "YOUR_API_KEY"

Codex'i başlatın

bash
        codex

Veya Codex / ChatGPT masaüstü uygulamasını açın. Bu dosya anahtarınızı bu bilgisayarda saklar. Makineyi paylaşıyorsanız anahtarı ajan'da iptal edin ve yeni bir tane oluşturun.

GitHub Copilot, ajan'ın OpenAI Chat Completions uç noktasını kullanır. VS Code'da Copilot Chat, agent mode ve Copilot CLI araç destekleyen OpenAI uyumlu bir modele ihtiyaç duyar.

VS Code'da özel bir uç nokta ekleyin

VS Code'da Command Palette'i açın ve Chat: Manage Language Models'ı çalıştırın. Add Models → Custom Endpoint'i seçin. Grup adı olarak ajan kullanın, API anahtarınızı yapıştırın ve Chat Completions'ı seçin.

Sağlayıcıyı ekleyin

VS Code chatLanguageModels.json dosyasını açar. Bu sağlayıcıyı ekleyin veya zaten sahip olduklarınızla birleştirin, kaydedin, ardından Chat seçicide modeli seçin:

json
        [
          {
            "name": "ajan",
            "vendor": "customendpoint",
            "apiKey": "YOUR_API_KEY",
            "apiType": "chat-completions",
            "models": [
              {
                "id": "your-model-id",
                "name": "Your model",
                "url": "https://api.ajan.io/openai/eu/v1/chat/completions",
                "toolCalling": true,
                "streaming": true
              }
            ]
          }
        ]

Veya Copilot CLI kullanın

Bunu terminalinizde çalıştırın. Kalıcı olmaları için export'ları kabuk profilinize ekleyin. Windows'ta aynı değerleri $env: ile ayarlayın:

bash
        export COPILOT_PROVIDER_BASE_URL="https://api.ajan.io/openai/eu/v1"
        export COPILOT_PROVIDER_API_KEY="YOUR_API_KEY"
        export COPILOT_MODEL="your-model-id"
        copilot

Bu bağlantının kapsadığı şeyler

Bu, Copilot Chat, agent mode ve Copilot CLI'yi Workspace'iniz üzerinden yönlendirir. Satır içi ghost-text tamamlamalar hâlâ GitHub'ı kullanır. Copilot Business veya Enterprise kuruluşlarının Bring Your Own Language Model Key politikasını etkinleştirmek için bir yöneticiye ihtiyacı olabilir.

OpenCode, ajan üzerinden Anthropic uyumlu uç noktayı kullanır.

Yapılandırmanızı ekleyin

Bunu projenizdeki opencode.json dosyasına veya ~/.config/opencode/opencode.json dosyasına ekleyin (Windows'ta: %USERPROFILE%\.config\opencode\opencode.json). models altında daha fazla Workspace modeli listeleyebilirsiniz:

json
        {
          "$schema": "https://opencode.ai/config.json",
          "provider": {
            "workspace": {
              "npm": "@ai-sdk/anthropic",
              "name": "ajan",
              "options": {
                "baseURL": "https://api.ajan.io/anthropic/eu/v1"
              },
              "models": {
                "your-model-id": { "name": "Your model" }
              }
            }
          }
        }

OpenCode'u başlatın ve bağlayın

bash
        opencode

/connect çalıştırın, Other'ı seçin, sağlayıcı kimliği olarak workspace girin, ardından API anahtarınızı yapıştırın.

Modeli seçin

Modeli /models ile seçin veya OpenCode'u doğrudan onunla başlatın:

bash
        opencode --model workspace/your-model-id

Completion API'lerini kendi projelerinizden doğrudan çağırın.

Kullanılabilir modelleri listeleyin

bash
        curl https://api.ajan.io/openai/eu/v1/models \
          -H "Authorization: Bearer YOUR_API_KEY"

Bir Chat Completions isteği gönderin

bash
        curl https://api.ajan.io/openai/eu/v1/chat/completions \
          -H "Authorization: Bearer YOUR_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{"model": "your-model-id", "messages": [{"role": "user", "content": "Hello"}]}'

Veya Anthropic uyumlu API'yi kullanın

bash
        curl https://api.ajan.io/anthropic/eu/v1/messages \
          -H "Authorization: Bearer YOUR_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{"model": "your-model-id", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Temel URL'sini yukarıdaki URL'lere yönlendirerek herhangi bir OpenAI veya Anthropic uyumlu SDK kullanın. Tam istek şekilleri için Chat Completions, Responses ve Anthropic Messages API belgelerine bakın.

Anahtarınız OpenAI uyumlu Chat Completions ve Responses API'leri, Anthropic Messages API, Google Completion API ve Mistral Completion API ile çalışır. Hangilerini çağırabileceğiniz Workspace'iniz için yapılandırılmış modellere bağlıdır. Available models, yerleşik OpenAI ve Anthropic rehberleri için ne seçebileceğinizi gösterir; Google ve Mistral için bunun yerine API belgelerini izlersiniz.

Kişisel API anahtarları yalnızca completion uç noktalarıyla çalışır. Agent, Embedding, Knowledge Folder, Integrations, Skills, Prompts, Usage Export, User Management ve Audit Logs API'leri eşleşen kapsama sahip bir Workspace API anahtarı gerektirir.

Bir anahtarı döndürme veya iptal etme

Your API keys altında bir anahtarın yanındaki menüyü açın:

  • Rotate key gizli anahtarı değiştirir ve yenisini bir kez gösterir. Eski hemen çalışmayı durdurur; bu yüzden bağlı her aracı hemen güncelleyin.
  • Revoke key anahtarı kalıcı olarak kapatır.

Workspace yöneticiniz anahtarlarınızı da iptal edebilir. Yöneticiniz kişisel API anahtarlarına erişiminizi alırsa veya Workspace üyeliğinizi devre dışı bırakırsa da çalışmayı durdururlar.