API Belgeleri

Giriş

Zubnet API, programlı erişimle 408 yapay zekâ modelini metin, görüntü, video, müzik, ses ve kod üretimi için kullanımınıza sunar. OpenAI API belirtimiyle tamamen uyumludur — OpenAI kullanıyorsanız yalnızca temel URL'nizi ve API anahtarınızı değiştirerek Zubnet'e geçebilirsiniz.

Temel URL

https://api.zubnet.com/v1

Hızlı Başlangıç

# Using curl
curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# Using Python with OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="your-zubnet-api-key",
    base_url="https://api.zubnet.com/v1"
)

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

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

Kimlik doğrulama

Tüm API istekleri, Authorization başlığındaki Bearer belirteci aracılığıyla kimlik doğrulaması gerektirir.

Authorization: Bearer YOUR_API_KEY

API anahtarlarını hesap ayarlarınızdan oluşturabilirsiniz. Anahtarlarınızı güvende tutun — hesabınıza tam erişim sağlarlar.

Kendi Sağlayıcı Anahtarlarınızı Kullanma (BYOK)

Desteklenen sağlayıcılardan kendi API anahtarlarınızı kullanabilirsiniz. Bunları çalışma alanı ayarlarınıza ekleyin; bu sağlayıcılara yapılan istekler için otomatik olarak kullanılacaklar — ek ücret olmadan kullanabilirsiniz. BYOK, bu özelliği destekleyen planlarda sunulur.

BYOK anahtarı bir sağlayıcı için yapılandırıldığında platform anahtarına göre önceliklidir. API isteklerinizde herhangi bir değişiklik yapılmasına gerek yoktur — hangi anahtarın kullanılacağı tamamen şeffaftır.

Desteklenen BYOK Sağlayıcıları

Modeller

Mevcut tüm modelleri listeleyin.

curl https://api.zubnet.com/v1/models \
  -H "Authorization: Bearer $ZUBNET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5",
      "object": "model",
      "created": 1699900000,
      "owned_by": "anthropic"
    },
    {
      "id": "deepseek-chat",
      "object": "model",
      "created": 1699900000,
      "owned_by": "deepseek"
    },
    ...
  ]
}

Sohbet Tamamlamaları

Bir sohbet tamamlaması oluşturun. Bu, metin üretiminin ana uç noktasıdır ve OpenAI sohbet tamamlamaları biçimiyle uyumludur.

İstek Gövdesi

Örnek İstek

curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ],
    "temperature": 0.7,
    "max_tokens": 150
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699900000,
  "model": "claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}

Kod Oluşturma

Doğal dilde bir istemden kod üretin. Yanıt, Server-Sent Events (SSE) üzerinden akış hâlinde döndürülür.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/ai/completions/code \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A function that checks if a number is prime",
    "language": "python"
  }'

{
  "object": "code_document",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "claude-sonnet-5",
  "cost": 1,
  "title": "Prime Number Checker",
  "content": "def is_prime(n): ..."
}

Görüntü Üretimi

FLUX, Stable Diffusion, Ideogram ve diğer modellerle metin istemlerinden görüntüler üretin.

Mevcut Modeller

İstek Gövdesi

Örnek İstek

curl https://api.zubnet.com/v1/images/generations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro-1.1-ultra",
    "prompt": "A serene mountain lake at sunset, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1699900000,
  "data": [
    {
      "url": "https://zubnet.com/files/abc123.png",
      "revised_prompt": "A serene mountain lake..."
    }
  ]
}

Video Üretimi

Metin istemlerinden veya görüntülerden video üretin. Metinden videoya, görüntüden videoya ve videodan videoya iş akışlarını destekler.

Mevcut Modeller

İstek Gövdesi

Örnek: Metinden Videoya

curl https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A drone shot flying over a coral reef at golden hour",
    "aspect_ratio": "16:9",
    "duration": 8
  }'

Örnek: Görüntüden Videoya

curl https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=kling-v2-5-turbo" \
  -F "prompt=Camera slowly zooms in" \
  -F "frames=@my-image.png"

{
  "object": "video",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-generate-001",
  "state": "processing",
  "progress": 0,
  "cost": 5,
  "output_file": null,
  "created_at": "2026-02-25T12:00:00Z"
}

