Per iniziare

Felo API Platform ti offre una sola chiave per gli strumenti agente, i protocolli dei modelli, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e le API SuperAgent. Parti da qui, scegli lo strumento che usi e segui la guida di configurazione dedicata.

Sei nuovo? Leggi la Panoramica della piattaforma per capire come si combinano Model API, Data API e Felo API, oppure vai direttamente a Protocolli e SDK e Canali e routing dei provider.

Configurare Codex o Claude Code con la CLI

Con Node.js 22+ e il tuo strumento IA installato, esegui:

npx feloapi-cli setup

Segui le richieste per incollare la chiave API Felo completa e scegliere modelli, Skills o entrambi. Poi avvia lo strumento con npx feloapi-cli run codex o npx feloapi-cli run claude-code.

Installazione e utilizzo della CLI

Flusso di avvio rapido

1. Ottieni una chiave Felo API Platform e acquista crediti di servizio quando serve; non è richiesto alcun abbonamento.
2. Scegli il tuo strumento o la tua piattaforma IA dalla tabella qui sotto.
3. Apri la guida di configurazione corrispondente e incolla l'URL di base e la chiave API Felo.
4. Esegui un'attività semplice in quello strumento per confermare la connessione.
5. Aggiungi le API di workflow quando il tuo agente ha bisogno di ricerca, output per ufficio, estrazione web, workflow per immagini, LiveDocs o SuperAgent.

Passo 1: ottenere la chiave API

Felo API Platform usa una sola chiave API sia per le chiamate API dirette sia per gli strumenti IA supportati.

1. Apri la pagina Chiavi API di Felo API Platform.
2. Accedi con il tuo account Felo se richiesto.
3. Inserisci un nome per la chiave e clicca Create Key.
4. Copia la chiave completa quando viene mostrata. Viene visualizzata una sola volta.
5. Conserva la chiave in un luogo sicuro e usala come FELO_API_KEY.

Ricarica man mano in Console Billing a partire da 1 $. Acquisti crediti di servizio in USD per l'utilizzo effettivo dell'API. Non è richiesto alcun abbonamento.

Imposta la chiave come variabile d'ambiente:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Passo 2: scegliere lo strumento IA

Clicca lo strumento che vuoi usare. Ogni link apre una guida di configurazione dedicata con l'URL di base, le variabili d'ambiente e il passo di verifica corretti.

Passo 3: usare l'URL di base corretto

La maggior parte degli strumenti chiede tre valori: chiave API, URL di base e nome del modello. Scegli l'URL di base in base al protocollo supportato dallo strumento.

Se non sai quale modalità supporta il tuo client, inizia dall'URL di base compatibile con OpenAI. Usa l'URL di base compatibile con Anthropic per Claude Code o per i client che richiedono esplicitamente un endpoint Anthropic Messages.

Passo 4: verificare con una chiamata API diretta

Se vuoi solo confermare che la chiave funzioni, chiama direttamente 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 risposta riuscita include una risposta, l'analisi della query e le risorse 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": "..."
      }
    ]
  }
}

Passo 5: aggiungere le API di workflow

Dopo che il primo strumento o la prima chiamata API funziona, collega le API adatte al tuo scenario.

Esempi di chiamate API dirette

Se sviluppi direttamente contro l'API invece di configurare uno strumento IA, inizia da una di queste chiamate minime.

Creare un'attività PPT

Usa la PPT Task API quando vuoi generare una presentazione in modo asincrono. La risposta restituisce un task_id che puoi interrogare.

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

Risposta di esempio:

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

Interroga lo stato dell'attività:

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

Creare un'attività di landing page

Usa la Landing Page Task API quando vuoi che Felo generi una landing page a partire da 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"
  }'

Risposta di esempio:

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

Interroga lo stesso endpoint di stato usato dalle attività 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);

Problemi di configurazione comuni

Passi successivi

• Configura Codex
• Configura Claude Code
• Guida all'autenticazione
• Riferimento LLM API
• Riferimento Chat API
• Riferimento SuperAgent API