Astroloji Chat API nedir ve normal bir chatbot'tan nasıl farklı?

Astroloji Chat API agentic bir platform — sadece chatbot sarmalayıcı değil. Bir mesaj gönderdiğinde sunucu özerk biçimde 16 astroloji aracından hangisini çağıracağına karar verir (natal grafik, transit, sinastri vb.), bunları 82 hesaplama endpoint'imize karşı çalıştırır ve temellendirilmiş bir yanıt üretir. Astroloji verisini halüsinasyonlayan jenerik chatbot'ların aksine her yorum gerçek ephemeris hesaplarına dayanır. Tüm ajan döngüsü tek bir API çağrısında sunucu tarafında çalışır.

Bu API ile OpenAI Python veya TypeScript SDK kullanabilir miyim?

Evet — temel tasarım prensibi bu. Standart OpenAI /chat/completions protokolünü uyguluyoruz, böylece resmi OpenAI SDK'sını herhangi bir dilde kullanabilirsin: TypeScript (openai npm paketi), Python (openai pip paketi), Go, Rust veya herhangi bir HTTP client. Sadece base URL'i endpoint'imize değiştir. Mevcut OpenAI kodun minimum değişiklikle çalışır. Bu ayrıca LangChain, Vercel AI SDK ve OpenAI uyumlu her framework'le anında uyum demek.

BYOK ile hangi LLM modelleri destekleniyor?

BYOK 50+ modelle üç sağlayıcı destekliyor. OpenAI: GPT-5, GPT-5-mini, GPT-5-nano, o3, o4 aileleri. Anthropic: Claude Opus 4, Sonnet 4, Haiku 4. OpenRouter: barındırdığı her model — Gemini 3, Grok 4, Llama, Mistral, Qwen ve dahası. Kendi API anahtarını ve model ID'ni geçersin. Platform sağlayıcıya özgü tüm tuhaflıkları (reasoning model parametre farkları gibi) otomatik halleder.

Her chat turn'ü kredi olarak ne kadara mal olur?

Her turn'ün iki maliyet bileşeni var: platform kredileri + tool çağrıları için endpoint kredileri. Hosted mod: 25 kredi/turn (LLM dahil) + endpoint kredileri (örn. natal = 1, transit = 1, astrokartografi = 5, PDF = 35). BYOK mod: 2 kredi/turn + aynı endpoint kredileri + LLM sağlayıcı maliyetin. Örnek: natal grafik yorumu = hosted 25 + 1 = 26 kredi (~0,02 USD) veya BYOK 2 + 1 = 3 kredi (~0,002 USD) + ~0,003 USD LLM maliyeti. Professional planda (37 USD/ay, 55.000 kredi) bu ~2.100 hosted veya ~18.000 BYOK turn yapar. Ücretsiz katman: ayda 50 istek.

Sinastri ve uyum için çoklu konu sohbet nasıl çalışır?

astrology.subjects dizisinde her biri semantic ID ('ben', 'partner', 'çocuk') ve doğum verisiyle birden fazla konu geç. LLM araçları çağırırken konulara ID ile referans verir — sunucu ID'leri tam doğum koordinatlarına çözer. Bu, tek sohbette sinastri, kompozit grafik ve çok kişili analiz sağlar. Hiçbir rakip oturum başına birden fazla konu desteklemiyor.

Sohbet PDF raporu ve SVG grafik görseli üretebilir mi?

Evet — binary artefaktlar benzersiz bir özellik. 'Natal grafiğimi oluştur' de, ajan render_natal aracını çağırır, SVG (veya PNG/PDF) üretir, artefakt olarak saklar ve paylaşılabilir URL döner. PDF natal raporlar için de aynı — çark görseli, yorumlar ve temalarla çok sayfalı profesyonel belgeler. Artefaktlar Supabase'de 24 saatlik saklama ve paylaşılabilir URL'lerle tutulur.

Astroloji Chat API alternatiflere göre ne kadar hızlı?

Hesaplama katmanımız araç çağrısı başına 300ms altında yanıt verir. Toplam yanıt süresi (hesaplama + LLM üretimi) streaming'le tipik olarak 2-5 saniye. Rakip astroloji chat çözümleri premium katmanlarda bile yanıt başına ortalama 8-24 saniye. Streaming'le kullanıcılarımız ajan çalışmaya devam ederken ilk token'ları 2 saniye altında görür.

SSE streaming extension event'leri nedir?

Standart OpenAI text chunk'larının ötesinde özel SSE event'ler yayarız: tool_start (ajan bir aracı çağırmaya başladığında — UI'n 'Natal grafik hesaplanıyor...' gösterebilir), tool_end (araç döndüğünde — çalışma süresiyle) ve astrology.error (bir araç düzgün başarısız olursa). Bunlar ajan çalışırken muhakeme sürecini gösteren zengin gerçek zamanlı UI'lar sağlar.

Oturumlar ve sohbet belleği nasıl çalışır?

İsteğinde astrology.session_id geç. İlk turn'de sunucu Redis tabanlı oturum oluşturur. Aynı ID ile sonraki turn'lerde sunucu yeni mesajını işlemeden önce önceki mesajları ve konuları yükler. Oturumlar 24 saatlik kayan TTL'ye sahip — her etkileşim pencereyi uzatır. Sunucu uzun sohbetler için mesaj sıkıştırma yapar, böylece context pencerelerini yönetmen gerekmez.

Hangi programlama dilleri ve framework'ler destekleniyor?

HTTP client'ı olan her dil çalışır ama OpenAI SDK'ları en iyi deneyimi sağlar: TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby. Framework uyumu: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack — OpenAI protokolünü konuşan her şey. Çoğu geliştirici 30 dakikadan kısa sürede entegre eder.

Bu sadece bir GPT sarmalayıcısı mı yoksa gerçek astronomik veri mi kullanıyor?

Her astrolojik yorum gerçek ephemeris hesaplarına dayanır. Ajan charts_natal'ı çağırdığında, profesyonel astroloji yazılımının kullandığı aynı motor olan Swiss Ephemeris ile gerçek gezegen pozisyonlarını hesaplar. LLM gerçek grafik verisi alır (gezegen pozisyonları, ev yerleşimleri, tam orb'lu aspektler) ve bu veriden yorum sentezler. Uydurulan gezegen pozisyonu yok, uydurulan aspekt yok.

