آغاز

Felo API Platform آپ کو ایجنٹ ٹولز، ماڈل پروٹوکولز، Search، Web Fetch، PPT، Mindmap، LiveDocs، X Search، YouTube Subtitling، Landing Page اور SuperAgent APIs کے لیے ایک ہی کلید دیتا ہے۔ یہیں سے شروع کریں، اپنا استعمال کردہ ٹول منتخب کریں، پھر اُس ٹول کی مخصوص سیٹ اپ گائیڈ کی پیروی کریں۔

پہلی بار آئے ہیں؟ Platform کا جائزہ پڑھیں تاکہ سمجھ سکیں کہ Model API، Data API اور Felo APIs کیسے باہم جڑتے ہیں، یا سیدھا پروٹوکولز اور SDKs اور چینلز اور فراہم کنندہ روٹنگ پر جائیں۔

CLI کے ذریعے Codex یا Claude Code کنفیگر کریں

Node.js 22+ اور اپنا AI ٹول انسٹال ہونے کے بعد یہ چلائیں:

npx feloapi-cli setup

ہدایات پر عمل کرتے ہوئے اپنی مکمل Felo API کلید پیسٹ کریں اور ماڈلز، Skills یا دونوں منتخب کریں۔ پھر اپنا ٹول npx feloapi-cli run codex یا npx feloapi-cli run claude-code سے شروع کریں۔

CLI کی تنصیب اور استعمال

فوری آغاز کا بہاؤ

1. Felo API Platform کی کلید حاصل کریں اور ضرورت پڑنے پر سروس کریڈٹ خریدیں؛ کسی سبسکرپشن کی ضرورت نہیں۔
2. نیچے دیے گئے جدول سے اپنا AI ٹول یا پلیٹ فارم منتخب کریں۔
3. متعلقہ سیٹ اپ گائیڈ کھولیں اور Felo base URL اور API کلید پیسٹ کریں۔
4. تصدیق کے لیے اُس ٹول میں کوئی چھوٹا کام چلائیں۔
5. جب آپ کے ایجنٹ کو سرچ، آفس آؤٹ پٹ، ویب ایکسٹریکشن، تصویری ورک فلوز، LiveDocs یا SuperAgent درکار ہو تو متعلقہ ورک فلو APIs شامل کریں۔

مرحلہ 1: اپنی API کلید حاصل کریں

Felo API Platform براہ راست API کالز اور معاون AI ٹولز میں ایک ہی API کلید استعمال کرتا ہے۔

1. Felo API Platform API Keys صفحہ کھولیں۔
2. اگر کہا جائے تو اپنے Felo اکاؤنٹ سے سائن اِن کریں۔
3. کلید کا نام درج کریں اور Create Key پر کلک کریں۔
4. کلید ظاہر ہونے پر مکمل کاپی کریں۔ یہ صرف ایک بار دکھائی جاتی ہے۔
5. کلید کو محفوظ طریقے سے رکھیں اور FELO_API_KEY کے طور پر استعمال کریں۔

Console Billing میں $1 سے شروع کر کے جتنی ضرورت ہو ٹاپ اپ کریں۔ آپ اصل API استعمال کے لیے USD میں سروس کریڈٹ خریدتے ہیں۔ کسی سبسکرپشن کی ضرورت نہیں۔

کلید کو environment variable کے طور پر سیٹ کریں:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

مرحلہ 2: اپنا AI ٹول منتخب کریں

جس ٹول کو استعمال کرنا چاہتے ہیں اُس پر کلک کریں۔ ہر لنک ایک مخصوص سیٹ اپ گائیڈ کھولتا ہے جس میں درست base URL، environment variables اور تصدیق کا مرحلہ موجود ہے۔

مرحلہ 3: درست base URL استعمال کریں

زیادہ تر ٹولز تین ویلیوز طلب کرتے ہیں: API کلید، base URL اور ماڈل کا نام۔ base URL اُس پروٹوکول کی بنیاد پر منتخب کریں جس کی ٹول معاونت کرتا ہے۔

اگر آپ کو یقین نہ ہو کہ آپ کا کلائنٹ کون سا موڈ معاونت کرتا ہے تو OpenAI-compatible base URL سے آغاز کریں۔ Claude Code یا اُن کلائنٹس کے لیے Anthropic-compatible base URL استعمال کریں جو واضح طور پر Anthropic Messages endpoint طلب کرتے ہیں۔

مرحلہ 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"
  }'

کامیاب جواب میں ایک answer، query analysis اور web resources شامل ہوتے ہیں۔

{
  "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: ورک فلو APIs شامل کریں

آپ کے پہلے ٹول یا API کال کے کامیاب ہونے کے بعد اُن APIs کو جوڑیں جو آپ کے منظر نامے سے مطابقت رکھتے ہوں۔

براہ راست API کی مثالیں

اگر آپ AI ٹول کنفیگر کرنے کے بجائے براہ راست API کے خلاف تعمیر کر رہے ہیں تو اِن میں سے کسی کم سے کم کال سے آغاز کریں۔

PPT ٹاسک بنائیں

جب آپ غیر ہم وقت (asynchronously) سلائیڈ ڈیک بنانا چاہیں تو 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"

لینڈنگ پیج ٹاسک بنائیں

جب آپ چاہتے ہیں کہ Felo کسی پرامپٹ سے لینڈنگ پیج بنائے تو 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 ٹاسکس استعمال کرتے ہیں:

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 ریفرنس