Video Anlama

Video içeriğini yapay zekâyla analiz edin. Analiz için bir video URL'si gönderin ve sonuçlar hazır olana dek durumu sorgulayın. Birden fazla analiz türünü destekler.

Yapay zekâ analizi için bir video gönderin. Sonuçları sorgulamakta kullanabileceğiniz bir iş kimliği döndürür.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/ai/video-understanding \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "type": "summary"
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}

Bir video analiz işinin durumunu kontrol edin.

{
  "status": "completed",
  "result": {
    "type": "summary",
    "content": "The video shows a product demonstration..."
  }
}

Müzik Kompozisyonu

Metin açıklamalarından, şarkı sözlerinden veya stil etiketlerinden orijinal müzik oluşturun.

Mevcut Modeller

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/ai/compositions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v5",
    "prompt": "An upbeat synthwave track about coding at 3am",
    "tags": "synthwave, electronic, upbeat",
    "instrumental": true
  }'

[
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "model": "suno/v5",
    "title": "Midnight Code",
    "tags": "synthwave, electronic, upbeat",
    "cost": 2,
    "output_file": {
      "url": "https://zubnet.com/files/abc123.mp3"
    }
  },
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440001",
    // ... second variant
  }
]

Ses Efektleri

Metin açıklamalarından ses efektleri oluşturun.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/ai/sound-effects \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sound-effect-model",
    "prompt": "Thunder rumbling in the distance followed by heavy rain"
  }'

{
  "object": "sound_effect",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "sound-effect-model",
  "cost": 1,
  "output_file": {
    "url": "https://zubnet.com/files/abc123.mp3"
  }
}

Metinden Konuşmaya

ElevenLabs, Cartesia, Speechify ve diğer sağlayıcıların sesleriyle metni doğal konuşmaya dönüştürün.

Örnek İstek

curl https://api.zubnet.com/v1/audio/speech \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1-hd",
    "input": "Welcome to Zubnet, the future of AI.",
    "voice": "nova"
  }' --output speech.mp3

Transkripsiyon

Sesi metne dönüştürün.

Örnek İstek

curl https://api.zubnet.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=whisper-1" \
  -F "file=@recording.mp3"

{
  "object": "transcription",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "whisper-1",
  "content": "Hello, this is a test recording..."
}

Ses Yalıtımı

Arka plan gürültüsünü ve müziği kaldırarak sesten temiz vokalleri çıkarın. ElevenLabs tarafından desteklenmektedir.

Örnek İstek

curl https://zubnet.com/api/ai/isolated-voices \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@noisy-recording.mp3"

{
  "object": "isolated_voice",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://zubnet.com/files/input.mp3"
  },
  "output_file": {
    "url": "https://zubnet.com/files/isolated.mp3"
  }
}

Stem Ayırma

Sesi ayrı stem'lere ayırın (vokal, davul, bas, gitar, piyano ve diğerleri). ElevenLabs tarafından desteklenir.

Örnek İstek

curl https://zubnet.com/api/ai/stem-separations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@song.mp3"

{
  "object": "stem_separation",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://zubnet.com/files/song.mp3"
  },
  "output_file": {
    "url": "https://zubnet.com/files/stems.zip"
  }
}

Sesler

Metinden konuşmaya geçiş için özel sesler oluşturun ve yönetin.

Ses örneklerini yükleyerek özel bir ses oluşturun.

Oluşturduğunuz özel sesler dahil, çalışma alanınızda bulunan tüm sesleri listeleyin.

Özel bir sesi (ad, ayarlar) güncelleyin.

Özel bir sesi silin.

Embedding'ler

Anlamsal arama ve benzerlik karşılaştırması için metin embedding'leri oluşturun.

Örnek İstek

curl https://api.zubnet.com/v1/embeddings \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

Bilgi Tabanları

Retrieval-augmented generation (RAG) için bilgi tabanları oluşturun ve yönetin. Belgeler (PDF, DOCX, TXT, Markdown), web URL'leri veya ham metin ekleyin; ardından sohbet tamamlamalarınızda bunları sorgulayın.

