Landing Page Task API

A Landing Page Task API oferece recursos assíncronos de geração de landing pages. Você cria uma tarefa primeiro e depois reutiliza as APIs de consulta de tarefas existentes para verificar o progresso e os resultados.

Autenticação

Todas as requisições exigem uma chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Uso com agentes de IA

Instale o pacote completo felo-ai para permitir que um agente gere landing pages e use todos os demais Felo Skills disponíveis. O instalador descobre dinamicamente todos os diretórios de pacote que contêm SKILL.md, em vez de depender de uma lista fixa. Instale todos os Skills descobertos em ~/.codex/skills para o Codex, ~/.claude/skills para o Claude Code, ~/.agents/skills para o OpenClaw ou ~/.hermes/skills para o Hermes Agent. Leia o guia de configuração manual de agentes de IA para ver a chave de API e os passos de verificação de cada plataforma.

Criar uma tarefa de landing page

Endpoint

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

Cabeçalhos da requisição

Corpo da requisição

Exemplo

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"
  }'

Criar com arquivo

Use multipart/form-data para enviar um arquivo junto com a requisição de tarefa de landing page. O arquivo é enviado primeiro como recurso do LiveDoc, e então seu ID de recurso é passado para a tarefa 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 opcionais:

Resposta de sucesso (200)

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

Campos da resposta

Consultar o status da tarefa

As tarefas de landing page reutilizam as mesmas APIs de consulta de tarefas das tarefas de PPT.

Endpoint

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

Exemplo

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 o histórico da tarefa

Endpoint

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

Exemplo

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'

Exemplo de resposta com AI_PAGE concluída

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

Consulte a PPT Task API para ver os exemplos compartilhados de resposta de consulta e a semântica dos status.

Códigos de erro