Respostas LLM do ChatGPT em tempo real
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Respostas LLM do ChatGPT em tempo real
Envia um user_prompt a um modelo ChatGPT e retorna a resposta de forma síncrona. model_name escolhe o modelo — consulte get_dataforseo_ai_chat_gpt_llm_responses_models, e um nome não listado é rejeitado de imediato. max_output_tokens, temperature e top_p se comportam como na API do próprio fornecedor, e web_search ou force_web_search permitem que ele navegue. Retorna model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items e fan_out_queries. Leia money_spent na resposta para ver quanto um prompt realmente custou. Embrulhado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. ⚠️ Esta é uma chamada LLM geral roteada por um provedor de dados, não uma medição de SEO. Se você quer saber o que o ChatGPT diz aos usuários sobre uma marca, post_dataforseo_ai_chat_gpt_llm_scraper_live reproduz a experiência do consumidor.
Pricing reference
- Medição: custo de resposta reportado.
- Estimativa de referência por requisição: USD 0.0695.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor já liquidado do cliente.
Apenas metadados de referência, não uma cotação da conta, um preço garantido nem um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array (object | null)[]
- forceTipo: boolean | null
_web _search força o agente de IA a usar a pesquisa na web
campo opcional
para habilitar este parâmetro,web_searchtambém precisa estar habilitado;
quando habilitado, o modelo de IA é forçado a acessar e citar informações atuais da web;
valor padrão:false;
Observação: mesmo que o parâmetro seja definido comotrue, não há garantia de que fontes da web sejam citadas na resposta
Observação nº 2: não suportado em modelos de raciocínio - maxTipo: integer | null
_output _tokens número máximo de tokens na resposta da IA
campo opcional
valor mínimo para modelos de raciocínio (por exemplo,reasoningétrueno endpoint Models):1024;
valor mínimo para modelos sem raciocínio:16;
valor máximo:4096;
valor padrão:2048
Observação: seweb_searchestiver definido comotrueou se o modelo de raciocínio for especificado na requisição, a contagem de tokens de saída pode exceder o limitemax_output_tokensespecificado - messageTipo: array (object | null)[] | null
_chain histórico da conversa campo opcional array de objetos de mensagem que representam turnos anteriores da conversa; cada objeto deve conter: role string com a função user ou ai; message string com o conteúdo da mensagem (máximo de 500 caracteres); você pode especificar no máximo 10 objetos de mensagem no array; Observação: para modelos Perplexity, as mensagens devem alternar estritamente entre as funções user e ai (user → ai); exemplo: "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?"}]
- messageTipo: string | null
texto da mensagem
- roleTipo: string | null
função do usuário que origina a mensagem
- modelTipo: string
_name nome do modelo de IA
campo obrigatóriomodel_nameconsiste no nome real do modelo e no nome da versão;
se o nome do modelo básico for especificado, sua versão mais recente será definida por padrão;
por exemplo, segpt-4.1for especificado,gpt-4.1-2025-04-14será definido automaticamente comomodel_name;
você pode obter a lista de modelos LLM disponíveis fazendo uma requisição separada parahttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models - systemTipo: string | null
_message instruções para o comportamento da IA
campo opcional
define a função, o tom ou o comportamento específico da IA
você pode especificar até 500 caracteres no camposystem_message - tagTipo: string | null
identificador de tarefa definido pelo usuário
campo opcional
o limite de caracteres é 255
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor detagespecificado no objetodatada resposta - temperatureTipo: number | null
aleatoriedade da resposta da IA
campo opcional
valores mais altos tornam a saída mais diversa;
valores mais baixos tornam a saída mais focada;
valor mínimo:0
valor máximo:2
valor padrão:0.94
Observação: não suportado em modelos de raciocínio - topTipo: number | null
_p diversidade da resposta da IA
campo opcional
controla a diversidade da resposta limitando a seleção de tokens;
valor mínimo:0
valor máximo:1
valor padrão:0.92Observação:
top_pnão pode ser usado junto comtemperaturena mesma requisição - userTipo: string
_prompt prompt para o modelo de IA
campo obrigatório
a pergunta ou tarefa que você deseja enviar ao modelo de IA;
você pode especificar até 500 caracteres no campouser_prompt - webTipo: boolean | null
_search - webTipo: string | null
_search _city nome da cidade do local
campo opcional
Observação: não suportado nos modeloso3-mini,o1-pro,o1 - webTipo: string | null
_search _country _iso _code código ISO do país do local
campo opcional
para habilitar este parâmetro,web_searchtambém precisa estar habilitado;
quando habilitado, o modelo de IA pesquisará na web a partir do país que você especificar;
Observação: não suportado nos modeloso3-mini,o1-pro,o1
- Tipo: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- datetimeTipo: string | null
data e hora em que o resultado foi recebido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - fanTipo: array (string | null)[] | null
_out _queries array de consultas de fan-out
contém consultas de pesquisa relacionadas derivadas da consulta principal para fornecer uma resposta mais abrangente - inputTipo: integer | null
_tokens número de tokens na entrada
contagem total de tokens processados - itemsTipo: array (object | null)[] | null
array de itens de resposta
contém dados estruturados de resposta da IA- typeTipo: string | null
tipo de elemento
- modelTipo: string | null
_name nome do modelo de IA usado
- moneyTipo: number | null
_spent - outputTipo: integer | null
_tokens número de tokens na saída
contagem total de tokens gerados na resposta da IA - reasoningTipo: integer | null
_tokens número de tokens de raciocínio
contagem total de tokens usados para gerar o conteúdo de raciocínio - webTipo: boolean | null
_search indica se a pesquisa na web foi usada
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
a versão atual da API
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
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
]
}
]
}
]
}