Yanıt tarzını ve uzunluğunu nasıl kontrol ederim?

Üç kontrol katmanı: 1) System mesajı — herhangi bir kişilik belirle ('sıcak Jung psikoloğu', 'özlü Britanyalı klasikçi' vb.). 2) astrology.defaults.detail_level — 'brief' (100 kelime altı), standard (200-350 kelime) veya 'detailed' (500-800 kelime). 3) astrology.defaults.tradition — classical, psychological, event-oriented veya universal. Kullanıcının açık talimatı ('kısaca' veya 'detaylı') her şeyi geçersiz kılar.

Hangi astroloji gelenekleri ve ev sistemleri destekleniyor?

Dört yorum geleneği: Klasik (Helenistik/ortaçağ), Psikolojik (Jung), Olay-Odaklı (horary/electional) ve Evrensel (dengeli). Placidus, Koch, Whole Sign, Equal, Campanus, Regiomontanus, Porphyry ve dahası dahil yirmi üç ev sistemi. astrology.defaults.house_system üzerinden ayarla — sunucu otomatik olarak tüm araç çağrılarına uygular.

Bunu kendi ürünüm olarak white-label yapabilir miyim?

Kesinlikle. System prompt (role='system' ile messages[0]) tüm kişiliği kontrol eder. Marka sesini, astrolog karakterini, dil tarzını belirle — kullanıcı bizim markamızı asla görmez. BYOK maliyet kontrolü verir. Oturum kalıcılığı abonelik modellerini mümkün kılar. Standart fiyat planları ticari yeniden dağıtımı destekler.

Sohbet sırasında bir tool çağrısı başarısız olursa ne olur?

Düzgün düşüş. Bir araç hata döndürürse (geçersiz doğum verisi, desteklenmeyen hesaplama), ajan hata mesajını alır ve uyarlanır — farklı bir araç deneyebilir, kullanıcıdan netleştirme isteyebilir veya kısmi yanıt verebilir. Streaming'le bir astrology.error event'i alırsın. Sohbet çökmez; LLM hataları bir insan astrologun yapacağı gibi sohbet ederek halleder.

Lovable, Claude Code veya Cursor ile bir astroloji widget'ı yapabilir miyim?

Evet — bu vibe coding için ideal API. Standart OpenAI /chat/completions protokolünü uyguladığımız için Lovable, Claude Code, Cursor, Windsurf, Bolt ve Replit Agent gibi AI kodlama araçları onu nasıl entegre edeceğini zaten biliyor. Sadece prompt'la: 'Build an astrology chat widget using OpenAI SDK with base URL https://api.astrology-api.io/api/v3/chat'. AI çalışan bir streaming chat bileşeni üretir — doğum verisi formu, mesaj balonları, yazıyor göstergeleri — sıfır manuel debug ile. Başka hiçbir astroloji API'si bunu sunmuyor çünkü hepsi AI araçlarının anlamadığı tescilli JSON formatları kullanıyor.

Astroloji Chat API, RoxyAPI veya ham veri endpoint'leriyle kendim kurmaya kıyasla nasıl?

RoxyAPI ve benzeri sadece-veri API'leri sana ham hesaplama JSON'u verir — tool şemalarını, LLM orkestrasyonunu, hata yönetimini, oturum yönetimini, artefakt saklamayı kendin kurarsın. Bu aylarca süren mühendislik. Platformumuz tüm bunları hazır sunar. Tek API çağrısı yüzlerce satır ajan framework kodunun yerini alır. Zaten LangChain veya CrewAI kullanıyorsan endpoint'imiz tek araç olarak takılır — mevcut ajan framework'ün gerisini halleder.

to_prompt_text() nedir ve chatbot geliştiricileri neden umursamalı?

to_prompt_text() grafik verisini kompakt, LLM-hazır markdown'a dönüştüren bir formatter. Modeli JSON dökmeden gerçek grafik verisine bağlamak için herhangi bir prompt'a (Claude, GPT, Gemini, Grok) bırak. Çıktı doğal-dil — şifreli alan kodları yerine '2° içinde Mars kare Satürn' — böylece LLM ilk geçişte doğru parse eder. Ortalama token harcaması ham JSON'a göre ~60% düşer ve halüsinasyonlar keskin biçimde azalır çünkü model veriyi okuyabilir.

Hangi preset'i kullanmalıyım — minimal, full mı yoksa traditional mı?

Token bütçene ve okuma tarzına uyan preset'i seç. 'minimal' (~150-250 token) sun/moon/asc, kilit aspektler ve anlık transitleri verir — chat yanıtları, günlük burç üreticileri ve kısa cevaplar için ideal. 'full' (~500-800 token) dignite, evler, modaliteler ve sect ekler — daha zengin yorumlar için dengeli varsayılan. 'traditional' (~600-900 token) Helenistik ve ortaçağ derinliği içerir: lots, almuten, hayz, antiscia — klasik tarz okumalar veya maksimum context gerektiğinde kullan.

Prompt formatter LLM token maliyetini ne kadar düşürür?