Yeni bir bilgi tabanı oluşturun.

İstek Gövdesi

Örnek: Bilgi Tabanı Oluşturma

curl https://zubnet.com/api/knowledge-bases \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My KB",
    "description": "Optional description"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My KB",
  "description": "Optional description",
  "status": "active"
}

Çalışma alanınızdaki tüm bilgi tabanlarını listeleyin.

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My KB",
    "description": "Optional description",
    "status": "active"
  },
  ...
]

Belgeleri de dahil olmak üzere belirli bir bilgi tabanının ayrıntılarını alın.

Bir bilgi tabanını ve tüm belgelerini silin.

Bir belgeyi bilgi tabanına ekleyin. Dosya yüklemelerini, URL'leri ve ham metni destekler.

İstek Gövdesi

Örnek: Dosya Ekleme

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@report.pdf"

Örnek: URL Ekleme

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Zubnet Docs",
    "type": "url",
    "url": "https://zubnet.com/developers.html"
  }'

Örnek: Ham Metin Ekleme

curl https://zubnet.com/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company Policy",
    "type": "text",
    "content": "All employees must complete security training annually..."
  }'

Bir bilgi tabanındaki tüm belgeleri listeleyin.

Belirli bir belgeyi bilgi tabanından silin.

Belirli bir belgenin çıkarılan metin içeriğini okuyun.

Yeniden sıralama

Bir belge listesini sorguyla ilgisine göre yeniden sıralayın. Arama sonuçlarını, RAG işlem hatlarını ve öneri sistemlerini iyileştirmek için kullanışlıdır.

Mevcut Modeller

İstek Gövdesi

Örnek İstek

curl https://api.zubnet.com/v1/reranking \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-v4.0-pro",
    "query": "How do I reset my password?",
    "documents": [
      "To reset your password, go to Settings > Security > Change Password.",
      "Our pricing plans start at $9/month for individuals.",
      "Password requirements: minimum 8 characters, one uppercase letter.",
      "Contact support at help@example.com for account issues."
    ],
    "top_n": 3
  }'

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.953
    },
    {
      "index": 2,
      "relevance_score": 0.714
    },
    {
      "index": 3,
      "relevance_score": 0.389
    }
  ],
  "model": "rerank-v4.0-pro"
}

Kütüphane

Üretilen tüm içerikler kütüphanede tutulur — resimler, videolar, kompozisyonlar, kod belgeleri, transkripsiyonlar ve daha fazlası. Öğeleri listelemek, eşzamansız oluşturma durumunu kontrol etmek, meta verileri güncellemek ve içeriğinizi yönetmek için bunu kullanın.

Kitaplığınızdaki öğeleri içerik türüne göre listeleyin.

İçerik Türleri

Sorgu Parametreleri

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "object": "video",
      "model": "veo-3.1-generate-001",
      "title": "Coral reef drone shot",
      "state": 3,
      "progress": 100,
      "cost": 5,
      "output_file": {
        "url": "https://zubnet.com/files/abc123.mp4",
        "size": 8421376,
        "extension": "mp4"
      },
      "created_at": "2026-03-01T12:00:00Z"
    },
    ...
  ]
}

Kimliğine göre tek bir kütüphane öğesi alın. Bu, şu içeriklerin ana uç noktasıdır: eşzamansız oluşturma durumunu yoklama.

Üretim Durumları

Durum Sorgulama Modeli

# 1. Start async generation
curl -X POST https://zubnet.com/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1-generate-001", "prompt": "A coral reef"}'
# Returns: {"id": "550e8400-...", "state": 1, ...}

# 2. Poll for completion
curl https://zubnet.com/api/library/videos/550e8400-... \
  -H "Authorization: Bearer $ZUBNET_API_KEY"
# Returns: {"state": 2, "progress": 45, ...}  (still processing)
# Returns: {"state": 3, "progress": 100, "output_file": {"url": "..."}}  (done!)

Bir kitaplık öğesinin meta verilerini güncelleyin.

Bir kitaplık öğesini ve onunla ilişkili dosyaları silin.

Bir içerik türündeki toplam öğe sayısını alın. Liste uç noktasındaki query ve model filtreleri desteklenir.

