شروع

Felo API Platform یک کلید برای ابزارهای عامل، پروتکل‌های مدل و APIهای Search، Web Fetch، PPT، Mindmap، LiveDocs، X Search، YouTube Subtitling، Landing Page و SuperAgent در اختیار شما می‌گذارد. از همین‌جا شروع کنید، ابزاری را که به کار می‌برید انتخاب کنید و سپس راهنمای راه‌اندازی اختصاصی همان ابزار را دنبال کنید.

تازه‌وارد هستید؟ مرور پلتفرم را بخوانید تا ببینید Model API، Data API و Felo APIها چگونه در کنار هم قرار می‌گیرند، یا مستقیم به پروتکل‌ها و SDKها و کانال‌ها و مسیریابی ارائه‌دهنده بروید.

پیکربندی Codex یا Claude Code با CLI

با Node.js 22+ و ابزار هوش مصنوعی نصب‌شده، این را اجرا کنید:

npx feloapi-cli setup

دستورهای راهنما را دنبال کنید تا کلید کامل Felo API را جای‌گذاری کنید و مدل‌ها، Skillها یا هر دو را انتخاب کنید. سپس ابزار خود را با npx feloapi-cli run codex یا npx feloapi-cli run claude-code شروع کنید.

نصب و استفاده از CLI

جریان شروع سریع

1. یک کلید Felo API Platform بگیرید و در صورت نیاز اعتبار سرویس بخرید؛ اشتراک لازم نیست.
2. ابزار یا پلتفرم هوش مصنوعی خود را از جدول زیر انتخاب کنید.
3. راهنمای راه‌اندازی متناظر را باز کنید و base URL و کلید API Felo را جای‌گذاری کنید.
4. یک وظیفه کوچک در آن ابزار اجرا کنید تا اتصال را تأیید کنید.
5. وقتی عامل شما به جستجو، خروجی اداری، استخراج وب، گردش‌کارهای تصویر، LiveDocs یا SuperAgent نیاز داشت، APIهای گردش‌کار را اضافه کنید.

گام 1: دریافت کلید API

Felo API Platform یک کلید API را در فراخوانی‌های مستقیم API و ابزارهای هوش مصنوعی پشتیبانی‌شده به کار می‌برد.

1. صفحه API Keys در Felo API Platform را باز کنید.
2. اگر خواسته شد با حساب Felo خود وارد شوید.
3. یک نام برای کلید وارد کنید و روی Create Key کلیک کنید.
4. وقتی کلید کامل نمایش داده شد آن را کپی کنید. کلید فقط یک بار نشان داده می‌شود.
5. کلید را امن نگه دارید و آن را به‌عنوان FELO_API_KEY به کار ببرید.

هر زمان لازم شد در Console Billing از $1 شارژ کنید. شما اعتبار سرویس به دلار آمریکا برای مصرف واقعی API می‌خرید. اشتراک لازم نیست.

کلید را به‌عنوان متغیر محیطی تنظیم کنید:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

گام 2: انتخاب ابزار هوش مصنوعی

روی ابزاری که می‌خواهید به کار ببرید کلیک کنید. هر پیوند راهنمای راه‌اندازی اختصاصی با base URL درست، متغیرهای محیطی و گام بررسی را باز می‌کند.

گام 3: استفاده از base URL درست

بیشتر ابزارها سه مقدار می‌خواهند: کلید API، base URL و نام مدل. base URL را بر پایه پروتکلی که ابزار پشتیبانی می‌کند انتخاب کنید.

اگر مطمئن نیستید کلاینت شما کدام حالت را پشتیبانی می‌کند، با base URL سازگار با OpenAI شروع کنید. برای Claude Code یا کلاینتی که صریحاً endpoint سازگار با Anthropic Messages می‌خواهد، از base URL سازگار با Anthropic استفاده کنید.

گام 4: بررسی با یک فراخوانی مستقیم API

اگر فقط می‌خواهید مطمئن شوید کلیدتان کار می‌کند، Chat API را مستقیم صدا بزنید.

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"
  }'

پاسخ موفق شامل یک پاسخ، تحلیل پرسش و منابع وب است.

{
  "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: افزودن APIهای گردش‌کار

پس از آنکه نخستین ابزار یا فراخوانی API کار کرد، APIهایی را که با سناریوی شما همخوانی دارند وصل کنید.

نمونه‌های مستقیم API

اگر به‌جای پیکربندی یک ابزار هوش مصنوعی مستقیم روی API برنامه می‌سازید، با یکی از این فراخوانی‌های کمینه شروع کنید.

ساخت یک PPT Task

وقتی می‌خواهید مجموعه اسلاید را به‌صورت ناهمگام تولید کنید از PPT Task API استفاده کنید. پاسخ یک task_id برمی‌گرداند که می‌توانید وضعیت آن را پیوسته بپرسید.

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"
  }'

نمونه پاسخ:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
  }
}

وضعیت وظیفه را پیوسته بپرسید:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

ساخت یک Landing Page Task

وقتی می‌خواهید Felo از یک اعلان (prompt) یک صفحه فرود بسازد از Landing Page Task API استفاده کنید.

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"
  }'

نمونه پاسخ:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
  }
}

وضعیت را از همان endpoint وضعیت وظیفه‌ای که PPT taskها به کار می‌برند بپرسید:

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);

مشکلات رایج راه‌اندازی

گام‌های بعدی

• راه‌اندازی Codex
• راه‌اندازی Claude Code
• راهنمای احراز هویت
• مرجع LLM API
• مرجع Chat API
• مرجع SuperAgent API