Ham natal JSON dump 1.500-3.000 token tutar. 'minimal' preset 150-250 token, 'full' 500-800, 'traditional' 600-900 kullanır. Ortalama ~60% azaltım — ve tasarruflar çok-turn oturumlarda birikir. GPT-4 sınıfı fiyatlarda ayda 10.000 natal okuma yapan bir chatbot prompt token'larında yaklaşık 150-300 USD tasarruf eder. Küçük context aynı zamanda pencere dolmadan daha uzun sohbet sığması demek.

to_prompt_text() hangi dilleri destekliyor?

Aspekt, dignite, sect, ev ve modaliteleri kapsayan ~40 yerel string ile yedi dil: İngilizce (en), Almanca (de), İspanyolca (es), Fransızca (fr), İtalyanca (it), Portekizce (pt), Rusça (ru). Dil kodunu geç ve formatter o dilde markdown döner — yerelleştirilmiş chatbot prompt'una bırakılmaya hazır. İstemci tarafı çeviri gerekmez.

Aspektler doğal dilde nasıl formatlanır?

Aspektler hassas orb'larla okunabilir ifadeler olarak çıkar. Örnekler: '2° içinde Mars kare Satürn', '0°45' içinde Venüs trine Jüpiter', '1°15' içinde Ay opposite Güneş'. Aspekt adı (square, trine, opposition, sextile, conjunction) yazılır, orb derece ve dakika olarak gösterilir ve gezegenler ilişki kelimesinin iki yanında oturur — tam olarak bir astroloğun yazacağı gibi. LLM'ler bunu ilk geçişte doğru parse eder.

Formatlanmış çıktıda t. ve n. prefix'leri ne anlama gelir?

't.' transit gezegenleri, 'n.' natal gezegenleri işaretler. Bir transit okuması formatladığında her aspekt satırı kaynağı net gösterir — örneğin '1° içinde t.Jupiter trine n.Venus', transit Jüpiter'in natal Venüs'e trin olduğunu söyler. Bu tek değişiklik astroloji chatbot'larındaki en yaygın halüsinasyonu ortadan kaldırır: natal grafik ile anlık gökyüzü arasındaki gezegen kimlik karışıklığı. LLM tahmin etmek zorunda kalmaz.

YENİ: AI Ajan Platformu

Sadece Sohbet Değil. AI Astroloji Ajanları Geliştir

Astroloji için tek OpenAI uyumlu agentic platform.

16 sunucu tarafı araç, BYOK model seçimi, SSE streaming, çoklu konu oturumları. Tek API çağrısı, tam ajan döngüsü.

API Dokümantasyonu

LLM Context Preset

Prompt Dili

60%

Token Azaltımı

Ajan Aracı

OpenAI SDK Doğrudan Entegrasyon

Kendi Anahtarını Getir

Sunucu Tarafı Ajan Döngüsü

Ajanı İş Başında Gör

Sunucu tarafı tool orkestrasyonuyla güçlendirilmiş gerçek sohbetler

Astrology Chat APILive Demo

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrology-api.io/api/v3/chat",
  apiKey: "your-astrology-api-key",
});

const response = await client.chat.completions.create({
  model: "astro-default",
  stream: true,
  messages: [
    { role: "system", content: "Warm, insightful astrologer." },
    { role: "user", content: "Analyze my natal chart" }
  ],
  astrology: {
    subjects: [{ id: "me", birth_data: {
        year: 1990, month: 3, day: 15,
        hour: 14, minute: 30,
        city: "New York", country_code: "US"
      } }],
    enabled_tools: ["charts_natal"],
    defaults: { language: "tr", tradition: "psychological" }
  }
} as any);

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

16 endpoint'imizin herhangi biri veya kombinasyonlarıyla çalışır

Vedik Jyotish

Horary Sorular

Human Design

Astrokartografi

Numeroloji

Tarot Okuması

İlişki Sinastrisi

Transit Tahmini

Tek oturumda herhangi bir endpoint kombinasyonu — natal, Vedik, horary, BaZi, astrokartografi ve dahası.Hosted: 25 + endpoint kredisi/turn · BYOK: 2 + endpoint kredisi + LLM maliyeti

Tam bir natal JSON dump grafik başına 1.500-3.000 token yer — context pencereleri hızla dolar
'Mars 0d 90.0 Saturn' gibi şifreli alan adları modeli şaşırtır ve yanlış yorumlar üretir
Prefix olmadan karışan transit ve natal veri — LLM hangi gezegenin hangisi olduğunu uydurur
BYOK seçeneği veya maliyet kontrolü olmayan tescilli chat modellerine bağımlılık
Sadece İngilizce prompt context çok dilli chatbot yayınını engeller
Kendi tool loop'unu, prompt formatter'ını ve oturum yöneticini sıfırdan kurmak

Şununla dönüştür

to_prompt_text() formatter: 3 preset (minimal 150-250, full 500-800, traditional 600-900 token) — ham JSON'a göre ~60% azaltım
Doğal-dil aspektler: şifreli alan kodları yerine '2° içinde Mars kare Satürn'
t. / n. prefix'leri transit ve natal'i ayırt eder (örn. 't.Jupiter trine n.Venus') — halüsinasyon biter
7 dilli i18n (~40 string) küresel chatbot yayını için EN, DE, ES, FR, IT, PT, RU dillerini kapsar
BYOK: GPT-5, Claude 4, Gemini 3, Grok veya 50+ OpenRouter modelinden herhangi biri
16 araç, çoklu konu oturumları ve binary artefakt içeren sunucu tarafı ajan döngüsü

Platform Performansı

Token-optimize context, ajan-hazır araçlar, hızlı hesaplamalar

LLM Context Preset

Prompt Dili

~60%

JSON'a Göre Token Azaltımı

~40

Formatter'daki i18n String

Ajan Aracı

<300ms

Hesaplama Hızı

Yorum Dili

50+

LLM Modeli

Eksiksiz Ajan Platformu Özellikleri

AI astroloji deneyimleri kurmak için ihtiyacın olan her şey