Asistanlar

Asistanlar; özel ad, model, sistem istemi ve ayarlarla yeniden kullanılabilen sohbet yapılandırmalarıdır. Farklı görevler için uzmanlaşmış yapay zekâ kişilikleri oluşturmanızı sağlar.

Yeni bir asistan oluşturun.

Çalışma alanınızdaki tüm asistanları listeleyin.

Asistanın yapılandırmasını güncelleyin (ad, model, sistem istemi, ayarlar).

Bir asistanı silin.

MCP Mağazası

Ajanlarınıza daha kapsamlı araç yetenekleri kazandırmak için MCP (Model Context Protocol) sunucularını keşfedin ve etkinleştirin — web araması ve veri erişiminden kod yürütme ve üçüncü taraf entegrasyonlarına kadar.

MCP sunucu kataloğuna göz atın.

Sorgu Parametreleri

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "GitHub",
      "description": "Access GitHub repositories, issues, and pull requests",
      "category": "developer",
      "config_schema": [
        {"name": "api_key", "type": "secret", "label": "API Key", "required": true}
      ],
      "tools": ["list_repos", "create_issue", "search_code"],
      "is_official": true
    },
    ...
  ]
}

Çalışma alanınız için bir MCP sunucusunu etkinleştirin. Yapılandırma değerlerini (API anahtarları vb.) sunucu şemasına göre sağlayın: config_schema.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/mcp-store/activations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": "550e8400-e29b-41d4-a716-446655440000",
    "config": {
      "api_key": "ghp_xxxxxxxxxxxx"
    }
  }'

{
  "id": "act-uuid-...",
  "server_id": "550e8400-...",
  "status": 1,
  "config": {
    "api_key": "••••••••"
  },
  "server": {
    "name": "GitHub",
    ...
  },
  "created_at": "2026-03-01T12:00:00Z"
}

Çalışma alanınızda etkinleştirilen tüm MCP sunucularını listeleyin.

Bir etkinleştirmenin yapılandırmasını veya durumunu güncelleyin.

MCP sunucusunu çalışma alanınızdan devre dışı bırakın.

Ajanlar

İletişim kanallarında çalışan otonom yapay zekâ ajanları oluşturun ve yönetin. Ajanlar Telegram ve Discord mesajlarını yanıtlayabilir, zamanlanmış tetikleyicilerle çalışabilir ve daha kapsamlı yetenekler için bilgi tabanlarıyla MCP sunucularından yararlanabilir.

Yeni bir ajan oluşturun.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/agents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "model": "claude-sonnet-5",
    "system_prompt": "You are a friendly support agent. Answer questions clearly and concisely.",
    "mode": "advanced"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Support Bot",
  "slug": "support-bot",
  "avatar": null,
  "model": "claude-sonnet-5",
  "system_prompt": "You are a friendly support agent...",
  "status": 1,
  "mode": "advanced",
  "permissions": {
    "time_windows": [],
    "frequency_cap": {
      "max_messages_per_hour": 60,
      "max_messages_per_day": 500
    },
    "channel_preferences": {},
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5
    }
  },
  "cost": 0,
  "last_active_at": null,
  "created_at": 1709136000,
  "updated_at": null,
  "user": {
    "id": "a1b2c3d4-...",
    "first_name": "Jane",
    "last_name": "Doe",
    "avatar": "https://zubnet.com/files/avatar.jpg"
  },
  "channels": []
}

Çalışma alanındaki tüm ajanları listeleyin. Sayfalandırma ve filtrelemeyi destekler.

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "Support Bot",
      "slug": "support-bot",
      "model": "claude-sonnet-5",
      "status": 1,
      "mode": "advanced",
      "cost": 12.50,
      "last_active_at": 1709222400,
      "created_at": 1709136000,
      ...
    }
  ]
}

Belirli bir ajanın kanalları, bağlı MCP sunucuları ve bilgi tabanları dâhil tüm ayrıntılarını alın.

Bir ajanı güncelleyin. Tüm alanlar isteğe bağlıdır — yalnızca sağlanan alanlar değiştirilir.

İstek Gövdesi

İzin Nesnesi

