Başlangıç
Başlangıç
Bir API anahtarı oluşturun, bir AI aracı seçin, kurulum kılavuzunu açın ve iş akışınızda ilk API çağrınızı yapın.
Felo API Platform, ajan araçları, model protokolleri, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page ve SuperAgent API'leri için tek bir anahtar sunar. Buradan başlayın, kullandığınız aracı seçin ve ardından o araca özel kurulum kılavuzunu izleyin.
Yeni misiniz? Model API, Data API ve Felo API'lerinin birbirine nasıl bağlandığını öğrenmek için Platform Genel Bakış bölümünü okuyun veya doğrudan Protokoller ve SDK'lar ile Kanallar ve Sağlayıcı Yönlendirme sayfalarına gidin.
Codex veya Claude Code'u CLI ile yapılandırın
Node.js 22+ ve yapay zeka aracınız kuruluysa şunu çalıştırın:
npx feloapi-cli setupİstemleri izleyerek eksiksiz Felo API anahtarınızı yapıştırın ve modelleri, Skills'i veya her ikisini seçin. Ardından aracınızı npx feloapi-cli run codex veya npx feloapi-cli run claude-code ile başlatın.
Hızlı Başlangıç Akışı
- Bir Felo API Platform anahtarı alın ve gerektiğinde hizmet kredisi satın alın; abonelik gerekmez.
- Aşağıdaki tablodan yapay zeka aracınızı veya platformunuzu seçin.
- İlgili kurulum kılavuzunu açın ve Felo temel URL'sini ve API anahtarını yapıştırın.
- Bağlantıyı doğrulamak için o araçta küçük bir görev çalıştırın.
- Ajanınız arama, ofis çıktısı, web ayıklama, görsel iş akışları, LiveDocs veya SuperAgent gerektiriyorsa iş akışı API'lerini ekleyin.
1. Adım: API Anahtarınızı Alın
Felo API Platform, doğrudan API çağrılarında ve desteklenen yapay zeka araçlarında tek bir API anahtarı kullanır.
- Felo API Platform API Anahtarları sayfasını açın.
- İstenirse Felo hesabınızla oturum açın.
- Bir anahtar adı girin ve Create Key düğmesine tıklayın.
- Anahtar göründüğünde tamamını kopyalayın. Yalnızca bir kez gösterilir.
- Anahtarı güvenli bir şekilde saklayın ve
FELO_API_KEYolarak kullanın.
Console Billing'de kullandıkça $1 tutarından başlayarak bakiye yükleyin. Gerçek API kullanımı için ABD doları cinsinden hizmet kredisi satın alırsınız. Abonelik gerekmez.
Anahtarı bir ortam değişkeni olarak ayarlayın:
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell:
$env:FELO_API_KEY="YOUR_API_KEY"2. Adım: Yapay Zeka Aracınızı Seçin
Kullanmak istediğiniz araca tıklayın. Her bağlantı, doğru temel URL, ortam değişkenleri ve doğrulama adımını içeren özel bir kurulum kılavuzu açar.
| Araç | En uygun olduğu alanlar | Kurulum kılavuzu |
|---|---|---|
| Codex | CLI kodlama iş akışları, kod incelemesi, depo değişiklikleri ve otomasyon | Codex'i ayarlayın |
| Claude Code | Ajan kodlama, depo düzenleme, araştırma destekli geliştirme ve uzun bağlamlı çalışma | Claude Code'u ayarlayın |
| OpenCode | Terminal kodlama oturumları ve OpenAI uyumlu sağlayıcı yönlendirme | OpenCode'u ayarlayın |
| OpenClaw | Kişisel yapay zeka asistanı iş akışları ve yerel ajanlar | OpenClaw'u ayarlayın |
| Hermes Agent | Ajan deneyleri ve çok araçlı orkestrasyon | Hermes Agent'ı ayarlayın |
| TRAE | Yapay zeka IDE iş akışları ve destekli düzenleme | TRAE'yi ayarlayın |
| OpenViking | Ajan deneyleri ve sağlayıcı değiştirme | OpenViking'i ayarlayın |
| Cursor | Editör içinde yapay zeka kodlama | Cursor'u ayarlayın |
| Cline | VS Code ajan iş akışları ve terminal destekli kodlama | Cline'ı ayarlayın |
| Roo Code | VS Code kodlama ajanları ve görev planlama | Roo Code'u ayarlayın |
| Kilo Code | Yerel kodlama ajanları ve model sağlayıcı testi | Kilo Code'u ayarlayın |
| Diğer yapay zeka araçları | Özel API anahtarı, temel URL ve model adı kabul eden her istemci | Diğer araçları ayarlayın |
3. Adım: Doğru Temel URL'yi Kullanın
Çoğu araç üç değer ister: API anahtarı, temel URL ve model adı. Temel URL'yi aracın desteklediği protokole göre seçin.
| Araç ne istiyor | Bu değeri kullanın |
|---|---|
| API anahtarı | FELO_API_KEY değeriniz |
| OpenAI uyumlu temel URL | https://openapi.felo.ai/api/v1 |
| Anthropic uyumlu temel URL | https://openapi.felo.ai/api |
| Model kimliği | Model kataloğundan şu anda kullanılabilir bir kimlik seçin |
İstemcinizin hangi modu desteklediğinden emin değilseniz OpenAI uyumlu temel URL ile başlayın. Claude Code veya açıkça bir Anthropic Messages endpoint'i isteyen istemciler için Anthropic uyumlu temel URL'yi kullanın.
4. Adım: Doğrudan API Çağrısıyla Doğrulayın
Yalnızca anahtarınızın çalıştığını doğrulamak istiyorsanız Chat API'yi doğrudan çağırın.
curl -X POST https://openapi.felo.ai/v2/chat \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Research the latest AI agent product trends"
}'Başarılı bir yanıt bir yanıt metni, sorgu analizi ve web kaynakları içerir.
{
"status": "ok",
"data": {
"id": "HabCj883yHLSXc8mWqu4Eq",
"message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
"answer": "...",
"query_analysis": {
"queries": ["AI agent product trends"]
},
"resources": [
{
"link": "https://example.com/report",
"title": "AI Agent Market Report",
"snippet": "..."
}
]
}
}5. Adım: İş Akışı API'lerini Ekleyin
İlk aracınız veya API çağrınız çalıştıktan sonra senaryonuza uyan API'leri bağlayın.
| Senaryo | Önerilen API'ler | Belgeler |
|---|---|---|
| Arama ve araştırma ajanı | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| Ofis üretkenliği ajanı | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| Yaratıcı operasyonlar ajanı | Landing Page, Görsel iş akışları, Web Fetch, Search, SuperAgent | Landing Page API |
| Tam yığın yapay zeka uygulaması | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| Bilgi iş akışı | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
Doğrudan API Örnekleri
Bir yapay zeka aracı yapılandırmak yerine doğrudan API'ye karşı geliştirme yapıyorsanız bu minimal çağrılardan biriyle başlayın.
PPT Görevi Oluşturma
Eşzamansız olarak bir slayt destesi oluşturmak istediğinizde PPT Task API'yi kullanın. Yanıt, yoklayabileceğiniz bir task_id döndürür.
curl -X POST https://openapi.felo.ai/v2/ppts \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Create a 5-slide strategy deck about AI agents for office productivity"
}'Örnek yanıt:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
"ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
}
}Görev durumunu yoklayın:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Açılış Sayfası Görevi Oluşturma
Felo'nun bir istemden açılış sayfası oluşturmasını istediğinizde Landing Page Task API'yi kullanın.
curl -X POST https://openapi.felo.ai/v2/landing_page \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Generate a launch landing page for an AI research assistant"
}'Örnek yanıt:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
}
}PPT görevlerinin kullandığı aynı görev durumu endpoint'ini yoklayın:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Python
import os
import requests
api_key = os.environ["FELO_API_KEY"]
response = requests.post(
"https://openapi.felo.ai/v2/chat",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={"query": "What are the latest AI agent product trends?"},
timeout=60,
)
response.raise_for_status()
print(response.json()["data"]["answer"])JavaScript (Node.js)
const response = await fetch("https://openapi.felo.ai/v2/chat", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "What are the latest AI agent product trends?",
}),
});
if (!response.ok) {
throw new Error(`Felo API request failed: ${response.status}`);
}
const result = await response.json();
console.log(result.data.answer);Yaygın Kurulum Sorunları
| Sorun | Neyi kontrol etmeli |
|---|---|
UNAUTHORIZED | Anahtarın doğru kopyalandığını, iptal edilmediğini ve Authorization: Bearer $FELO_API_KEY olarak gönderildiğini doğrulayın |
| Araç yanlış sağlayıcıyı çağırıyor | Geçerli çalışma alanında veya oturumda Felo sağlayıcısının seçili olduğunu kontrol edin |
| OpenAI uyumlu istemci başarısız oluyor | Temel URL olarak https://openapi.felo.ai/api/v1 kullanın |
| Anthropic uyumlu istemci başarısız oluyor | Temel URL olarak https://openapi.felo.ai/api kullanın |
| Eşzamansız görevin henüz sonucu yok | Görev tamamlanana kadar görev durumu endpoint'ini yoklayın |