v0.2.0-beta

OpenAPI 3.1.0

Respostas LLM do Claude em tempo real

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

DataForSEO

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

DataForSEO Operações

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/live

Respostas LLM do Claude em tempo real

Envia um user_prompt a um modelo Claude e retorna a resposta de forma síncrona. model_name deve vir de get_dataforseo_ai_claude_llm_responses_models — os nomes são como claude-sonnet-5, e um palpite plausível é rejeitado. 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.

Pricing reference

Medição: custo de resposta reportado.
Estimativa de referência por requisição: USD 0.0567.
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.

Corpo

application/json

Tipo: array (object | null)[]
- force_web_search
  Tipo: boolean | null
  
  força o agente de IA a usar a pesquisa na web
  campo opcional
  para habilitar este parâmetro, web_search també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 como true, não há garantia de que fontes da web sejam citadas na resposta
- max_output_tokens
  Tipo: integer | null
  
  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 web_search estiver definido como true ou se o modelo de raciocínio for especificado na requisição, a contagem de tokens de saída pode exceder o limite max_output_tokens especificado
  Observação nº 2: se use_reasoning estiver definido como true, o valor mínimo para max_output_tokens é 1025
- message_chain
  Tipo: array (object | null)[] | null
  
  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?"}]
  
  message
  Tipo: string | null
  
  texto da mensagem
  
  role
  Tipo: string | null
  
  função do usuário que origina a mensagem
- model_name
  Tipo: string
  
  nome do modelo de IA
  campo obrigatório
  model_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, se claude-opus-4-0 for especificado, claude-opus-4-20250514 será definido automaticamente como model_name;
  você pode obter a lista de modelos LLM disponíveis fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- system_message
  Tipo: string | null
  
  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 campo system_message
- tag
  Tipo: 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 de tag especificado no objeto data da resposta
- temperature
  Tipo: 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: 1
  valor padrão: 0.7
  
  Observação: temperature não pode ser usado junto com top_p na mesma requisição
- top_p
  Tipo: number | null
  
  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: null
  
  Observação: top_p não pode ser usado junto com temperature na mesma requisição
- use_reasoning
  Tipo: boolean | null
  
  habilita raciocínio para o modelo de IA
  campo opcional
  quando habilitado, o modelo realizará raciocínio antes de gerar uma resposta
  consulte o endpoint Models para ver a lista de modelos que suportam reasoning
  valor padrão: false
  Observação: se definido como true, o valor mínimo para max_output_tokens é 1025
  Observação nº 2: se definido como true, force_web_search deve ser definido como false
  Observação nº 3: se definido como true, temperature e top_p não podem ser usados
- user_prompt
  Tipo: string
  
  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 campo user_prompt
- web_search
  Tipo: boolean | null
  
  habilita a pesquisa na web para informações atuais
  campo opcional
  quando habilitado, o modelo de IA pode acessar e citar informações atuais da web;
  Observação: consulte o endpoint Models para ver a lista de modelos que suportam web_search;
  valor padrão: false;
  O custo do parâmetro pode ser calculado na página Preços
- web_search_city
  Tipo: string | null
  
  nome da cidade do local usado para pesquisar na web
  campo opcional
- web_search_country_iso_code
  Tipo: string | null
  
  código ISO do país do local usado para pesquisar na web
  campo opcional
  valores possíveis: 'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'

Respostas

200
Tipo: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

status_code
Tipo: integer | null

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

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

array de tarefas

Tipo: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

data
Tipo: object | null

contém os mesmos parâmetros que você especificou na requisição POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

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

caminho da URL

result
Tipo: array (object | null)[] | null

array de resultados

datetime
Tipo: 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

fan_out_queries
Tipo: array (string | null)[] | null

array de consultas de fan-out
contém consultas de pesquisa relacionadas derivadas da consulta principal para fornecer uma resposta mais abrangente

input_tokens
Tipo: integer | null

número de tokens na entrada
contagem total de tokens processados

items
Tipo: array (object | null)[] | null

array de itens de resposta
contém dados estruturados de resposta da IA

type
Tipo: string | null

tipo de elemento

model_name
Tipo: string | null

nome do modelo de IA usado

money_spent
Tipo: number | null

custo dos tokens de IA, USD
o preço cobrado pelo provedor terceiro de modelo de IA de acordo com sua tabela de preços

output_tokens
Tipo: integer | null

número de tokens na saída
contagem total de tokens gerados na resposta da IA

reasoning_tokens
Tipo: integer | null

número de tokens de raciocínio
contagem total de tokens usados para gerar o conteúdo de raciocínio

web_search
Tipo: boolean | null

indica se a pesquisa na web foi usada

result_count
Tipo: integer | null Formato: int64

número de elementos no array de resultados

status_code
Tipo: integer | null

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

status_message
Tipo: string | null

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

time
Tipo: string | null

tempo de execução, segundos

tasks_count
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas

tasks_error
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas retornadas com erro

time
Tipo: string | null

tempo total de execução, em segundos

version
Tipo: string | null

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

post/v1/beta/dataforseo/ai_optimization/claude/llm_responses/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/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,
    "model_name": "claude-opus-4-0",
    "temperature": 0.3,
    "web_search": true,
    "web_search_country_iso_code": "FR",
    "user_prompt": "provide information on how relevant the amusement park business is in France now"
  }
]'

Mostrar Schema

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

Operação bem-sucedida

Respostas LLM do Claude em tempo real

AutenticaçãoRequired

DataForSEO

Respostas LLM do Claude em tempo real

Pricing reference