{
  "permissions": {
    "time_windows": [
      {
        "days": [1, 2, 3, 4, 5],  // 0=Sun, 6=Sat
        "timezone": "America/New_York",
        "start_hour": 9,            // 0-23
        "end_hour": 17              // 1-24
      }
    ],
    "frequency_cap": {
      "max_messages_per_hour": 60,    // 1-1000
      "max_messages_per_day": 500     // 1-10000
    },
    "channel_preferences": {
      "default_channel": "telegram",
      "proactive_channels": ["telegram", "discord"]
    },
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5  // 0-50
    }
  }
}

Bir ajanı silin. Bu işlem ajanın tüm kanallarını, tetikleyicilerini, mesajlarını ve entegrasyonlarını da kaldırır.

Entegrasyonlar

RAG destekli yanıtlar için bir bilgi tabanını ajana bağlayın. Gövde: { "knowledge_base_id": "uuid" }

Bir bilgi tabanının ajanla bağlantısını kaldırın.

Daha kapsamlı araç kullanımı için bir MCP sunucusunu ajana bağlayın. Gövde: { "activation_id": "uuid" }

Bir MCP sunucusunun ajanla bağlantısını kaldırın.

Bir ajanın konuşma geçmişini alın.

{
  "object": "list",
  "data": [
    {
      "id": "msg-uuid-...",
      "direction": "inbound",
      "content": "How do I reset my password?",
      "external_user_name": "john_doe",
      "cost": 0,
      "model": null,
      "created_at": 1709222400
    },
    {
      "id": "msg-uuid-...",
      "direction": "outbound",
      "content": "Go to Settings > Security > Change Password...",
      "cost": 0.25,
      "model": "claude-sonnet-5",
      "created_at": 1709222401
    }
  ]
}

Ajan Kanalları

Ajanları iletişim platformlarına bağlayın. Her ajan tür başına bir kanalı destekler (bir Telegram botu, bir Discord botu).

Bir ajana iletişim kanalı ekleyin.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/agents/550e8400-.../channels \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "telegram",
    "token": "7123456789:AAH..."
  }'

{
  "id": "ch-uuid-...",
  "type": "telegram",
  "status": 1,
  "metadata": {},
  "last_error": null,
  "last_message_at": null,
  "created_at": 1709136000
}

Bir ajana bağlı tüm kanalları listeleyin.

Bir ajandan kanalı kaldırın.

Ajan Tetikleyicileri

Ajan eylemlerini tetikleyicilerle otomatikleştirin. Zamanlanmış tetikleyiciler belirli saatlerde çalışmak için cron ifadelerini kullanır; olay tetikleyicileri ise dış olaylara yanıt verir.

Bir ajan için otomatik tetikleyici oluşturun.

İstek Gövdesi

Örnek: Günlük Özet Tetikleyicisi

curl https://zubnet.com/api/agents/550e8400-.../triggers \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Summary",
    "type": "scheduled",
    "prompt": "Summarize the key metrics for today and send them to the team.",
    "cron_expression": "0 18 * * 1-5",
    "timezone": "America/New_York"
  }'

{
  "id": "tr-uuid-...",
  "name": "Daily Summary",
  "type": "scheduled",
  "status": 1,
  "cron_expression": "0 18 * * 1-5",
  "timezone": "America/New_York",
  "prompt": "Summarize the key metrics for today...",
  "channel_id": null,
  "last_run_at": null,
  "next_run_at": 1709236800,
  "run_count": 0,
  "created_at": 1709136000
}

Bir ajanın tüm tetikleyicilerini listeleyin.

Bir tetikleyiciyi güncelleyin. Tüm alanlar isteğe bağlıdır. status alanını devre dışı bırakmak için 0, etkinleştirmek için 1 olarak ayarlayın.

Bir tetikleyiciyi silin.

Çalışma alanları

Çalışma alanları ekibinizin organizasyon birimidir. Her çalışma alanının kendi kredi bakiyesi, aboneliği, API anahtarları ve üyeleri vardır. Çalışma alanlarını yönetin, ekip üyelerini davet edin ve kullanımı izleyin.

Yeni bir çalışma alanı oluşturun.

