# הגדרת משימות ‘LLM Responses Gemini’

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/gemini/llm_responses/task_post`

**Tags:** DataForSEO

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

### מראה תמחור

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

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

## Related links

- [נקודת הקצה Models](<https://docs.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models/>)
- [התמחור](<https://ai.google.dev/gemini-api/docs/pricing>)
- [מרכז העזרה](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "user_prompt": {
            "type": "string",
            "description": "<em>פרומפט למודל ה-AI</em><br><strong>שדה חובה</strong><br>השאלה או המשימה שברצונכם לשלוח למודל ה-AI;<br>אפשר לציין <strong>עד 500 תווים</strong> בשדה <code>user_prompt</code>"
          },
          "model_name": {
            "type": "string",
            "description": "<em>שם מודל ה-AI</em><br><strong>שדה חובה</strong><br><code>model_name</code >מורכב משם המודל בפועל ומשם הגרסה;<br>אם מציינים את שם המודל הבסיסי, תוגדר כברירת מחדל הגרסה העדכנית שלו;<br>לדוגמה, אם מציינים <code>gemini-1.5-pro</code>, יוגדר <code>gemini-1.5-pro-002</code> אוטומטית כ-<code>model_name</code>;<br>אפשר לקבל את רשימת מודלי LLM הזמינים על ידי שליחת בקשה נפרדת אל <code>https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models</code>"
          },
          "max_output_tokens": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>המספר המרבי של טוקנים בתגובת ה-AI</em><br>שדה אופציונלי<br>הערך המזערי: <code>1</code>;<br>הערך המרבי: <code>4096</code>;<br>ערך ברירת מחדל: <code>2048</code>;<br><strong>הערה:</strong> אם <code>web_search</code> מוגדר ל-<code>true</code> או שנבחר מודל reasoning בבקשה, מספר טוקני הפלט עשוי לחרוג מהמגבלה שצוינה ב-<code>max_output_tokens</code><br><strong>הערה 2:</strong> אם <code>use_reasoning</code> מוגדר ל-<code>true</code>, הערך המזערי של <code>max_output_tokens</code> הוא <code>1024</code>"
          },
          "temperature": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>אקראיות תגובת ה-AI</em><br>שדה אופציונלי<br>ערכים גבוהים יותר מגבירים את מגוון הפלט <br>ערכים נמוכים יותר הופכים את הפלט לממוקד יותר<br>הערך המזערי: <code>0</code><br>הערך המרבי: <code>2</code><br>ערך ברירת מחדל: <code>1.3</code>"
          },
          "top_p": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>מגוון תגובת ה-AI</em><br>שדה אופציונלי <br>שולט במגוון התגובה על ידי הגבלת בחירת הטוקנים<br>הערך המזערי: <code>0</code><br>הערך המרבי: <code>1</code> <br>ערך ברירת מחדל: <code>0.9</code>"
          },
          "web_search": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הפעלת חיפוש באינטרנט למידע עדכני</em><br>שדה אופציונלי<br>כשמופעל, מודל ה-AI יכול לגשת למידע עדכני מהאינטרנט ולצטט אותו;<br><strong>הערה:</strong> עיינו בנקודת הקצה Models כדי לראות רשימה של מודלים שתומכים ב-<code>web_search</code>; <br>ערך ברירת מחדל: <code>false</code>;<br>את עלות הפרמטר אפשר לחשב בעמוד התמחור"
          },
          "system_message": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>הנחיות להתנהגות ה-AI</em><br>שדה אופציונלי<br>מגדיר את התפקיד, הטון או ההתנהגות הספציפית של ה-AI <br>אפשר לציין <strong>עד 500 תווים</strong> בשדה <code>system_message</code>"
          },
          "message_chain": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ],
              "oneOf": [
                {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "התפקיד של המשתמש שממנו ההודעה מגיעה"
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "טקסט ההודעה"
                    }
                  }
                }
              ]
            },
            "description": "היסטוריית השיחה\nשדה אופציונלי\nמערך של אובייקטי הודעות שמייצגים תורות שיחה קודמים;\nכל אובייקט חייב להכיל:\nמחרוזת role עם הערך user או ai;\nמחרוזת message עם תוכן ההודעה (עד 500 תווים);\nאפשר לציין עד 10 אובייקטי הודעות במערך;\nהערה: במודלי Perplexity, ההודעות חייבות להתחלף בקפדנות בין התפקידים user ו-ai (user → ai);\nדוגמה:\n\"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?\"}]"
          },
          "use_reasoning": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>הפעלת reasoning עבור מודל ה-AI</em><br>שדה אופציונלי<br>כשמופעל, המודל יבצע reasoning לפני יצירת תגובה<br>עיינו בנקודת הקצה Models כדי לראות רשימה של מודלים שתומכים ב-<code>reasoning</code><br>ערך ברירת מחדל: <code>false</code><br><strong>הערה:</strong> אם מוגדר ל-<code>true</code>, הערך המזערי של <code>max_output_tokens</code> הוא <code>1024</code><br><strong>הערה 2:</strong> במודלי Gemini Pro, <code>use_reasoning</code> יוגדר אוטומטית ל-<code>true</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>מזהה משימה מוגדר על ידי המשתמש</em><br>שדה אופציונלי<br><em>מגבלת התווים היא 255</em><br>אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה<br>את ערך ה-<code>tag</code> שציינתם תמצאו באובייקט <code>data</code> של התגובה"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כתובת URL לשליחת תוצאות המשימה</em><br>שדה אופציונלי<br>כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט <code>gzip</code> אל ה-<code>postback_url</code> שציינתם<br>אפשר להשתמש במחרוזת ‘$id’ כמשתנה <code>$id</code> וב-‘$tag’ כמשתנה <code>$tag</code> מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.<br>דוגמה:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>הערה:</strong> תווים מיוחדים ב-<code>postback_url</code> יקודדו ב-urlencoded;<br>לדוגמה, התו <code>#</code> יקודד ל-<code>%23</code><p>מידע נוסף במרכז העזרה שלנו"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>כתובת URL להתראה על השלמת משימה</em><br>שדה אופציונלי<br>כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם<br>אפשר להשתמש במחרוזת ‘$id’ כמשתנה <code>$id</code> וב-‘$tag’ כמשתנה <code>$tag</code> מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה<br>דוגמה:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>הערה:</strong> תווים מיוחדים ב-<code>pingback_url</code> יקודדו ב-urlencoded;<br>לדוגמה, התו <code>#</code> יקודד ל-<code>%23</code><p>מידע נוסף במרכז העזרה שלנו"
          }
        },
        "example": [
          {
            "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?"
              }
            ],
            "model_name": "gemini-2.5-flash",
            "user_prompt": "provide information on how relevant the amusement park business is in France now"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "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?"
        }
      ],
      "model_name": "gemini-2.5-flash",
      "user_prompt": "provide information on how relevant the amusement park business is in France now"
    }
  ]
}
```

## Responses

### 200 — פעולה מוצלחת

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo"
    }
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>מערך משימות</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>מערך תוצאות</em><br>במקרה זה, הערך יהיה <code>null</code>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "הגרסה הנוכחית של ה-API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "קוד סטטוס כללי\nאת הרשימה המלאה של קודי התגובה אפשר למצוא כאן"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "הודעה אינפורמטיבית כללית\nאת הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "זמן ביצוע כולל, בשניות"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "סך עלות המשימות, בדולר ארה״ב",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר המשימות במערך tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר המשימות במערך tasks שהוחזרו עם שגיאה",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "מזהה משימה\nמזהה משימה ייחודי במערכת שלנו בפורמט UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "קוד הסטטוס של המשימה\nנוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000\nאת הרשימה המלאה של קודי התגובה אפשר למצוא כאן"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "הודעה אינפורמטיבית של המשימה\nאת הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "זמן ביצוע, בשניות"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "סך עלות המשימות, בדולר ארה״ב",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "מספר הפריטים במערך result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "נתיב URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "מכיל את אותם הפרמטרים שציינתם בבקשת POST"
    }
  }
}
```
