LLM Responses Perplexity em tempo real
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
LLM Responses Perplexity em tempo real
Envia um user_prompt a um modelo Perplexity e retorna a resposta de forma síncrona. model_name deve vir de get_dataforseo_ai_perplexity_llm_responses_models — sonar, sonar-pro e sonar-reasoning-pro. web_search_country_iso_code delimita a busca, algo que os outros três fornecedores não oferecem. 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 saber quanto um prompt custou de fato. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.0163.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou 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)[]
- maxTipo: integer | null
_output _tokens número máximo de tokens na resposta da IA
campo opcional
valor mínimo:1
valor máximo:4096;
valor padrão:2048;
Observação: 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 básico do modelo for especificado, sua versão mais recente será definida por padrão;
você pode obter a lista de modelos LLM disponíveis fazendo uma requisição separada para o seguinte endpoint:https://api.dataforseo.com/v3/ai_optimization/perplexity/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 diversificada
valores mais baixos tornam a saída mais focada
valor mínimo:0
valor máximo:1.9
valor padrão:0.77 - 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.9 - 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: string | null
_search _country _iso _code código de país para localização da pesquisa na web
campo opcional
especifique o código ISO do país para obter resultados de pesquisa na web localizados
Observação: disponível apenas para modelos Perplexity Sonar
exemplo:US
- Tipo: object | null · Response36Afe1097B20_AiOptimizationPerplexityLlmResponsesLiveResponseInfo200
- 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_AiOptimizationPerplexityLlmResponsesLiveTaskInfo
- 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: object | 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- Tipo: object | null · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- Tipo: object · Response36Afe1097B20_MessageAiOptimizationLlmResponseElementItem
- typeDiscriminadorTipo: string | null
tipo de elemento
- sectionsTipo: array (object | null)[] | null
seções da cadeia de raciocínio
array de objetos que contém as seções da cadeia de raciocínio geradas pelo LLM- annotationsTipo: array (object | null)[] | null
array de referências usadas para gerar a resposta
é igual anullse o parâmetroweb_searchnão estiver definido comotrue
Observação:annotationspode retornar vazio mesmo quandoweb_searchétrue, pois a IA tentará recuperar informações da web, mas pode não encontrar resultados relevantes- directTipo: string | null
_url URL direta para a fonte citada
contém a URL da fonte original para a qual o redirecionamento do Vertex AI no campourlleva - endTipo: integer | null
_index fim da indexação da anotação
- startTipo: integer | null
_index início da indexação da anotação
- textTipo: string | null
texto da seção da cadeia de raciocínio
texto da seção da cadeia de raciocínio que resume o processo de pensamento do modelo - titleTipo: string | null
o nome de domínio ou título da fonte citada
- urlTipo: string | null
URL de redirecionamento para a fonte citada
contém um redirecionamento do Vertex AI que leva à fonte original
- textTipo: string | null
texto da seção da cadeia de raciocínio
texto da seção da cadeia de raciocínio que resume o processo de pensamento do modelo - 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 Integer numbers.
- webTipo: boolean | null
_search indica se a pesquisa na web foi usada
Observação: a pesquisa na web é ativada por padrão nos modelos Perplexity Sonar
- 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/perplexity/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,
"web_search_country_iso_code": "FR",
"model_name": "sonar",
"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": "[Max Depth Exceeded]",
"sections": "[Max Depth Exceeded]"
}
],
"fan_out_queries": null
}
]
}
]
}