to_prompt_text() LLM Context Formatter

Kendi Anahtarını Getir (BYOK)

SSE Streaming ve Event'ler

16 Otomatik Üretilen Ajan Aracı

Çoklu Konu ve Oturumlar

AI Kodlama Araçları İçin Widget-Hazır

Binary Artefaktlar ve Çıktı

Astroloji Chat API Nedir? Eksiksiz Geliştirici Rehberi

AI destekli astroloji deneyimleri kurmak için ihtiyacın olan her şey

Tek bir API çağrısıyla uygulamana tam fonksiyonel bir astroloji AI ajanı eklesen nasıl olurdu? Astroloji Chat API tam olarak bunu yapıyor. Sadece bir chatbot endpoint'i değil — tüm tool-calling döngüsünü sunucu tarafında çalıştıran eksiksiz bir agentic platform. Bir kullanıcı mesajı gönderiyorsun, sunucu özerk biçimde 16 astroloji aracından hangisini çağıracağına karar veriyor, subject ID'lerden doğum haritası verisini çözüyor (uydurulan tarih yok), binary artefakt olarak PDF rapor veya SVG grafik üretiyor ve tutarlı bir yanıt döndürüyor — hepsi OpenAI uyumlu /chat/completions endpoint'i üzerinden. Yani TypeScript, Python, Go veya herhangi bir dilde standart OpenAI SDK'sını kullanabilirsin. Özel entegrasyon kodu yok. Kendi ajan framework'ünü kurmak yok. Tool şemalarını yönetmek yok. Mevcut astroloji chat çözümleri sorgu başına 0,25-0,87 USD ücret alıyor, 8-24 saniyede yanıt veriyor, seni tescilli modellere kilitliyor ve her platform için özel entegrasyon kodu gerektiren custom JSON formatları kullanıyor. BYOK destekli hazır ajan sunan tek platform biziz — LLM'i kendin seç: GPT-5, Claude, Gemini, Grok veya OpenRouter'daki 50+ modelden biri.

Agentic Chat API Nasıl Çalışır?

Astroloji Chat API, astrolojiyi derinlemesine bilen özel bir AI ajanı gibi çalışır.

Akış şöyle: 1) Standart OpenAI /chat/completions endpoint'i üzerinden mesaj gönderirsin.

2) Sunucu astrolojik context enjekte eder — konularının doğum verisi, aktif araçlar, dil tercihleri.

3) LLM hangi araçları çağıracağına karar verir (natal grafik hesabı, transit analizi, sinastri raporu vb.).

4) Sunucu bu araçları 82 astroloji endpoint'ine karşı dahili olarak çalıştırır — senin tarafından ekstra API çağrısı yok.

5) Araç sonuçları sentez için LLM'e geri verilir.

6) Gerçek gezegen verisiyle desteklenen tutarlı bir yorum alırsın.

Tüm tool loop tek bir istekte sunucu tarafında çalışır.

Tool-call mesajlarını hiç görmezsin — sadece nihai cevabı.

Streaming (SSE) aktifken tool_start ve tool_end gibi gerçek zamanlı extension event'ler de alırsın, böylece UI'n ajan çalışırken 'Transit grafiği hesaplanıyor...' gösterebilir.

Tüm ajan döngüsü tek bir API çağrısında sunucu tarafında çalışır

1 min read

BYOK Nedir ve Neden Önemli?

BYOK — Bring Your Own Key (Kendi Anahtarını Getir) — astroloji ajanını hangi LLM'in çalıştıracağını seçmen demek.

Piyasadaki diğer her astroloji chat çözümü seni alternatifsiz tek bir tescilli modele kilitliyor — bazıları hangi modeli kullandığını bile açıklamıyor.

BYOK endpoint'imizle (/chat/completions/byok) kendi API anahtarını ve model ID'ni geçersin.

Üç sağlayıcı destekliyoruz: OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4) ve OpenRouter (Gemini 3, Grok 4, Llama, Mistral dahil 50+ model).

Neden önemli? Maliyet kontrolü — GPT-5-nano, GPT-5-pro'dan 10 kat ucuz.

Kalite ayarı — Claude nüanslı yorumda iyi, Gemini basit sorgularda daha hızlı.

Uyumluluk — bazı kurumlar belirli model sağlayıcıları zorunlu tutar.

BYOK turn başına sadece 2 kredi (platform ücretimiz) artı LLM sağlayıcının ücretini tutar.

50+ LLM modeli mevcut — maliyeti, kaliteyi ve sağlayıcıyı sen seçersin

1 min read

Neden Tek OpenAI Uyumlu Seçenek?

OpenAI uyumluluğu, milyonlarca geliştiricinin zaten bildiği standart OpenAI SDK'sını kullandığın anlamına gelir.

Öğrenecek yeni SDK yok, kuracak özel HTTP client yok.

TypeScript'te: new OpenAI({ baseURL: 'https://api.astrology-api.io/api/v3/chat' }).

Python'da: OpenAI(base_url='...').

Bu kadar.

ChatGPT için yazdığın mevcut kod minimum değişiklikle çalışır.

Bu ayrıca OpenAI protokolü üzerine kurulu her framework'le anında uyum demek: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI.

Framework'ün OpenAI konuşuyorsa, Astrology Chat API'yi konuşuyor demektir.

Başka hiçbir astroloji sağlayıcı bunu sunmuyor — mevcut çözümler tescilli request/response yapısıyla özel endpoint'ler kullanıyor ve desteklediğin her platform için özel entegrasyon kodu gerektiriyor.

Her OpenAI SDK ile çalışır — TypeScript, Python, Go, Rust ve her AI framework'ü

1 min read

Vibe Coding İçin Mükemmel — Dakikalar İçinde Astroloji Widget'ları

