Primeros pasos

Felo API Platform te ofrece una sola clave para herramientas de agentes, protocolos de modelos, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page y las API de SuperAgent. Empieza aquí, elige la herramienta que uses y sigue la guía de configuración específica de esa herramienta.

¿Es tu primera vez? Lee la descripción general de la plataforma para entender cómo encajan Model API, Data API y las API de Felo, o ve directamente a Protocolos y SDK y Canales y enrutamiento de proveedores.

Configura Codex o Claude Code con la CLI

Con Node.js 22+ y tu herramienta de IA instalada, ejecuta:

npx feloapi-cli setup

Sigue las indicaciones para pegar tu clave de API de Felo completa y elegir modelos, Skills o ambos. Después, inicia tu herramienta con npx feloapi-cli run codex o npx feloapi-cli run claude-code.

Instalación y uso de la CLI

Flujo de inicio rápido

1. Obtén una clave de Felo API Platform y compra créditos de servicio cuando los necesites; no se requiere suscripción.
2. Elige tu herramienta o plataforma de IA en la tabla siguiente.
3. Abre la guía de configuración correspondiente y pega la URL base y la clave de API de Felo.
4. Ejecuta una tarea pequeña en esa herramienta para confirmar la conexión.
5. Añade las API de flujo de trabajo cuando tu agente necesite búsqueda, salida de ofimática, extracción web, flujos de imágenes, LiveDocs o SuperAgent.

Paso 1: Obtén tu clave de API

Felo API Platform usa una sola clave de API tanto para las llamadas directas a la API como para las herramientas de IA compatibles.

1. Abre la página de claves de API de Felo API Platform.
2. Inicia sesión con tu cuenta de Felo si se solicita.
3. Introduce un nombre para la clave y haz clic en Create Key.
4. Copia la clave completa cuando aparezca. Solo se muestra una vez.
5. Guarda la clave de forma segura y úsala como FELO_API_KEY.

Recarga a medida que avanzas en Facturación de la consola desde $1. Compras créditos de servicio expresados en USD para el uso real de la API. No se requiere suscripción.

Define la clave como una variable de entorno:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Paso 2: Elige tu herramienta de IA

Haz clic en la herramienta que quieras usar. Cada enlace abre una guía de configuración específica con la URL base, las variables de entorno y el paso de verificación correctos.

Paso 3: Usa la URL base correcta

La mayoría de las herramientas piden tres valores: clave de API, URL base y nombre del modelo. Elige la URL base según el protocolo que admita la herramienta.

Si no sabes qué modo admite tu cliente, empieza con la URL base compatible con OpenAI. Usa la URL base compatible con Anthropic para Claude Code o para clientes que soliciten explícitamente un endpoint Anthropic Messages.

Paso 4: Verifica con una llamada directa a la API

Si solo quieres confirmar que tu clave funciona, llama directamente a la Chat API.

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

Una respuesta correcta incluye una respuesta generada, el análisis de la consulta y recursos web.

{
  "status": "ok",
  "data": {
    "id": "HabCj883yHLSXc8mWqu4Eq",
    "message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
    "answer": "...",
    "query_analysis": {
      "queries": ["AI agent product trends"]
    },
    "resources": [
      {
        "link": "https://example.com/report",
        "title": "AI Agent Market Report",
        "snippet": "..."
      }
    ]
  }
}

Paso 5: Añade las API de flujo de trabajo

Cuando tu primera herramienta o llamada a la API funcione, conecta las API que encajen con tu escenario.

Ejemplos de llamadas directas a la API

Si compilas directamente contra la API en lugar de configurar una herramienta de IA, empieza con una de estas llamadas mínimas.

Crear una tarea de PPT

Usa la PPT Task API cuando quieras generar una presentación de diapositivas de forma asíncrona. La respuesta devuelve un task_id que puedes consultar periódicamente.

curl -X POST https://openapi.felo.ai/v2/ppts \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a 5-slide strategy deck about AI agents for office productivity"
  }'

Respuesta de ejemplo:

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

Consulta el estado de la tarea:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Crear una tarea de landing page

Usa la Landing Page Task API cuando quieras que Felo genere una landing page a partir de un prompt.

curl -X POST https://openapi.felo.ai/v2/landing_page \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Generate a launch landing page for an AI research assistant"
  }'

Respuesta de ejemplo:

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

Consulta el mismo endpoint de estado de tarea que usan las tareas de PPT:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Python

import os
import requests

api_key = os.environ["FELO_API_KEY"]

response = requests.post(
    "https://openapi.felo.ai/v2/chat",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={"query": "What are the latest AI agent product trends?"},
    timeout=60,
)

response.raise_for_status()
print(response.json()["data"]["answer"])

JavaScript (Node.js)

const response = await fetch("https://openapi.felo.ai/v2/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FELO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What are the latest AI agent product trends?",
  }),
});

if (!response.ok) {
  throw new Error(`Felo API request failed: ${response.status}`);
}

const result = await response.json();
console.log(result.data.answer);

Problemas de configuración habituales

Siguientes pasos

• Configurar Codex
• Configurar Claude Code
• Guía de autenticación
• Referencia de la LLM API
• Referencia de la Chat API
• Referencia de la SuperAgent API