Landing Page Task API

La Landing Page Task API ofrece capacidades de generación asíncrona de landing pages. Primero creas una tarea y después reutilizas las API de consulta de tareas existentes para consultar el progreso y los resultados.

Autenticación

Todas las solicitudes requieren una clave de API en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Uso con agentes de IA

Instala el paquete completo felo-ai para que un agente pueda generar landing pages y usar todas las demás Felo Skills disponibles. El instalador descubre dinámicamente todos los directorios del paquete que contengan SKILL.md, en lugar de depender de una lista fija. Instala todas las Skills descubiertas en Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Lee la guía de configuración manual de agentes de IA para conocer la clave de API y los pasos de verificación específicos de cada plataforma.

Crear una tarea de landing page

Endpoint

POST https://openapi.felo.ai/v2/landing_page

Encabezados de la solicitud

Cuerpo de la solicitud

Ejemplo

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Generate a landing page for Felo Search"
  }'

Crear con un archivo

Usa multipart/form-data para subir un archivo junto con la solicitud de la tarea de landing page. El archivo se sube primero como recurso de LiveDoc y después su ID de recurso se pasa a la tarea de landing page.

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'query=Generate a landing page from this product brief' \
  -F '[email protected]'

Partes multipart opcionales:

Respuesta correcta (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

Campos de la respuesta

Consultar el estado de la tarea

Las tareas de landing page reutilizan las mismas API de consulta de tareas que las tareas de PPT.

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/status

Ejemplo

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Consultar la información histórica de la tarea

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical

Ejemplo

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/historical' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Ejemplo de respuesta completada de AI_PAGE

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019d7a4d-6ab5-a96d-0f98-43ca434ab621",
    "task_status": "COMPLETED",
    "ppt_biz_id": "9qiLTmT77fA3aVurrMHvRJ",
    "ppt_url": "https://felo.ai/slides/9qiLTmT77fA3aVurrMHvRJ",
    "ai_page_html": "https://felo.ai/ai-page/9qiLTmT77fA3aVurrMHvRJ"
  }
}

Consulta la PPT Task API para ver los ejemplos compartidos de respuestas de consulta y la semántica de los estados.

Códigos de error