API'miz standart OpenAI protokolünü kullandığı için her AI kodlama aracı onunla nasıl çalışacağını zaten biliyor.

Lovable'a 'Bu API'yi kullanarak bana bir astroloji chat widget'ı yap' de, çalışan bir React bileşeni üretsin — streaming UI, doğum verisi formu, sohbet balonları, hepsi.

Claude Code ve Cursor tek bir prompt'la tam entegrasyon iskelesi kurabilir çünkü OpenAI SDK'sını yerel olarak anlıyorlar.

Özel adaptör yok, anlaşılmaz dokümantasyon yok, tescilli JSON formatlarını debug etmek yok.

Aynı durum Windsurf, Bolt, Replit Agent ve OpenAI API'sine karşı kod yazabilen herhangi bir AI aracı için geçerli.

Platformumuzu vibe coding için benzersiz yapan şey bu: istediğin widget'ı tarif edersin, AI onu inşa eder ve ilk denemede çalışır — çünkü altta yatan API, bu araçların eğitildiği protokolün aynısı.

Vibe coder'lar haftalar değil saatler içinde astroloji uygulamaları yayınlıyor.

Chat widget'ları, uyum kontrolcüleri, günlük burç üreticileri, natal harita yorumcuları — hepsi bir AI kodlama asistanına ne istediğini tarif ederek yapılıyor.

Anında başlamak için bu prompt'u herhangi bir AI kodlama aracına kopyala:

Lovable, Claude Code, Cursor, Windsurf — her AI kodlama aracı anında çalışan entegrasyon kurabilir

1 min read

16 Ajan Aracı Neler Yapabilir?

Platform, sohbet sırasında LLM'in özerk biçimde çağırabileceği 16 araç sunar.

Bu araçlar mevcut 82 API endpoint'imizden dinamik bir registry kullanarak otomatik üretilir — sadece 'chat-safe' olarak işaretli endpoint'ler araca dönüşür.

Araçlar şunları kapsar: Analiz (3 araç) — çok bölümlü yorumlar içeren natal raporlar, ay fazları ve menzilleriyle ay analizi, ilişki indeks skorlarıyla sinastri raporları.

Grafik Hesaplamaları (4 araç) — natal, sinastri, kompozit ve transit grafikler; tam gezegen pozisyonları ve aspektlerle.

Grafik Görselleştirme (4 araç) — SVG, PNG, JPG, WebP veya PDF olarak natal, sinastri, transit ve kompozit grafikler.

Üretilen grafikler paylaşılabilir URL'lerle binary artefakt olarak saklanır.

Veri (3 araç) — anlık gezegen pozisyonları, herhangi bir tarih için ephemeris ve aspekt matrisleri.

Burç (1 araç) — 6 yaşam alanı, derecelendirme ve gezegen etkileriyle kişiselleştirilmiş günlük burç.

PDF (1 araç) — çark görseli, yorumlar ve temalarla çok sayfalı profesyonel natal rapor.

Yeni araç eklemek chat endpoint'inde sıfır kod değişikliği gerektirir — sadece mevcut bir endpoint'i 'chat-safe' olarak etiketle.

82 endpoint'ten otomatik üretilen 16 araç — yeni araçlar sıfır chat kodu değişikliği gerektirir

1 min read

Çoklu Konu Oturumları ve Artefaktlar Nasıl Çalışır?

Hiçbir rakipte olmayan iki özellik: çoklu konu oturumları ve binary artefaktlar.

Çoklu konu, tek bir sohbette birden fazla doğum haritası geçirebilmen demek — örneğin 'ben' ve 'partner'.

LLM araçları çağırırken konulara semantic ID'siyle referans verir, sunucu da bunları tam doğum verisine çözer.

Bu, tek sohbet oturumunda sinastri analizi, kompozit grafik karşılaştırmaları ve aile dinamikleri yapmayı sağlar — doğum verisini tekrar göndermeden.

Başka hiçbir chat API'si oturum başına birden fazla konu desteklemiyor.

Binary artefaktlar sohbetin indirilebilir dosya üretmesini sağlar.

'Natal grafiğimi oluştur' de, SVG grafik görseli al.

'PDF rapor hazırla' de, çok sayfalı profesyonel belge al.

Artefaktlar Supabase'de paylaşılabilir URL'ler ve 24 saatlik saklama süresiyle tutulur.

Oturumlar Redis üzerinden 24 saatlik kayan TTL ile kalıcı olur.

Aynı session_id'yi turn'ler arası geçirirsin, sunucu sohbet geçmişini, konuları ve context'i geri yükler — istemci tarafı state yönetimi olmadan gerçek çok-turn bellek.

Çoklu konu oturumları ve binary artefaktlar — ikisi de platformumuza özgü

1 min read

to_prompt_text() LLM Token Maliyetini Nasıl ~60% Düşürür

Çoğu geliştirici LLM chatbot'larını tam grafik JSON'unu prompt'a dökerek besler.

JSON'da bir natal grafik 1.500-3.000 token tutar — GPT-4 sınıfı modellerde istek başına 0,015-0,030 USD eder, üstelik context penceresi birkaç turn sonra dolar.

Daha kötüsü, model çoğunlukla 'Mars 0d 90.0 Saturn' gibi şifreli alan kodlarını yanlış okur ve hatalı yorum üretir.

to_prompt_text() formatter'ımız iki sorunu da çözer.

Grafik verisini doğal-dil aspektlerle kompakt, okunabilir markdown'a çevirir.

Üç preset doğru token bütçesini seçmeni sağlar: 'minimal' (~150-250 token) sun/moon/asc, kilit aspektler, anlık transitleri kapsar — chat yanıtları için harika.

'full' (~500-800 token) zenginleştirilmiş yorumlar için dignite, evler, modaliteler ve sect ekler.

