AIGENCY

API v2

API Dokümantasyonu

AIGENCY'nin yapay zeka yeteneklerini uygulamalarınıza entegre edin. Pro ve İşletme paketlerinde kullanılabilir.

Base URLhttps://aigency.dev/api/v2
FormatJSON + Multipart
Rate Limit60 req/min
Kimlik DoğrulamaURL Token

Kimlik Doğrulama

Tüm istekler URL'de API erişim tokeni gerektirir. Tokeninizi paneldeki API Uygulamaları bölümünden alabilirsiniz. API erişimi Pro ve İşletme paketlerinde kullanılabilir.

http
GET /api/v2/credit/{YOUR_API_TOKEN}

⚠️ API anahtarınızı istemci tarafında (frontend) açık bırakmayın. Sunucu tarafında saklayın.

Endpoint'ler

Kredi & Hesap

Asistanlar

Sohbet

Hata Kodları

200Başarılı
400Geçersiz istek veya eksik parametre
401Geçersiz veya eksik API anahtarı
402Yetersiz kredi bakiyesi
403Bu özellik paketinizde kullanılamaz
429Rate limit aşıldı (60 istek/dakika)
500Sunucu hatası

Paket Gereksinimleri

API erişimi Pro ve İşletme paketlerinde kullanılabilir.

Özellik
Pro
İşletme
API Erişimi
✓
✓
Aylık Token Limiti
100K
500K
Rate Limit
60/dk
60/dk
Dosya Yükleme
✓
✓
Görsel Oluşturma
Sınırsız
Sınırsız
Doküman Oluşturma
✓
✓

Kredi Yönetimi

API uygulamaları ayrı bir kredi bakiyesine sahiptir. Hesabınızdaki kredilerden uygulamanıza aktarım yapabilirsiniz.

Nasıl Çalışır?

1.Pro veya İşletme paketi satın alın → Hesabınıza token yüklenir
2.API Uygulamaları sayfasından (aigency.dev/application) uygulama oluşturun
3.Hesap bakiyenizden uygulamaya token aktarın (min: 1.000 token)
4.Her API çağrısında kullanılan token miktarı uygulamanın kredisinden düşer
5.Kredi bittiğinde yeni aktarım yapın veya paket satın alın

💡 İpucu: Her mesaj yanıtında remaining_credit alanı döner. Bu değeri takip ederek krediniz bitmeden uyarı gösterebilirsiniz.

İşlem
Tahmini Maliyet
Açıklama
Kısa mesaj
~6 kredi
100 token soru + 500 token yanıt
Orta mesaj
~12 kredi
200 token soru + 1000 token yanıt
Uzun mesaj
~25 kredi
500 token soru + 2000 token yanıt
Görsel oluşturma
1 kredi
Sabit maliyet
Kredi sorgulama
0 kredi
Ücretsiz
Asistan listeleme
0 kredi
Ücretsiz

Örnekler

Python

python
import requests

TOKEN = "YOUR_API_TOKEN"
BASE = "https://aigency.dev/api/v2"

# Kredi sorgula
credit = requests.get(f"{BASE}/credit/{TOKEN}").json()
print(f"Kalan kredi: {credit['credit']}")
if credit.get("low_credit"):
    print("⚠️ Kredi azalıyor!")

# Asistanları listele
assistants = requests.get(f"{BASE}/ai-team-list/{TOKEN}").json()
ai_id = assistants[0]["id"]
print(f"Asistan: {assistants[0]['name']['name_tr']}")

# Yeni sohbet başlat
chat = requests.post(f"{BASE}/newChat/{ai_id}/{TOKEN}",
    json={"message": "Merhaba!"}).json()
print(f"AI: {chat['message']}")
print(f"Kalan kredi: {chat.get('remaining_credit')}")

# Mesaj gönder (multipart)
resp = requests.post(f"{BASE}/sendMessage/{TOKEN}",
    data={"chat_id": chat["chat_id"],
          "message": "Python ile REST API yaz"}).json()
print(f"AI: {resp['message'][:100]}")
print(f"Kalan kredi: {resp.get('remaining_credit')}")

# Sohbet geçmişi
history = requests.post(
    f"{BASE}/resumeChat/{chat['chat_id']}/{TOKEN}").json()
for msg in history["messages"]:
    print(f"{msg['role']}: {msg['content'][:50]}...")

JavaScript (Node.js)

javascript
const TOKEN = "YOUR_API_TOKEN";
const BASE = "https://aigency.dev/api/v2";

// Kredi kontrol
const credit = await fetch(`${BASE}/credit/${TOKEN}`).then(r => r.json());
console.log("Kredi:", credit.credit);
if (credit.no_credit) console.error("Kredi tükendi!");

// Yeni sohbet başlat
const chat = await fetch(`${BASE}/newChat/16/${TOKEN}`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Merhaba!" })
}).then(r => r.json());

console.log("AI:", chat.message);
console.log("Kalan:", chat.remaining_credit);

// Mesaj gönder (multipart - dosya ekleme destekli)
const form = new FormData();
form.append("chat_id", chat.chat_id);
form.append("message", "React ile todo uygulaması yaz");
// form.append("attachements", file); // Dosya eklemek için

const resp = await fetch(`${BASE}/sendMessage/${TOKEN}`,
  { method: "POST", body: form }).then(r => r.json());

console.log("AI:", resp.message);
console.log("Kalan:", resp.remaining_credit);

cURL

bash
# Kredi sorgula
curl https://aigency.dev/api/v2/credit/YOUR_API_TOKEN

# Asistanları listele
curl https://aigency.dev/api/v2/ai-team-list/YOUR_API_TOKEN

# Yeni sohbet başlat
curl -X POST https://aigency.dev/api/v2/newChat/16/YOUR_API_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"message": "Merhaba"}'

# Mesaj gönder (multipart)
curl -X POST https://aigency.dev/api/v2/sendMessage/YOUR_API_TOKEN \
  -F "chat_id=CHAT_ID" \
  -F "message=Python ile API yaz"

# Sohbet geçmişi
curl -X POST https://aigency.dev/api/v2/resumeChat/CHAT_ID/YOUR_API_TOKEN

# Sohbet listesi
curl https://aigency.dev/api/v2/view-chats/16/YOUR_API_TOKEN

# Sohbet sil
curl -X DELETE https://aigency.dev/api/v2/deleteChat/CHAT_ID/YOUR_API_TOKEN

Önemli Notlar

  • • API anahtarınız uygulamanıza özeldir. Her uygulama ayrı kredi bakiyesine sahiptir.
  • • Kredi hesabınızdan uygulamaya aktarılır. Hesabınıza kredi yüklemek için paket satın alın.
  • • Her yanıtta remaining_credit alanı döner. Bu değeri takip ederek krediniz bitmeden önlem alın.
  • • System prompt token'ları faturalandırmaya dahil değildir. Sadece mesaj + yanıt token'ları sayılır.
  • • Dosya yükleme için multipart/form-data kullanın. Maksimum dosya boyutu 30MB.
  • • is_image: true dönen yanıtlar görsel dosya adı içerir. Görseli /api/image?fileName=DOSYA_ADI ile alabilirsiniz.
  • • Rate limit: Dakikada 60 istek. Aşıldığında 429 hatası döner.

Hazır mısınız?

API Uygulamalarım →