{
  "id": "550e8400-...",
  "name": "My Team",
  "subscription": null,
  "api_spending_limit": null,
  "api_spending_current": 0,
  "owner": { "id": "...", "email": "..." },
  "created_at": "2026-03-01T12:00:00Z"
}

Bir çalışma alanının ayarlarını güncelleyin. Çalışma alanı yönetimi izni gerektirir.

Bir çalışma alanını silin. Çalışma alanı yönetimi izni gerektirir.

Bir kullanıcıyı e-postayla çalışma alanına katılmaya davet edin. Çalışma alanı başına maksimum 20 bekleyen davetiye.

Bekleyen bir daveti iptal edin.

Bir üyeyi çalışma alanından kaldırın veya kendi kullanıcı kimliğinizi kullanarak çalışma alanından ayrılın.

Çalışma alanına ilişkin toplu kullanım istatistiklerini listeleyin. İmleç tabanlı sayfalandırmayı destekler.

Ayrıntılı kullanım kayıtlarını listeleyin (maliyetiyle birlikte tamamlanmış kütüphane öğeleri, > 0). Her girişte tür, model, başlık, maliyet ve zaman damgası bulunur.

Kullanım öğelerinin toplam sayısını alın.

Konuşmalar

Konuşmalar, sohbet mesajlarını oturumlar hâlinde gruplar. Önce bir konuşma oluşturun, ardından konuşmaya mesaj gönderin. Konuşmalar ayrıca Kütüphane API'sinde conversations içerik türü kullanılarak yönetilebilir.

Yeni bir konuşma oluşturun. Konuşma nesnesini boş bir ileti listesiyle döndürür.

{
  "object": "conversation",
  "id": "550e8400-...",
  "title": null,
  "cost": 0,
  "messages": [],
  "created_at": "2026-03-01T12:00:00Z"
}

Bir konuşmaya mesaj gönderin ve Server-Sent Events (SSE) üzerinden yapay zekâ yanıtı alın. SSE olay biçiminin ayrıntıları için Sohbet Tamamlamaları bölümüne bakın.

İstek Gövdesi

Örnek İstek

curl https://zubnet.com/api/ai/conversations/550e8400-.../messages \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "content": "Explain quantum computing in simple terms"
  }'

Hesap

Kullanıcı profilinizi yönetin ve API anahtarlarını programlı olarak oluşturun.

Profil bilgilerinizi güncelleyin.

Yeni bir API anahtarı oluşturun. Güvenlik için parola doğrulaması gerekir. API anahtarının tamamı yalnızca bu yanıtta bir kez gösterilir — güvenli biçimde saklayın.

{
  "id": "550e8400-...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "api_key": "zub_live_a1b2c3d4e5f6..."
}

Faturalandırma

Mevcut planlara göz atın, sipariş geçmişini görüntüleyin, ödemeyi başlatın ve abonelikleri yönetin.

Mevcut abonelik planlarını listeleyin.

Geçerli çalışma alanına ilişkin siparişleri listeleyin. İmleç tabanlı sayfalandırmayı destekler.

Bir abonelik planı veya kredi satın alımı için ödeme işlemini başlatın. Çalışma alanı yönetimi izni gerektirir.

Mevcut çalışma alanı aboneliğini iptal edin. Çalışma alanı yönetimi izni gerektirir.

İçerik Raporları

Halk kütüphanesindeki uygunsuz veya politikayı ihlal eden içeriği bildirin.

Bir içerik raporu gönderin. Her kullanıcı belirli bir öğeyi yalnızca bir kez bildirebilir.

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

Diğer Uç Noktalar

API'nin kapsamı yukarıdaki bölümlerden daha geniştir. Aşağıdaki uç noktalar kullanıma açıktır ve aynı kimlik doğrulamasını kullanır:

Hatalar

API, standart HTTP durum kodlarını kullanır ve ayrıntılı hata mesajları verir.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

İstek Sınırları

İstek sınırları plana göre değişir. Her yanıtta şu üstbilgiler yer alır:

İstek sınırına ulaşırsanız sıfırlanma zamanına kadar bekleyin veya sınırlarınızı artırmak için bizimle iletişime geçin.