'traditional' (~600-900 token) klasik tarzı okumalar için Helenistik ve ortaçağ derinliği içerir — lots, almuten, hayz, antiscia.

Biçimlendirilmiş markdown'u herhangi bir LLM prompt'una (Claude, GPT, Gemini, Grok) bırak, modeli JSON dökmeden gerçek grafik verisine bağla.

Ortalama token tasarrufu: ham JSON dump'a göre ~60%, ölçülebilir biçimde daha az halüsinasyonla.

3 preset, 150-900 token, JSON dökmekten ~60% daha ucuz

1 min read

Doğal-Dil Aspektler ve t./n. Prefix'leri

LLM'ler doğal dili alan kodlarından daha iyi okur — bu yüzden to_prompt_text() aspektleri bir astroloğun yazacağı şekilde çıktılar.

'Mars 0d 90.0 Saturn' yerine '2° içinde Mars kare Satürn' alırsın.

Orb hassas kalır ama model ilk geçişte parse eder.

Formatter natal grafiğin yanında transit verisini de içerdiğinde her gezegen prefix'le etiketlenir: transit için 't.', natal için 'n.'.

Yani bir transit okuması '1° içinde t.Jupiter trine n.Venus' gösterir — modelin hangi gezegenin hangi grafiğe ait olduğunu tahmin etmesine gerek kalmaz.

Bu tek değişiklik astroloji chatbot'larındaki en yaygın halüsinasyon kaynağını ortadan kaldırır: grafikler arası gezegen kimlik karışıklığı.

7 dilli i18n (EN, DE, ES, FR, IT, PT, RU — aspekt, sect, dignite, ev, modaliteleri kapsayan ~40 string) ile birleşince, hiçbir şeyi istemci tarafında çevirmeden Claude veya GPT'yi yerelleştirilmiş grafik context'iyle besleyen çok dilli chatbot yayınlayabilirsin.

Doğal-dil aspektler + transit/natal prefix'leri halüsinasyonları ortadan kaldırır

1 min read

Rakiplere Karşı Performans ve Fiyat

Rakamlara bakalım.

Rakip astroloji chat çözümlerinin en hızlısı yanıt başına 8-12 saniye sürüyor.

Piyasadaki standart seviye planlar ortalama 19-24 saniye sürüyor.

Bizim hesaplama katmanımız 300ms altında yanıt veriyor — toplam yanıt süresi sadece LLM hızına bağlı, streaming'le tipik olarak 2-5 saniye.

Yani 4-10 kat daha hızlı.

Fiyatta, alternatifler AI sorgusu başına 0,25-0,87 USD alıyor — aylık abonelik ücretlerine ek olarak.

Bizim fiyatımız üç bileşenli: (1) turn başına platform kredisi — hosted 25 veya BYOK 2, (2) ajanın çağırdığı her araç için endpoint kredisi (örn.

natal grafik = 1 kredi, astrokartografi = 5 kredi, PDF rapor = 35 kredi) ve (3) BYOK kullanıyorsan kendi LLM maliyetin.

Örnek: bir natal yorum turn'ü hosted modda 25 + 1 = 26 kredi (~0,02 USD) veya BYOK'ta 2 + 1 = 3 kredi (~0,002 USD) artı ~0,003 USD LLM maliyeti tutar.

Bu, alternatiflere göre sohbet turn'ü başına 10-100 kat daha ucuz.

Chat'i standart ücretsiz katmanımıza dahil ediyoruz: ayda 50 istek, kredi kartı gerekmez.

Rakiplerden 4-10 kat daha hızlı ve 10-100 kat daha ucuz

1 min read

Use Cases

Astroloji Mobil Uygulamaları

iOS veya Android uygulamana konuşma yapabilen AI astrolog ekle. Kullanıcılar doğal dilde soru sorar, gerçek grafik hesaplarına dayalı kişiselleştirilmiş yorumlar alır. OpenAI SDK React Native ve Flutter ile yerel olarak çalışır.

Tanışma ve Uyum Platformları

Çoklu konu oturumları iki kullanıcı arasında gerçek zamanlı uyum analizi sağlar. Ajan sinastri, kompozit grafikler ve ilişki dinamiklerini tek sohbet akışında hesaplar.

İçerik Üretim Pipeline'ları

Ölçekte kişiselleştirilmiş burç, haftalık tahmin ve natal rapor üret. Maliyet verimli model (GPT-5-nano) ile BYOK kullan ve günlük e-posta veya push bildirim içeriği için 2.800+ kullanıcı toplu işle.

Wellness ve Mental Sağlık Platformları

Astrolojik içgörüleri mindfulness uygulamalarına, terapi araçlarına ve öz-yansıma platformlarına entegre et. Psikolojik gelenek modu, büyüme ve öz-farkındalığa odaklı Jung tarzı yorumlar sağlar.

SaaS Astroloji Platformları

Tüm ajanı kendi ürünün olarak white-label yap. Özel sistem prompt'ları kişiliği belirler, BYOK maliyeti kontrol eder ve oturum kalıcılığı ücretli aboneler için çok-turn danışmaları mümkün kılar.

AI Ajan Framework'leri

LangChain, CrewAI, AutoGen veya herhangi bir OpenAI uyumlu ajan framework'üne doğrudan bağlan. API'miz çoklu ajan sisteminde özel bir astroloji aracı olur — özel adaptör gerekmez.

AI Araçlarıyla Vibe Coding

Lovable, Claude Code, Cursor veya Windsurf'a sana bir astroloji widget'ı yapmasını söyle — dakikalar içinde çalışan uygulama al. API'miz OpenAI protokolünü takip ettiği için AI kodlama araçları ilk denemede doğru entegrasyon üretir. Chat widget'ları, burç üreticileri, uyum kontrolcüleri — tarif et ve yayınla.

Technical Specifications

