v0.2.0-beta

OpenAPI 3.1.0

Налаштування завдань «LLM Responses Gemini»

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/gemini/llm_responses/task_post

Налаштування завдань «LLM Responses Gemini»

Ставить промпт 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 USD.
Довідковий коефіцієнт клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не пропозиція для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — не кредити Felo. Остаточні списання визначаються записами білінгу Felo.

Тіло

application/json

Тип: array (object | null)[]
- max_output_tokens
  Тип: integer | null
  
  максимальна кількість токенів у відповіді AI
  необов'язкове поле
  мінімальне значення: 1;
  максимальне значення: 4096;
  значення за замовчуванням: 2048;
  Примітка: якщо web_search установлено в true або в запиті вказано reasoning-модель, кількість вихідних токенів може перевищити заданий ліміт max_output_tokens
  Примітка #2: якщо use_reasoning установлено в true, мінімальне значення для max_output_tokens — 1024
- 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 складається з фактичної назви моделі та назви версії;
  якщо вказано базову назву моделі, за замовчуванням буде використано її останню версію;
  наприклад, якщо вказано gemini-1.5-pro, як model_name автоматично буде задано gemini-1.5-pro-002;
  список доступних LLM-моделей можна отримати окремим запитом до https://api.dataforseo.com/v3/ai_optimization/gemini/llm_responses/models
- pingback_url
  Тип: string | null
  
  URL сповіщення про завершення завдання
  необов'язкове поле
  коли завдання буде виконано, ми надішлемо GET-запит на вказаний вами URL
  рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення
  приклад:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Примітка: спеціальні символи в pingback_url буде urlencoded;
  зокрема, символ # кодується як %23
  
  Докладніше див. в Help Center
- postback_url
  Тип: string | null
  
  URL для надсилання результатів завдання
  необов'язкове поле
  коли завдання буде виконано, ми надішлемо POST-запит з результатами, стиснутими у форматі gzip, на вказаний вами postback_url
  рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення.
  приклад:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Примітка: спеціальні символи в postback_url буде urlencoded;
  зокрема, символ # кодується як %23
  
  Докладніше див. в Help Center
- system_message
  Тип: string | null
  
  інструкції для поведінки AI
  необов'язкове поле
  визначає роль, тон або конкретну поведінку AI
  у полі system_message можна вказати до 500 символів
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді
- temperature
  Тип: number | null
  
  ступінь випадковості відповіді AI
  необов'язкове поле
  вищі значення роблять вивід різноманітнішим
  нижчі значення роблять вивід більш зосередженим
  мінімальне значення: 0
  максимальне значення: 2
  значення за замовчуванням: 1.3
- top_p
  Тип: number | null
  
  різноманітність відповіді AI
  необов'язкове поле
  керує різноманітністю відповіді, обмежуючи вибір токенів
  мінімальне значення: 0
  максимальне значення: 1
  значення за замовчуванням: 0.9
- use_reasoning
  Тип: boolean | null
  
  увімкнути міркування для AI-моделі
  необов'язкове поле
  коли ввімкнено, модель виконує міркування перед генерацією відповіді
  список моделей, які підтримують reasoning, див. в ендпоінті Models
  значення за замовчуванням: false
  Примітка: якщо встановлено true, мінімальне значення для max_output_tokens — 1024
  Примітка #2: для моделей Gemini Pro параметр use_reasoning автоматично встановлюється в true
- user_prompt
  Тип: string
  
  промпт для AI-моделі
  обов'язкове поле
  питання або завдання, яке потрібно надіслати AI-моделі;
  у полі user_prompt можна вказати до 500 символів
- web_search
  Тип: boolean | null
  
  увімкнути вебпошук для отримання актуальної інформації
  необов'язкове поле
  коли ввімкнено, AI-модель може звертатися до актуальної інформації з інтернету та цитувати її;
  Примітка: список моделей, які підтримують web_search, див. в ендпоінті Models;
  значення за замовчуванням: false;
  вартість параметра можна розрахувати на сторінці тарифів

Відповіді

200
Тип: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_AiOptimizationGeminiLlmResponsesTaskPostTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

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/gemini/llm_responses/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/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?"
      }
    ],
    "model_name": "gemini-2.5-flash",
    "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 Gemini»

АвтентифікаціяRequired

DataForSEO

Налаштування завдань «LLM Responses Gemini»

Довідкова інформація про ціну