v0.2.0-beta

OpenAPI 3.1.0

Configurer des tâches ‘LLM Responses ChatGPT’

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

post/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post

Configurer des tâches ‘LLM Responses ChatGPT’

Met un prompt ChatGPT en file d'attente au lieu d'attendre la réponse, et renvoie un id de tâche. Ajoute system_message et message_chain par rapport au point de terminaison en direct, de sorte qu'une conversation multi-tours peut être envoyée en une seule tâche. Encapsulé dans l'enveloppe DataForSEO : les données dans tasks[0].result, le résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. ⚠️ Tous les modèles ne prennent pas en charge la mise en file d'attente — vérifiez task_post_supported dans get_dataforseo_ai_chat_gpt_llm_responses_models. Récupérez avec get_dataforseo_ai_chat_gpt_llm_responses_fetch.

Pricing reference

Comptage : coût de réponse déclaré.
Estimation de référence par requête : USD 0.701.
Multiplicateur de référence du client : 1.0. Ne pas l'appliquer une nouvelle fois à un montant client déjà réglé.

Métadonnées de référence uniquement : ni devis de compte, ni prix garanti, ni plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Corps

application/json

Type: array (object | null)[]
- force_web_search
  Type: boolean | null
  
  forcer l'agent IA à utiliser la recherche web
  champ facultatif
  pour activer ce paramètre, web_search doit également être activé ;
  lorsqu'il est activé, le modèle IA est forcé d'accéder aux informations web actuelles et de les citer ;
  valeur par défaut : false ;
  Remarque : même si le paramètre est défini sur true, rien ne garantit que des sources web seront citées dans la réponse
  Remarque n° 2 : non pris en charge par les modèles de raisonnement
- max_output_tokens
  Type: integer | null
  
  nombre maximal de tokens dans la réponse de l'IA
  champ facultatif
  valeur minimale pour les modèles de raisonnement (par ex., reasoning vaut true dans le point de terminaison Models) : 1024 ;
  valeur minimale pour les modèles sans raisonnement : 16 ;
  valeur maximale : 4096 ;
  valeur par défaut : 2048
- message_chain
  Type: array (object | null)[] | null
  
  historique de la conversation champ facultatif tableau d'objets de message représentant les tours de conversation précédents ; chaque objet doit contenir : role, chaîne avec le rôle user ou ai ; message, chaîne contenant le contenu du message (500 caractères maximum) ; vous pouvez spécifier au maximum 10 objets de message dans le tableau ; Remarque : pour les modèles Perplexity, les messages doivent alterner strictement entre les rôles user et ai (user → ai) ; exemple : "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
  Type: string | null
  
  texte du message
  
  role
  Type: string | null
  
  rôle de l'utilisateur à l'origine du message
- model_name
  Type: string
  
  nom du modèle IA
  champ obligatoire
  model_namese compose du nom réel du modèle et du nom de version ;
  si le nom de modèle de base est spécifié, sa dernière version sera définie par défaut ;
  par exemple, si gpt-4.1 est spécifié, gpt-4.1-2025-04-14 sera automatiquement défini comme model_name ;
  vous pouvez obtenir la liste des modèles LLM disponibles en effectuant une requête distincte sur https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models
- pingback_url
  Type: string | null
  
  URL de notification d'une tâche terminée
  champ facultatif
  lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête
  exemple :
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ;
  notamment, le caractère # sera encodé en %23
  
  en savoir plus dans notre centre d'aide
- postback_url
  Type: string | null
  
  URL d'envoi des résultats de la tâche
  champ facultatif
  une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au format gzip à l'adresse postback_url que vous avez spécifiée
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
  exemple :
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Remarque : les caractères spéciaux de postback_url seront encodés pour URL ;
  notamment, le caractère # sera encodé en %23
  
  en savoir plus dans notre centre d'aide
- system_message
  Type: string | null
  
  instructions pour le comportement de l'IA
  champ facultatif
  définit le rôle, le ton ou le comportement spécifique de l'IA ;
  vous pouvez spécifier jusqu'à 500 caractères dans le champ system_message
- tag
  Type: string | null
  
  identifiant de tâche défini par l'utilisateur
  champ facultatif
  la limite est de 255 caractères
  vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
  vous trouverez la valeur tag spécifiée dans le tableau data de la réponse
- temperature
  Type: number | null
  
  caractère aléatoire de la réponse de l'IA
  champ facultatif
  des valeurs plus élevées rendent la sortie plus variée ;
  des valeurs plus faibles rendent la sortie plus ciblée ;
  valeur minimale : 0
  valeur maximale : 2
  valeur par défaut : 0.94
  Remarque : non pris en charge par les modèles de raisonnement
- top_p
  Type: number | null
  
  diversité de la réponse de l'IA
  champ facultatif
  contrôle la diversité de la réponse en limitant la sélection des tokens ;
  valeur minimale : 0
  valeur maximale : 1
  valeur par défaut : 0.92
  
  Remarque : top_p ne peut pas être utilisé avec temperature dans la même requête
- user_prompt
  Type: string
  
  prompt pour le modèle IA
  champ obligatoire
  la question ou la tâche que vous souhaitez envoyer au modèle IA ;
  vous pouvez spécifier jusqu'à 500 caractères dans le champ user_prompt
- web_search
  Type: boolean | null
  
  activer la recherche web
  champ facultatif
  lorsqu'elle est activée, le modèle IA peut accéder aux informations web actuelles et les citer ;
  valeur par défaut : false ;
  Remarque : consultez le point de terminaison Models pour obtenir la liste des modèles compatibles avec web_search ;
- web_search_city
  Type: string | null
  
  nom de la ville de l'emplacement
  champ facultatif
  Remarque : non pris en charge par les modèles o3-mini, o1-pro, o1
- web_search_country_iso_code
  Type: string | null
  
  code pays ISO de l'emplacement
  champ facultatif
  pour activer ce paramètre, web_search doit également être activé ;
  lorsqu'il est activé, le modèle IA effectuera la recherche web depuis le pays que vous spécifiez ;
  Remarque : non pris en charge par les modèles o3-mini, o1-pro, o1

Réponses

200
Type: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostResponseInfo
cost
Type: number | null Format: double

coût total des tâches, USD

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

tasks
Type: array (object | null)[] | null

tableau de tâches

Type: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
cost
Type: number | null Format: double

coût total des tâches, USD

data
Type: object | null

contient les mêmes paramètres que ceux spécifiés dans la requête POST

propertyName
Type: object | null
id
Type: string | null

identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

path
Type: array (string | null)[] | null

chemin de l'URL

result
Type: object | null

tableau de résultats
dans ce cas, la valeur sera null

result_count
Type: integer | null Format: int64

nombre d'éléments dans le tableau de résultats

status_code
Type: integer | null

code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

time
Type: string | null

temps d'exécution, en secondes

tasks_count
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches

tasks_error
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

time
Type: string | null

temps d'exécution total, en secondes

version
Type: string | null

la version actuelle de l'API
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

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"
  }
]'

Afficher le schéma

{
  "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
    }
  ]
}

Opération réussie

Configurer des tâches ‘LLM Responses ChatGPT’

AuthentificationRequired

DataForSEO

Configurer des tâches ‘LLM Responses ChatGPT’

Pricing reference