API Protokolü	OpenAI Chat Completions (v1)
Endpoint'ler	/chat/completions (hosted) + /chat/completions/byok
LLM Context Formatter	3 preset ile to_prompt_text()
Preset Değerleri	minimal \| full \| traditional
Preset Başına Token Aralığı	minimal 150-250 · full 500-800 · traditional 600-900
Aspekt Formatı	'2° içinde Mars kare Satürn' (doğal dil)
Transit/Natal Prefix'leri	t.Jupiter trine n.Venus
Prompt Formatter Dilleri	7 (en, de, es, fr, it, pt, ru)
Formatter'daki i18n String	7 dilde ~40
Ajan Araçları	82 endpoint'ten otomatik üretilen 16
Hesaplama Hızı	araç çağrısı başına <300ms
Toplam Yanıt Süresi	streaming ile 2-5s
Streaming	tool_start/tool_end extension event'leri ile SSE
BYOK Sağlayıcıları	OpenAI, Anthropic, OpenRouter (50+ model)
Hosted Model	astro-default (astroloji için optimize)
Oturum Kalıcılığı	Redis tabanlı, 24h kayan TTL
Çoklu Konu	Oturum başına sınırsız konu
Binary Artefaktlar	Chat üzerinden SVG, PNG, JPG, WebP, PDF
Yorum Dilleri	9 (en, de, fr, es, it, pt, ru, zh, hi)
Gelenekler	Klasik, Psikolojik, Olay-Odaklı, Evrensel
Kimlik Doğrulama	Bearer token (API anahtarı)
Rate Limiting	API anahtarı başına, yapılandırılabilir

Astroloji Chat API vs DIY JSON Dump Yaklaşımı

