Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

תגובות Claude LLM חיות

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

תגובות Claude LLM חיות

​

שולח user_prompt למודל Claude ומחזיר את תגובתו באופן סינכרוני. model_name חייב לבוא מ-get_dataforseo_ai_claude_llm_responses_models — השמות נראים כמו claude-sonnet-5, וניחוש שנראה סביר נדחה. מחזיר model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items ו-fan_out_queries. קראו את money_spent בתגובה כדי לראות מה עלה בפועל הפרומפט. עטוף במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — בקשה שנדחתה עדיין מחזירה HTTP 200.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשה לעיון: 0.0567 דולר ארה״ב.
  • מכפיל לקוח לעיון: 1.0. אין להחיל בשנית את מכפילי העיון על סכומים שכבר נקבעו ללקוח.

מטא-נתוני עיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף
application/json
  • סוג: array (object | null)[]
    • force_web_search
      סוג: boolean | null

      אילוץ סוכן ה-AI להשתמש בחיפוש באינטרנט
      שדה אופציונלי
      כדי להפעיל את הפרמטר הזה, יש להפעיל גם את web_search;
      כשמופעל, מודל ה-AI מחויב לגשת למידע עדכני מהאינטרנט ולצטט אותו;
      ערך ברירת מחדל: false;
      הערה: גם אם הפרמטר מוגדר ל-true, אין ערובה שמקורות אינטרנט יצוטטו בתגובה

    • max_output_tokens
      סוג: integer | null

      המספר המרבי של טוקנים בתגובת ה-AI
      שדה אופציונלי
      הערך המזערי: 1;
      הערך המרבי: 4096;
      ערך ברירת מחדל: 2048;
      הערה: אם web_search מוגדר ל-true או שנבחר מודל reasoning בבקשה, מספר טוקני הפלט עשוי לחרוג מהמגבלה שצוינה ב-max_output_tokens
      הערה 2: אם use_reasoning מוגדר ל-true, הערך המזערי של max_output_tokens הוא 1025

    • message_chain
      סוג: array (object | null)[] | null

      היסטוריית השיחה שדה אופציונלי מערך של אובייקטי הודעות שמייצגים תורות שיחה קודמים; כל אובייקט חייב להכיל: מחרוזת role עם הערך user או ai; מחרוזת message עם תוכן ההודעה (עד 500 תווים); אפשר לציין עד 10 אובייקטי הודעות במערך; הערה: במודלי Perplexity, ההודעות חייבות להתחלף בקפדנות בין התפקידים user ו-ai (user → ai); דוגמה: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]

      • message
        סוג: string | null

        טקסט ההודעה

      • role
        סוג: string | null

        התפקיד של המשתמש שממנו ההודעה מגיעה

    • model_name
      סוג: string

      שם מודל ה-AI
      שדה חובה
      model_nameמורכב משם המודל בפועל ומשם הגרסה;
      אם מציינים את שם המודל הבסיסי, תוגדר כברירת מחדל הגרסה העדכנית שלו;
      לדוגמה, אם מציינים claude-opus-4-0, יוגדר claude-opus-4-20250514 אוטומטית כ-model_name;
      אפשר לקבל את רשימת מודלי LLM הזמינים על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models

    • system_message
      סוג: string | null

      הנחיות להתנהגות ה-AI
      שדה אופציונלי
      מגדיר את התפקיד, הטון או ההתנהגות הספציפית של ה-AI;
      אפשר לציין עד 500 תווים בשדה system_message

    • tag
      סוג: string | null

      מזהה משימה מוגדר על ידי המשתמש
      שדה אופציונלי
      מגבלת התווים היא 255
      אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
      את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

    • temperature
      סוג: number | null

      אקראיות תגובת ה-AI
      שדה אופציונלי
      ערכים גבוהים יותר מגבירים את מגוון הפלט;
      ערכים נמוכים יותר הופכים את הפלט לממוקד יותר;
      הערך המזערי: 0
      הערך המרבי: 1
      ערך ברירת מחדל: 0.7

      הערה: אי אפשר להשתמש ב-temperature יחד עם top_p באותה בקשה

    • top_p
      סוג: number | null

      מגוון תגובת ה-AI
      שדה אופציונלי
      שולט במגוון התגובה על ידי הגבלת בחירת הטוקנים;
      הערך המזערי: 0
      הערך המרבי: 1
      ערך ברירת מחדל: null

      הערה: אי אפשר להשתמש ב-top_p יחד עם temperature באותה בקשה

    • use_reasoning
      סוג: boolean | null

      הפעלת reasoning עבור מודל ה-AI
      שדה אופציונלי
      כשמופעל, המודל יבצע reasoning לפני יצירת תגובה
      עיינו בנקודת הקצה Models כדי לראות רשימה של מודלים שתומכים ב-reasoning
      ערך ברירת מחדל: false
      הערה: אם מוגדר ל-true, הערך המזערי של max_output_tokens הוא 1025
      הערה 2: אם מוגדר ל-true, יש להגדיר את force_web_search ל-false
      הערה 3: אם מוגדר ל-true, אי אפשר להשתמש ב-temperature וב-top_p

    • user_prompt
      סוג: string

      פרומפט למודל ה-AI
      שדה חובה
      השאלה או המשימה שברצונכם לשלוח למודל ה-AI;
      אפשר לציין עד 500 תווים בשדה user_prompt

    • web_search
      סוג: boolean | null

      הפעלת חיפוש באינטרנט למידע עדכני
      שדה אופציונלי
      כשמופעל, מודל ה-AI יכול לגשת למידע עדכני מהאינטרנט ולצטט אותו;
      הערה: עיינו בנקודת הקצה Models כדי לראות רשימה של מודלים שתומכים ב-web_search;
      ערך ברירת מחדל: false;
      את עלות הפרמטר אפשר לחשב בעמוד התמחור

    • web_search_city
      סוג: string | null

      שם העיר של המיקום שמשמש לחיפוש באינטרנט
      שדה אופציונלי

    • web_search_country_iso_code
      סוג: string | null

      קוד מדינה ISO של המיקום שמשמש לחיפוש באינטרנט
      שדה אופציונלי
      ערכים אפשריים: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
    • cost
      סוג: number | null פורמט: double

      סך עלות המשימות, בדולר ארה״ב

    • status_code
      סוג: integer | null

      קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • status_message
      סוג: string | null

      הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

    • tasks
      סוג: array (object | null)[] | null

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
        • cost
          סוג: number | null פורמט: double

          סך עלות המשימות, בדולר ארה״ב

        • data
          סוג: object | null

          מכיל את אותם הפרמטרים שציינתם בבקשת POST

          • propertyName
            סוג: object | null
        • id
          סוג: string | null

          מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

        • path
          סוג: array (string | null)[] | null

          נתיב URL

        • result
          סוג: array (object | null)[] | null

          מערך תוצאות

          • datetime
            סוג: string | null

            התאריך והשעה שבהם התוצאה התקבלה
            בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            דוגמה:
            2019-11-15 12:57:46 +00:00

          • fan_out_queries
            סוג: array (string | null)[] | null

            מערך של שאילתות הסתעפות
            מכיל שאילתות חיפוש קשורות הנגזרות מהשאילתה הראשית כדי לספק תגובה מקיפה יותר

          • input_tokens
            סוג: integer | null

            מספר הטוקנים בקלט
            סך הטוקנים שעובדו

          • items
            סוג: array (object | null)[] | null

            מערך של פריטי תגובה
            מכיל נתוני תגובת בינה מלאכותית מובנים

            • type
              סוג: string | null

              סוג הרכיב

          • model_name
            סוג: string | null

            שם מודל הבינה המלאכותית שבו נעשה שימוש

          • money_spent
            סוג: number | null

            עלות טוקני בינה מלאכותית, בדולר ארה"ב
            המחיר שגובה ספק מודל הבינה המלאכותית מצד שלישי בהתאם לתמחור שלו

          • output_tokens
            סוג: integer | null

            מספר הטוקנים בפלט
            סך הטוקנים שנוצרו בתגובת הבינה המלאכותית

          • reasoning_tokens
            סוג: integer | null

            מספר טוקני ההסקה
            סך הטוקנים ששימשו ליצירת תוכן ההסקה

          • web_search
            סוג: boolean | null

            מציין אם נעשה שימוש בחיפוש באינטרנט

        • result_count
          סוג: integer | null פורמט: int64

          מספר הפריטים במערך result

        • status_code
          סוג: integer | null

          קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

        • status_message
          סוג: string | null

          הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

        • time
          סוג: string | null

          זמן ביצוע, בשניות

    • tasks_count
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks

    • tasks_error
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks שהוחזרו עם שגיאה

    • time
      סוג: string | null

      זמן ביצוע כולל, בשניות

    • version
      סוג: string | null

      הגרסה הנוכחית של ה-API

    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/llm_responses/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "system_message": "communicate as if we are in a business meeting",
    "message_chain": [
      {
        "role": "user",
        "message": "Hello, what’s up?"
      },
      {
        "role": "ai",
        "message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
      }
    ],
    "max_output_tokens": 200,
    "model_name": "claude-opus-4-0",
    "temperature": 0.3,
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "model_name": null,
          "input_tokens": null,
          "output_tokens": null,
          "reasoning_tokens": null,
          "web_search": null,
          "money_spent": null,
          "datetime": null,
          "items": [
            {
              "type": null
            }
          ],
          "fan_out_queries": [
            null
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Live Claude LLM Responses