Felo API PlatformFelo API Platform

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.

CLI kurulumu ve kullanımı

Hızlı Başlangıç Akışı

  1. Bir Felo API Platform anahtarı alın ve gerektiğinde hizmet kredisi satın alın; abonelik gerekmez.
  2. Aşağıdaki tablodan yapay zeka aracınızı veya platformunuzu seçin.
  3. İlgili kurulum kılavuzunu açın ve Felo temel URL'sini ve API anahtarını yapıştırın.
  4. Bağlantıyı doğrulamak için o araçta küçük bir görev çalıştırın.
  5. 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.

  1. Felo API Platform API Anahtarları sayfasını açın.
  2. İstenirse Felo hesabınızla oturum açın.
  3. Bir anahtar adı girin ve Create Key düğmesine tıklayın.
  4. Anahtar göründüğünde tamamını kopyalayın. Yalnızca bir kez gösterilir.
  5. Anahtarı güvenli bir şekilde saklayın ve FELO_API_KEY olarak 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 alanlarKurulum kılavuzu
CodexCLI kodlama iş akışları, kod incelemesi, depo değişiklikleri ve otomasyonCodex'i ayarlayın
Claude CodeAjan kodlama, depo düzenleme, araştırma destekli geliştirme ve uzun bağlamlı çalışmaClaude Code'u ayarlayın
OpenCodeTerminal kodlama oturumları ve OpenAI uyumlu sağlayıcı yönlendirmeOpenCode'u ayarlayın
OpenClawKişisel yapay zeka asistanı iş akışları ve yerel ajanlarOpenClaw'u ayarlayın
Hermes AgentAjan deneyleri ve çok araçlı orkestrasyonHermes Agent'ı ayarlayın
TRAEYapay zeka IDE iş akışları ve destekli düzenlemeTRAE'yi ayarlayın
OpenVikingAjan deneyleri ve sağlayıcı değiştirmeOpenViking'i ayarlayın
CursorEditör içinde yapay zeka kodlamaCursor'u ayarlayın
ClineVS Code ajan iş akışları ve terminal destekli kodlamaCline'ı ayarlayın
Roo CodeVS Code kodlama ajanları ve görev planlamaRoo Code'u ayarlayın
Kilo CodeYerel kodlama ajanları ve model sağlayıcı testiKilo Code'u ayarlayın
Diğer yapay zeka araçlarıÖzel API anahtarı, temel URL ve model adı kabul eden her istemciDiğ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 istiyorBu değeri kullanın
API anahtarıFELO_API_KEY değeriniz
OpenAI uyumlu temel URLhttps://openapi.felo.ai/api/v1
Anthropic uyumlu temel URLhttps://openapi.felo.ai/api
Model kimliğiModel 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'lerBelgeler
Arama ve araştırma ajanıChat, Web Fetch, X Search, YouTube Subtitling, LiveDocsChat API
Ofis üretkenliği ajanıPPT Task, Mindmap, LiveDocs, SuperAgentPPT Task API
Yaratıcı operasyonlar ajanıLanding Page, Görsel iş akışları, Web Fetch, Search, SuperAgentLanding Page API
Tam yığın yapay zeka uygulamasıLLM API, Chat, LiveDocs, Web Fetch, SuperAgentLLM API
Bilgi iş akışıLiveDocs, Web Fetch, Chat, SuperAgentLiveDoc 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ı

SorunNeyi kontrol etmeli
UNAUTHORIZEDAnahtarı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ıyorGeç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 oluyorTemel URL olarak https://openapi.felo.ai/api/v1 kullanın
Anthropic uyumlu istemci başarısız oluyorTemel URL olarak https://openapi.felo.ai/api kullanın
Eşzamansız görevin henüz sonucu yokGörev tamamlanana kadar görev durumu endpoint'ini yoklayın

Sonraki Adımlar