API Girişi

ajan'ın güçlü AI yeteneklerini kapsamlı API paketimizle uygulamalarınıza entegre edin

Genel bakış

ajan API, kurumsal düzeyde güvenlik ve uyumluluğu korurken son teknoloji AI modellerine programatik erişim sağlar. Özel uygulamalar geliştiriyor, iş akışlarını otomatikleştiriyor veya mevcut sistemleri güçlendiriyor olun; API'miz ihtiyacınız olan esneklik ve gücü sunar.

Kullanılabilir API'ler

Completion API

Metin üretimi, analiz ve akıl yürütme görevleri için OpenAI, Anthropic, Mistral ve Google'ın önde gelen dil modellerine erişin.

OpenAI Chat Completions — GPT ve reasoning modelleri
OpenAI Responses — Codex ve uyumlu istemciler için durum bilgisiz Responses biçimi
Anthropic API — Claude modelleri
Google API — Gemini modelleri
Mistral API — Mistral modelleri

Embedding API

Anlamsal arama, benzerlik eşleştirme ve RAG uygulamaları için yüksek kaliteli embedding'ler üretin.

OpenAI Embeddings — Çeşitli kullanım senaryoları için metin embedding'leri

Agent API

Özel bilgi ve yeteneklere sahip özel AI agent'larını programatik olarak oluşturun ve yönetin.

Agent API Guide — Agent kullanımına ilişkin tam kılavuz
Managing Agents — Agent oluşturma ve yapılandırma
Agent Models — Agent'lar için kullanılabilir modeller
Upload Attachments — Agent'lara belge ekleme

Knowledge Folder API

RAG ve belge işleme için Knowledge base'leri programatik olarak yönetin. Bu kaynaklar Library'de Knowledge base olarak görünür.

Sharing: Knowledge base paylaşma
List Knowledge bases: Anahtarın kullanabileceği Knowledge base'leri keşfedin
Share access: Erişim verme, değiştirme veya iptal etme
Update Knowledge base: Knowledge base yeniden adlandırma
Upload Files: Belge ekleme
Search: Knowledge base içinde arama

Prompt Library API

Prompt'ları ve prompt klasörlerini programatik olarak oluşturun, güncelleyin ve yönetin. İstekler PROMPT_API kapsamına sahip bir API anahtarı gerektirir.

Prompt Library Overview — Prompt Library API'ye ilişkin tam kılavuz

Integrations API

Harici servislerle özel entegrasyonları programatik olarak oluşturun ve yönetin.

Integrations Overview — Integrations API'ye ilişkin tam kılavuz

Skills API

Yeniden kullanılabilir Skill'leri programatik olarak oluşturun, içe aktarın, güncelleyin ve yönetin. İstekler SKILL_API kapsamına sahip bir API anahtarı gerektirir.

Skills Overview — Skills API'ye ilişkin tam kılavuz

Usage Export API

Analitik, faturalama ve uyumluluk raporlaması için kullanım verilerini dışa aktarın.

Usage Export Guide — Kullanıcı, agent, model, proje ve iş akışı dışa aktarımı

Workflow Run Export API

İş akışı çalıştırma ve düğüm yürütme verilerini analiz ve hata ayıklama için JSON olarak dışa aktarın.

Workflow Run Export Guide — Bir iş akışı için run verilerini dışa aktarma

User Management API

Kullanıcıları programatik olarak davet edin, aktif bir üyenin sistem rolünü değiştirin ve üyeleri devre dışı bırakın.

Invite Users — Kullanıcıları e-posta ile workspace'inize davet edin
Update User Role — Üyenin sistem rolünü member, editor veya admin olarak değiştirin
Deactivate User — Kullanıcıyı workspace'inizden kaldırın

Audit Logs API

Güvenlik izleme ve uyumluluk için workspace etkinlik kaydını alın.

Introduction to Audit Logs — Workspace audit log kayıtlarını sorgulama ve filtreleme

Başlarken

Base URL

Standart ajan Cloud kullanıcıları için tüm API isteklerinde şu base URL'yi kullanın:

https://api.ajan.io

Kuruluşunuz özel ajan dağıtımı (özel alan adı) kullanıyorsa base URL şu deseni izler:

https://<your-deployment>/api/public

Örneğin ajan örneğiniz https://ajan.yourcompany.com adresindeyse API base URL'si şöyle olur:

https://ajan.yourcompany.com/api/public

Sık yapılan hata: Özel dağıtımda /api/public önekini unutmayın. Bu önek olmadan yalnızca alan adınızı kullanmak kimlik doğrulama hatalarına veya yönlendirmelere yol açar.

Authentication

Tüm API istekleri Bearer token ile kimlik doğrulama gerektirir:

bash

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

Completion istekleri için kendi kimliğiniz altında bir personal API key oluşturun veya entegrasyonunuzun ihtiyaç duyduğu kapsamlara sahip bir workspace API anahtarı için workspace admin'inden isteyin.

Güvenlik notu:

ajan, API anahtarınızı korumak ve uygulamalarınızın güvenliğini sağlamak için tarayıcı kaynaklı istekleri bilinçli olarak engeller. API'yi tarayıcıdan (ör. bir web sayfasında çalışan JavaScript'ten) çağırmak ajan API Key'ini herkese açık hale getirir ve güvenlik riski oluşturur. Bu nedenle ajan API'sine güvenli bir backend ortamından erişilmelidir. Daha fazla bilgi için API Key Best Practices kılavuzuna bakın.

Rate Limits

API istekleri adil kullanım ve sistem kararlılığı için rate limit'e tabidir. Varsayılan limitler 500 RPM (dakika başına istek) ve 150.000 TPM (dakika başına token)'dır. RPM workspace, model ve API anahtarı başına uygulanır. TPM, bir workspace'te aynı modeli kullanan tüm API anahtarları arasında paylaşılır. BYOK kullanmayan workspace admin'leri Settings > Workspace > Products > API altındaki Model quotas bölümünden daha yüksek limit talep edebilir. Özel dağıtımlarda admin'ler aynı API ayarlarında model başına özel limitler de tanımlayabilir. Bkz. Workspace Settings.

Temel özellikler

GDPR Compliant — Tüm API işlemleri AB bölgelerinde veri işleme ile tam GDPR uyumluluğunu korur
Multiple Models — OpenAI, Anthropic, Mistral ve diğer modellere tek bir arayüz üzerinden erişin
Enterprise Security — Uçtan uca şifreleme ve audit logging ile SOC 2 sertifikalı altyapı
BYOK Support — API erişimi üzerinde daha fazla kontrol için Bring Your Own Key (BYOK) seçeneği
Cookbook — ajan üzerinde geliştirme için bağımsız, çalıştırılabilir tarifler

Kullanım senaryoları

Custom Applications: Uygulamalarınıza AI destekli özellikler ekleyin
Workflow Automation: Belge işleme ve analizi otomatikleştirin
Data Analysis: Büyük hacimli metin verilerinden içgörü çıkarın
Content Generation: Ölçekte yüksek kaliteli içerik üretin
Semantic Search: Bilgi tabanınızda akıllı arama uygulayın

Destek

API desteği ve sorularınız için support@ajan.com adresinden bize ulaşın.