v0.2.0-beta

OpenAPI 3.1.0

Постановка завдань ‘LLM Responses ChatGPT’

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

Постановка завдань ‘LLM Responses ChatGPT’

Ставить промпт ChatGPT у чергу замість очікування відповіді та повертає id завдання. Порівняно з ендпоінтом реального часу додає system_message і message_chain, тому багатокроковий діалог можна надіслати одним завданням. Обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. ⚠️ Не всі моделі підтримують чергу — перевірте task_post_supported у get_dataforseo_ai_chat_gpt_llm_responses_models. Отримуйте через get_dataforseo_ai_chat_gpt_llm_responses_fetch.

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

Тарифікація: заявлена вартість відповіді.
Орієнтовна вартість запиту: USD 0.701.
Довідковий множник для клієнта: 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
- 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
- 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
  значення за замовчуванням: 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_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo
cost
Тип: number | null Формат: double

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/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": "gpt-4.1-mini",
    "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 ChatGPT’

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

DataForSEO

Постановка завдань ‘LLM Responses ChatGPT’

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