v0.2.0-beta

OpenAPI 3.1.0

Живі відповіді ChatGPT 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/chat_gpt/llm_responses/live

Живі відповіді ChatGPT LLM

Надсилає user_prompt моделі ChatGPT і синхронно повертає відповідь. model_name вибирає модель — див. get_dataforseo_ai_chat_gpt_llm_responses_models; незазначене в списку ім'я відхиляється одразу. max_output_tokens, temperature і top_p працюють так само, як у власному API постачальника, а web_search або force_web_search дозволяють моделі переглядати веб. Повертає 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. ⚠️ Це звичайний виклик LLM через постачальника даних, а не SEO-вимірювання. Якщо потрібно дізнатися, що ChatGPT каже користувачам про бренд, post_dataforseo_ai_chat_gpt_llm_scraper_live відтворює споживчий досвід.

Довідкові дані про ціни

Тарифікація: заявлена вартість відповіді.
Орієнтовна вартість запиту: USD 0.0695.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

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

Тіло

application/json

Тип: array (object | null)[]
- force_web_search
  Тип: boolean | null
  
  примусове використання вебпошуку AI-агентом
  необов'язкове поле
  щоб увімкнути цей параметр, також має бути ввімкнено web_search;
  коли ввімкнено, AI-модель змушена звертатися до актуальної інформації з інтернету та цитувати її;
  значення за замовчуванням: false;
  Примітка: навіть якщо параметр установлено в true, цитування веб-джерел у відповіді не гарантується
  Примітка #2: не підтримується в reasoning-моделях
- max_output_tokens
  Тип: integer | null
  
  максимальна кількість токенів у відповіді AI
  необов'язкове поле
  мінімальне значення для reasoning-моделей (наприклад, якщо reasoning має значення true в ендпоінті Models): 1024;
  мінімальне значення для звичайних моделей: 16;
  максимальне значення: 4096;
  значення за замовчуванням: 2048
  Примітка: якщо web_search установлено в true або в запиті вказано reasoning-модель, кількість вихідних токенів може перевищити заданий ліміт max_output_tokens
- 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 складається з фактичної назви моделі та назви версії;
  якщо вказано базову назву моделі, за замовчуванням буде використано її останню версію;
  наприклад, якщо вказано gpt-4.1, як model_name автоматично буде задано gpt-4.1-2025-04-14;
  список доступних LLM-моделей можна отримати окремим запитом до https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models
- system_message
  Тип: string | null
  
  інструкції для поведінки AI
  необов'язкове поле
  визначає роль, тон або конкретну поведінку AI
  у полі system_message можна вказати до 500 символів
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді
- temperature
  Тип: number | null
  
  ступінь випадковості відповіді AI
  необов'язкове поле
  вищі значення роблять вивід різноманітнішим;
  нижчі значення роблять вивід більш зосередженим;
  мінімальне значення: 0
  максимальне значення: 2
  значення за замовчуванням: 0.94
  Примітка: не підтримується в reasoning-моделях
- top_p
  Тип: number | null
  
  різноманітність відповіді AI
  необов'язкове поле
  керує різноманітністю відповіді, обмежуючи вибір токенів;
  мінімальне значення: 0
  максимальне значення: 1
  значення за замовчуванням: 0.92
  
  Примітка: top_p не можна використовувати разом з temperature в одному запиті
- user_prompt
  Тип: string
  
  промпт для AI-моделі
  обов'язкове поле
  питання або завдання, яке потрібно надіслати AI-моделі;
  у полі user_prompt можна вказати до 500 символів
- web_search
  Тип: boolean | null
  
  увімкнути вебпошук
  необов'язкове поле
  коли ввімкнено, AI-модель може звертатися до актуальної інформації з інтернету та цитувати її;
  значення за замовчуванням: false;
  Примітка: список моделей, які підтримують web_search, див. в ендпоінті Models;
- web_search_city
  Тип: string | null
  
  назва міста місцезнаходження
  необов'язкове поле
  Примітка: не підтримується в моделях o3-mini, o1-pro, o1
- web_search_country_iso_code
  Тип: string | null
  
  ISO-код країни місцезнаходження
  необов'язкове поле
  щоб увімкнути цей параметр, також має бути ввімкнено web_search;
  коли ввімкнено, AI-модель шукатиме в інтернеті з указаної вами країни;
  Примітка: не підтримується в моделях o3-mini, o1-pro, o1

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

Тип: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
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/chat_gpt/llm_responses/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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": "gpt-4.1-mini",
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "web_search_city": "Paris",
    "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
          ]
        }
      ]
    }
  ]
}

Успішна операція

Живі відповіді ChatGPT LLM

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

DataForSEO

Живі відповіді ChatGPT LLM

Довідкові дані про ціни