v0.2.0-beta

OpenAPI 3.1.0

Live-відповіді Gemini LLM

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/live

Live-відповіді Gemini LLM

Синхронно надсилає user_prompt моделі Gemini і повертає її відповідь. model_name має бути взятий з get_dataforseo_ai_gemini_llm_responses_models. На відміну від live-ендпоінтів Claude і ChatGPT, тут приймається system_message. Повертає 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.0707 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
- 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_AiOptimizationGeminiLlmResponsesLiveResponseInfo
cost
Тип: number | null Формат: double

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

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

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

масив fan-out запитів
містить пов'язані пошукові запити, похідні від основного запиту, для повнішої відповіді

input_tokens
Тип: integer | null

кількість токенів у вхідних даних
загальна кількість оброблених токенів

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

масив елементів відповіді
містить структуровані дані відповіді AI

type
Тип: string | null

тип елемента

model_name
Тип: string | null

назва використовуваної AI-моделі

money_spent
Тип: number | null

вартість AI-токенів, USD
ціна, яку сторонній постачальник AI-моделі стягує згідно зі своїми тарифами

output_tokens
Тип: integer | null

кількість токенів у вихідних даних
загальна кількість токенів, згенерованих у відповіді AI

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

post/v1/beta/dataforseo/ai_optimization/gemini/llm_responses/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/gemini/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,
    "temperature": 0.3,
    "top_p": 0.5,
    "model_name": "gemini-2.5-flash",
    "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": [
        {
          "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-відповіді Gemini LLM

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

DataForSEO

Live-відповіді Gemini LLM

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