התחלה
התחלה
קבלו מפתח API אחד, בחרו כלי AI, פתחו את מדריך ההגדרה שלו והריצו את קריאת ה-API הראשונה בתהליך העבודה שלכם.
Felo API Platform נותנת לכם מפתח אחד עבור כלי סוכנים, פרוטוקולי מודלים, וממשקי Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page ו-SuperAgent. התחילו כאן, בחרו את הכלי שבו אתם משתמשים, ואז עקבו אחרי מדריך ההגדרה הייעודי של אותו כלי.
חדשים כאן? קראו את סקירת הפלטפורמה כדי להבין איך Model API, Data API וממשקי Felo משתלבים, או עברו ישר לפרוטוקולים ו-SDKs ולערוצים וניתוב ספקים.
הגדרת Codex או Claude Code באמצעות ה-CLI
כשיש לכם Node.js 22+ ואת כלי ה-AI מותקן, הריצו:
npx feloapi-cli setupעקבו אחרי ההנחיות כדי להדביק את מפתח ה-API המלא של Felo ולבחור מודלים, Skills או שניהם. לאחר מכן הפעילו את הכלי עם npx feloapi-cli run codex או npx feloapi-cli run claude-code.
זרימת התחלה מהירה
- השיגו מפתח של Felo API Platform וטענו קרדיטים לשירות כשצריך; אין צורך במינוי.
- בחרו את כלי ה-AI או הפלטפורמה שלכם מהטבלה שלמטה.
- פתחו את מדריך ההגדרה המתאים והדביקו את כתובת הבסיס של Felo ואת מפתח ה-API.
- הריצו משימה קטנה בכלי כדי לאשר את החיבור.
- הוסיפו ממשקי workflow כשהסוכן שלכם זקוק לחיפוש, פלט משרד, חילוץ מהאינטרנט, תהליכי תמונות, LiveDocs או SuperAgent.
שלב 1: השגת מפתח ה-API
Felo API Platform משתמשת במפתח API אחד בקריאות API ישירות ובכלי AI נתמכים.
- פתחו את עמוד מפתחות ה-API של Felo API Platform.
- התחברו עם חשבון Felo אם מתבקשים.
- הזינו שם מפתח ולחצו על Create Key.
- העתיקו את המפתח המלא כשהוא מופיע. הוא מוצג פעם אחת בלבד.
- אחסנו את המפתח באופן בטוח והשתמשו בו כ-
FELO_API_KEY.
טענו לפי הצורך ב-Console Billing החל מ-$1. אתם רוכשים קרדיטים לשירות נקובים בדולר עבור שימוש בפועל ב-API. אין צורך במינוי.
הגדירו את המפתח כמשתנה סביבה:
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell:
$env:FELO_API_KEY="YOUR_API_KEY"שלב 2: בחירת כלי ה-AI
לחצו על הכלי שבו אתם רוצים להשתמש. כל קישור פותח מדריך הגדרה ייעודי עם כתובת הבסיס הנכונה, משתני הסביבה ושלב האימות.
| כלי | מתאים במיוחד ל | מדריך הגדרה |
|---|---|---|
| Codex | תהליכי קידוד ב-CLI, סקירת קוד, שינויים במאגר ואוטומציה | הגדרת Codex |
| Claude Code | קידוד עם סוכנים, עריכת מאגרים, פיתוח בעזרת מחקר ועבודה עם הקשר ארוך | הגדרת Claude Code |
| OpenCode | הפעלות קידוד בטרמינל וניתוב ספקים תואמי OpenAI | הגדרת OpenCode |
| OpenClaw | תהליכי עוזר AI אישי וסוכנים מקומיים | הגדרת OpenClaw |
| Hermes Agent | ניסויי סוכנים ותזמור רב-כלי | הגדרת Hermes Agent |
| TRAE | תהליכי AI IDE ועריכה בעזרה | הגדרת TRAE |
| OpenViking | ניסויי סוכנים והחלפת ספקים | הגדרת OpenViking |
| Cursor | קידוד AI בתוך עורך | הגדרת Cursor |
| Cline | תהליכי סוכנים ב-VS Code וקידוד בעזרת הטרמינל | הגדרת Cline |
| Roo Code | סוכני קידוד ב-VS Code ותכנון משימות | הגדרת Roo Code |
| Kilo Code | סוכני קידוד מקומיים ובדיקת ספקי מודלים | הגדרת Kilo Code |
| כלי AI אחרים | כל לקוח שמקבל מפתח API מותאם, כתובת בסיס ושם מודל | הגדרת כלים אחרים |
שלב 3: שימוש בכתובת הבסיס הנכונה
רוב הכלים מבקשים שלושה ערכים: מפתח API, כתובת בסיס ושם מודל. בחרו את כתובת הבסיס לפי הפרוטוקול שהכלי תומך בו.
| הכלי מבקש | השתמשו בערך הזה |
|---|---|
| מפתח API | ה-FELO_API_KEY שלכם |
| כתובת בסיס תואמת OpenAI | https://openapi.felo.ai/api/v1 |
| כתובת בסיס תואמת Anthropic | https://openapi.felo.ai/api |
| מזהה מודל | בחרו מזהה זמין כעת מתוך קטלוג המודלים |
אם אינכם בטוחים איזה מצב הלקוח שלכם תומך בו, התחילו עם כתובת הבסיס התואמת OpenAI. השתמשו בכתובת הבסיס התואמת Anthropic עבור Claude Code או לקוחות שמבקשים במפורש endpoint של Anthropic Messages.
שלב 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: הוספת ממשקי workflow
לאחר שהכלי או קריאת ה-API הראשונים שלכם עובדים, חברו את ממשקי ה-API שמתאימים לתרחיש שלכם.
| תרחיש | ממשקי API מומלצים | תיעוד |
|---|---|---|
| סוכן חיפוש ומחקר | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| סוכן פרודוקטיביות משרדית | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| סוכן תפעול יצירתי | Landing Page, תהליכי תמונות, Web Fetch, Search, SuperAgent | Landing Page API |
| אפליקציית AI full-stack | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| תהליך ידע | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
דוגמאות ישירות ל-API
אם אתם בונים ישירות מול ה-API במקום להגדיר כלי AI, התחילו באחת מהקריאות המינימליות האלה.
יצירת משימת PPT
השתמשו ב-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
השתמשו ב-Landing Page Task API כשרוצים ש-Felo תיצור דף נחיתה מתוך פרומפט.
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"
}
}בדקו שוב ושוב את אותה נקודת קצה של מצב המשימה שמשתמשים בה משימות 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);בעיות הגדרה נפוצות
| בעיה | מה לבדוק |
|---|---|
UNAUTHORIZED | ודאו שהמפתח הועתק נכון, לא בוטל, ונשלח כ-Authorization: Bearer $FELO_API_KEY |
| הכלי קורא לספק הלא נכון | בדקו שספק Felo נבחר בסביבת העבודה או בהפעלה הנוכחית |
| לקוח תואם OpenAI נכשל | השתמשו ב-https://openapi.felo.ai/api/v1 ככתובת הבסיס |
| לקוח תואם Anthropic נכשל | השתמשו ב-https://openapi.felo.ai/api ככתובת הבסיס |
| למשימה אסינכרונית אין עדיין תוצאה | בדקו שוב ושוב את נקודת הקצה של מצב המשימה עד שהמשימה תושלם |