v0.2.0-beta

OpenAPI 3.1.0

Respuestas LLM de Claude en vivo

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 Operaciones

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

Respuestas LLM de Claude en vivo

Envía un user_prompt a un modelo Claude y devuelve su respuesta de forma síncrona. model_name debe proceder de get_dataforseo_ai_claude_llm_responses_models: los nombres son como claude-sonnet-5, y una suposición plausible se rechaza. Devuelve model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items y fan_out_queries. Lee money_spent en la respuesta para ver cuánto costó realmente un prompt. Envuelto en el envoltorio de DataForSEO: los datos en tasks[0].result y el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200.

Pricing reference

Medición: costo de respuesta reportado.
Estimación de referencia por solicitud: USD 0.0567.
Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe ya liquidado del cliente.

Solo metadatos de referencia; no son una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Cuerpo

application/json

Tipo: array (object | null)[]
- force_web_search
  Tipo: boolean | null
  
  obliga al agente de IA a usar la búsqueda web
  campo opcional
  para habilitar este parámetro, web_search también debe estar habilitado;
  cuando está habilitado, el modelo de IA se ve obligado a acceder y citar información web actual;
  valor predeterminado: false;
  Nota: aunque el parámetro se establezca en true, no hay garantía de que se citen fuentes web en la respuesta
- max_output_tokens
  Tipo: integer | null
  
  número máximo de tokens en la respuesta de la IA
  campo opcional
  valor mínimo: 1;
  valor máximo: 4096;
  valor predeterminado: 2048;
  Nota: si web_search se establece en true o se especifica el modelo de razonamiento en la solicitud, el recuento de tokens de salida puede superar el límite max_output_tokens especificado
  Nota n.º 2: si use_reasoning se establece en true, el valor mínimo para max_output_tokens es 1025
- message_chain
  Tipo: array (object | null)[] | null
  
  historial de la conversación campo opcional array de objetos de mensaje que representan turnos anteriores de la conversación; cada objeto debe contener: role string con el rol user o ai; message string con el contenido del mensaje (máximo 500 caracteres); puedes especificar un máximo de 10 objetos de mensaje en el array; Nota: para modelos Perplexity, los mensajes deben alternar estrictamente entre los roles user y ai (user → ai); ejemplo: "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 del mensaje
  
  role
  Tipo: string | null
  
  rol del usuario del que procede el mensaje
- model_name
  Tipo: string
  
  nombre del modelo de IA
  campo obligatorio
  model_nameconsta del nombre real del modelo y del nombre de la versión;
  si se especifica el nombre del modelo básico, se establecerá por defecto su versión más reciente;
  por ejemplo, si se especifica claude-opus-4-0, se establecerá claude-opus-4-20250514 como model_name automáticamente;
  puedes obtener la lista de modelos LLM disponibles haciendo una solicitud independiente a https://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/models
- system_message
  Tipo: string | null
  
  instrucciones para el comportamiento de la IA
  campo opcional
  define el rol, el tono o el comportamiento específico de la IA;
  puedes especificar hasta 500 caracteres en el campo system_message
- tag
  Tipo: string | null
  
  identificador de tarea definido por el usuario
  campo opcional
  el límite de caracteres es 255
  puedes usar este parámetro para identificar la tarea y relacionarla con el resultado
  encontrarás el valor de tag especificado en el objeto data de la respuesta
- temperature
  Tipo: number | null
  
  aleatoriedad de la respuesta de la IA
  campo opcional
  los valores más altos hacen que la salida sea más diversa;
  los valores más bajos hacen que la salida esté más enfocada;
  valor mínimo: 0
  valor máximo: 1
  valor predeterminado: 0.7
  
  Nota: temperature no se puede usar junto con top_p en la misma solicitud
- top_p
  Tipo: number | null
  
  diversidad de la respuesta de la IA
  campo opcional
  controla la diversidad de la respuesta limitando la selección de tokens;
  valor mínimo: 0
  valor máximo: 1
  valor predeterminado: null
  
  Nota: top_p no se puede usar junto con temperature en la misma solicitud
- use_reasoning
  Tipo: boolean | null
  
  habilitar razonamiento para el modelo de IA
  campo opcional
  cuando está habilitado, el modelo realizará razonamiento antes de generar una respuesta
  consulta el endpoint Models para ver la lista de modelos compatibles con reasoning
  valor predeterminado: false
  Nota: si se establece en true, el valor mínimo para max_output_tokens es 1025
  Nota n.º 2: si se establece en true, force_web_search debe establecerse en false
  Nota n.º 3: si se establece en true, temperature y top_p no se pueden usar
- user_prompt
  Tipo: string
  
  prompt para el modelo de IA
  campo obligatorio
  la pregunta o tarea que quieres enviar al modelo de IA;
  puedes especificar hasta 500 caracteres en el campo user_prompt
- web_search
  Tipo: boolean | null
  
  habilitar la búsqueda web para obtener información actual
  campo opcional
  cuando está habilitado, el modelo de IA puede acceder y citar información web actual;
  Nota: consulta el endpoint Models para ver la lista de modelos compatibles con web_search;
  valor predeterminado: false;
  El costo del parámetro puede calcularse en la página Precios
- web_search_city
  Tipo: string | null
  
  nombre de la ciudad de la ubicación usada para buscar en la web
  campo opcional
- web_search_country_iso_code
  Tipo: string | null
  
  código ISO de país de la ubicación usada para buscar en la web
  campo opcional
  valores posibles: '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'

Respuestas

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

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

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

array de tareas

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

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

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

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

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

ruta de la URL

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

array de resultados

datetime
Tipo: string | null

fecha y hora en que se recibió el resultado
en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ejemplo:
2019-11-15 12:57:46 +00:00

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

array de consultas de fan-out
contiene consultas de búsqueda relacionadas derivadas de la consulta principal para ofrecer una respuesta más completa

input_tokens
Tipo: integer | null

número de tokens en la entrada
recuento total de tokens procesados

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

array de elementos de respuesta
contiene datos estructurados de respuesta de IA

type
Tipo: string | null

tipo de elemento

model_name
Tipo: string | null

nombre del modelo de IA utilizado

money_spent
Tipo: number | null

coste de los tokens de IA, USD
el precio que cobra el proveedor externo de modelos de IA según sus precios

output_tokens
Tipo: integer | null

número de tokens en la salida
recuento total de tokens generados en la respuesta de IA

reasoning_tokens
Tipo: integer | null

número de tokens de razonamiento
recuento total de tokens utilizados para generar el contenido de razonamiento

web_search
Tipo: boolean | null

indica si se utilizó la búsqueda web

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

la versión actual de la API
application/json
400

No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
401

Se requiere una clave de API de Felo válida.
402

La solicitud no puede continuar porque no se cumple un requisito de facturación.
403

La cuenta no tiene permiso para realizar esta operación.
429

Se ha alcanzado un límite de solicitudes o de gasto.
502

El servicio no pudo completar la solicitud.
503

La API o el servicio de facturación no están disponibles temporalmente.
504

El servicio agotó el tiempo de espera al procesar la solicitud.
default

Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

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 esquema

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

Operación correcta

Respuestas LLM de Claude en vivo

AutenticaciónRequired

DataForSEO

Respuestas LLM de Claude en vivo

Pricing reference