Feature	Astrology API	Others
LLM Prompt Token'ları (grafik başına)	150-900 (preset'e bağlı)	1.500-3.000 (ham JSON)
Prompt Başına Token Maliyeti	JSON dökmekten ~60% daha az	Her turn'de tam token harcaması
Aspekt Okunabilirliği	'2° içinde Mars kare Satürn'	'Mars 0d 90.0 Saturn' (şifreli)
Transit/Natal Ayrımı	Yerleşik t. / n. prefix'leri	Model tahmin eder (halüsinasyon)
Çok Dilli Prompt Context	7 dil (~40 i18n string)	Sadece İngilizce veya kendin çevir
Halüsinasyon Oranı	Düşük — temelli doğal dil	Yüksek — şifreli kodlar LLM'i şaşırtır
OpenAI SDK Uyumlu	Evet (drop-in)	Hayır (özel API'ler)
BYOK Model Seçimi	50+ model (3 sağlayıcı)	Tescilli modele kilitli
Sunucu Tarafı Ajan Döngüsü	16 araç, otomatik	Kendin kur
Çoklu Konu Oturumları	Sınırsız konu	Tek doğum haritası
Binary Artefaktlar	Chat üzerinden PDF, SVG, PNG	Yok
Yanıt Süresi	2-5s (streaming)	8-24 saniye
Sorgu Başına Fiyat	$0.001-$0.02	$0.25-$0.87
Ücretsiz Katman	Ayda 50 istek	Yok veya ücretli sandbox
AI Kodlama Araçları (Vibe Coding)	Anında çalışır (OpenAI protokolü)	Özel format, sadece manuel kod

İlgili Astroloji API'leri

Natal Chart API

Gezegen pozisyonları, evler ve aspektlerle tam natal grafikleri hesapla

Transit API

Anlık gezegen transitleri — chatbot context'i için to_prompt_text() ile eşleşir

Traditional Astrology API

Helenistik ve ortaçağ teknikleri — 'traditional' preset derinliğiyle uyumlu

Timing API

Electional ve olay zamanlaması — tahmin sorularında chat prompt'larına ekle

Horary API

AI horary endpoint — soru tabanlı okumalar için chat ajanıyla doğal eşleşir

Synastry API

İki grafik arasında ilişki uyum analizi

PDF Report API

Profesyonel çok sayfalı astroloji PDF raporları üret

API Dokümantasyonu

İnteraktif örneklerle tam teknik referans

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Bu prompt'u Lovable, Claude Code, Cursor veya herhangi bir AI kodlama aracına kopyala:

Build an astrology chat widget using the OpenAI SDK. Use base URL https://api.astrology-api.io/api/v3/chat and read the API docs at https://api.astrology-api.io/md/chat-completions for the full request schema. The widget should have: a birth data form (date, time, city), a streaming chat interface with message bubbles, and display tool call events (like 'Calculating natal chart...') as the agent works. Use the astrology namespace for subjects and enabled_tools as documented.

Basit, Seffaf Fiyatlandirma

Ucretsiz baslayin, buyudukcce olceklendirin. Gizli ucret yok, surpriz yok.

Her Zaman Ucretsiz

Ucretsiz Basla

Ogrenme, test etme ve kucuk kisisel projeler icin mukemmel

50 API cagrisi/ay

Temel natal haritalar

5 ev sistemi

Topluluk destegi

Pro

$11/ay

Kucuk uygulamalar ve kisisel projeler icin

Tum temel endpoint'ler
12 ev sistemi
E-posta destegi

En Iyi Deger

Pro Plus

$21/ay

Buyuyen uygulamalar ve orta trafik icin

Tum gelismis endpoint'ler
18 ev sistemi
AI yorumlari
Oncelikli e-posta destegi

Ultra

$37/ay

Profesyonel astroloji uygulamalari icin

Credit math ↓

Tum premium endpoint'ler
23 ev sistemi
Gelismis AI yorumlari
Oncelikli destek

Yuksek Hacim Planlari

Kurumsal olcekli uygulamalar icin

Is

$99/ay

Yuksek hacimli uygulamalar icin

Credit math ↓

TUM endpoint'ler
White-label hazir
Ozel AI ince ayar
Telefon destegi

SINIRSIZ

Kurumsal

$399+aylik

Ozel altyapi ile sinirsiz istek

Ozel sunucu altyapisi
<300ms garantili
7/24 ozel destek
%99.99 uptime SLA

Tum planlar kapsamli dokumantasyon ve SDK'lar icerir

Sorulariniz mi var? Ekibimizle konusun

Astroloji Chat API Hakkında Sık Sorulan Sorular

Agentic astroloji platformu hakkında gerçek yanıtlar

Eksiksiz Astroloji Stack'ini Kur

Chat API bu endpoint'leri otomatik orkestre eder ama doğrudan da kullanabilirsin:

Natal Chart API chat'in arkasındaki ham grafik hesaplamaları Transit API prompt context'i için anlık gezegen etkileri Traditional Astrology API Helenistik derinlik — 'traditional' preset ile uyumlu Timing API electional zamanlama ve tahmin sorguları Horary API AI horary endpoint — chat ajanıyla eşleşir Synastry API ilişki ve uyum analizi PDF Report API profesyonel çok sayfalı belgeler MCP Astrology Server Claude Desktop entegrasyonu

Token-Optimize

OpenAI uyumlu ajan, 16 araç, BYOK ve 7 dilde to_prompt_text() context. Ham JSON dökmeye göre LLM token maliyetlerini ~60% düşür.

Ücretsiz Başla API Dokümantasyonu

Ayda 50 ücretsiz istek

OpenAI SDK uyumlu

Kurulum ücreti yok

Sadece Sohbet Değil. AI Astroloji Ajanları Geliştir

Ajanı İş Başında Gör

Ham JSON'u LLM Prompt'larına Boşaltmak Token Harcar ve Halüsinasyona Yol Açar

Token-Optimize LLM Context + Tek API'de Tam Ajan Platformu

Platform Performansı

Eksiksiz Ajan Platformu Özellikleri

to_prompt_text() LLM Context Formatter

Kendi Anahtarını Getir (BYOK)

SSE Streaming ve Event'ler

16 Otomatik Üretilen Ajan Aracı

Çoklu Konu ve Oturumlar

AI Kodlama Araçları İçin Widget-Hazır

Binary Artefaktlar ve Çıktı

Astroloji Chat API Nedir? Eksiksiz Geliştirici Rehberi

Agentic Chat API Nasıl Çalışır?

BYOK Nedir ve Neden Önemli?

Neden Tek OpenAI Uyumlu Seçenek?

Vibe Coding İçin Mükemmel — Dakikalar İçinde Astroloji Widget'ları

16 Ajan Aracı Neler Yapabilir?

Çoklu Konu Oturumları ve Artefaktlar Nasıl Çalışır?

to_prompt_text() LLM Token Maliyetini Nasıl ~60% Düşürür

Doğal-Dil Aspektler ve t./n. Prefix'leri

Rakiplere Karşı Performans ve Fiyat

Use Cases

Astroloji Mobil Uygulamaları

Tanışma ve Uyum Platformları

İçerik Üretim Pipeline'ları

Wellness ve Mental Sağlık Platformları

SaaS Astroloji Platformları

AI Ajan Framework'leri

AI Araçlarıyla Vibe Coding

Technical Specifications

Astroloji Chat API vs DIY JSON Dump Yaklaşımı

İlgili Astroloji API'leri

Natal Chart API

Transit API

Traditional Astrology API

Timing API

Horary API

Synastry API

PDF Report API

API Dokümantasyonu

References & Standards

Basit, Seffaf Fiyatlandirma

Her Zaman Ucretsiz

Pro

Pro Plus

Ultra

Yuksek Hacim Planlari

Is

Kurumsal

Astroloji Chat API Hakkında Sık Sorulan Sorular

Astroloji Chat API nedir ve normal bir chatbot'tan nasıl farklı?

Bu API ile OpenAI Python veya TypeScript SDK kullanabilir miyim?

BYOK ile hangi LLM modelleri destekleniyor?

Her chat turn'ü kredi olarak ne kadara mal olur?

Sinastri ve uyum için çoklu konu sohbet nasıl çalışır?

Sohbet PDF raporu ve SVG grafik görseli üretebilir mi?

Astroloji Chat API alternatiflere göre ne kadar hızlı?

SSE streaming extension event'leri nedir?

Oturumlar ve sohbet belleği nasıl çalışır?

Hangi programlama dilleri ve framework'ler destekleniyor?

Bu sadece bir GPT sarmalayıcısı mı yoksa gerçek astronomik veri mi kullanıyor?

Yanıt tarzını ve uzunluğunu nasıl kontrol ederim?

Hangi astroloji gelenekleri ve ev sistemleri destekleniyor?

Bunu kendi ürünüm olarak white-label yapabilir miyim?

Sohbet sırasında bir tool çağrısı başarısız olursa ne olur?

Lovable, Claude Code veya Cursor ile bir astroloji widget'ı yapabilir miyim?

Astroloji Chat API, RoxyAPI veya ham veri endpoint'leriyle kendim kurmaya kıyasla nasıl?

to_prompt_text() nedir ve chatbot geliştiricileri neden umursamalı?

Hangi preset'i kullanmalıyım — minimal, full mı yoksa traditional mı?

Prompt formatter LLM token maliyetini ne kadar düşürür?

to_prompt_text() hangi dilleri destekliyor?

Aspektler doğal dilde nasıl formatlanır?

Formatlanmış çıktıda t. ve n. prefix'leri ne anlama gelir?

Eksiksiz Astroloji Stack'ini Kur

Token-Optimize

Ajanı İş Başında Gör

Ham JSON'u LLM Prompt'larına Boşaltmak Token Harcar ve Halüsinasyona Yol Açar

Token-Optimize LLM Context + Tek API'de Tam Ajan Platformu