v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות LLM Responses של Claude

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

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

DataForSEO פעולות

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post

הגדרת משימות LLM Responses של Claude

מכניס פרומפט של Claude לתור במקום להמתין, ומחזיר id של משימה. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. בדקו תחילה את task_post_supported ב-get_dataforseo_ai_claude_llm_responses_models, ואחזרו באמצעות get_dataforseo_ai_claude_llm_responses_fetch.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת ייחוס: 0.701 דולר ארה״ב.
מכפיל לקוח לייחוס: 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
- pingback_url
  סוג: string | null
  
  כתובת URL להתראה על השלמת משימה
  שדה אופציונלי
  כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה
  דוגמה:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- postback_url
  סוג: string | null
  
  כתובת URL לשליחת תוצאות המשימה
  שדה אופציונלי
  כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל ה-postback_url שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  דוגמה:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- 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_AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
cost
סוג: number | null פורמט: double

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

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

data
סוג: object | null

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

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

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

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

נתיב URL

result
סוג: object | null

מערך תוצאות
במקרה זה, הערך יהיה 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

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/llm_responses/task_post \
  --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": 1024,
    "temperature": 0.3,
    "web_search_country_iso_code": "FR",
    "model_name": "claude-sonnet-4-0",
    "web_search": true,
    "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": null
    }
  ]
}

פעולה מוצלחת

הגדרת משימות LLM Responses של Claude

אימותRequired

DataForSEO

הגדרת משימות LLM Responses של Claude

מראה תמחור