API IAAPI

Scrittura con IA, esposta nel modo in cui la userai davvero

Un endpoint REST genera una didascalia a partire da un brief. Il resto del toolkit di scrittura, la riscrittura di una bozza per ogni rete e il riutilizzo di un URL, si trova sul server MCP di FoPost, dove un client IA può collegarlo direttamente alla programmazione.

Ottieni la tua chiave API Leggi la documentazione

POST /v1/ai/generate-caption

curl -X POST https://api.fopost.com/v1/ai/generate-caption \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "instructions": "Announce webhook retries with exponential backoff. Keep it direct.",
    "platforms": ["linkedin"]
  }'

Un endpoint REST

generate-caption riceve un brief e le piattaforme di destinazione e restituisce un testo pronto.

Tre strumenti MCP

generate_caption, rewrite_for_platforms e repurpose_url per qualsiasi client MCP.

A crediti

Ogni chiamata attinge ai crediti IA del workspace. Puoi leggere il saldo in qualsiasi momento.

REST

Genera una didascalia dalla tua pipeline

Invia un breve brief e la rete di destinazione e ottieni una didascalia scritta nei limiti di quella rete. Sulla chiave serve lo scope ai. La risposta è testo: non viene pubblicato nulla finché non lo passi tu a POST /v1/posts.

Leggi il riferimento IA

Risposta

{
  "caption": "Webhook retries are live. A failed delivery now retries with exponential backoff before it ever reaches your inbox as an error. Details in the changelog.",
  "credits": { "charged": 1, "remaining": 199 }
}

Adattato alla piattaforma

Lunghezza, uso degli hashtag e interruzioni di riga seguono la rete indicata.

Non pubblica mai da solo

L'endpoint restituisce testo. La pubblicazione è una richiesta separata ed esplicita.

scope ai

Concedilo solo alle chiavi che devono spendere crediti.

MCP

Riscrivi e riutilizza da un client IA

Il server MCP espone l'intero set di scrittura. rewrite_for_platforms trasforma una bozza in un thread per X e in un paragrafo per LinkedIn. repurpose_url legge una pagina e propone una serie di post. Entrambi passano il risultato a schedule_post nella stessa sessione, e il client chiede conferma prima che qualcosa vada online.

Configura il server MCP

Prompt

> Take our latest changelog at https://yourbrand.com/changelog
  and turn it into three posts for LinkedIn and X this week.

Agent: I'll call repurpose_url, then rewrite_for_platforms for each,
then schedule_post for Tue, Wed, and Thu at 9am. Proceed? (y/n)

rewrite_for_platforms

Una bozza in ingresso, una versione per rete in uscita, ognuna nei propri limiti.

repurpose_url

Indicagli un post, un changelog o una pagina di documentazione e ottieni una serie di post.

Dritto alla programmazione

L'agente collega gli strumenti di scrittura a schedule_post senza uscire dalla chat.

Crediti

Spesa visibile, con tetto massimo e per workspace

Ogni chiamata IA viene conteggiata sul credito mensile gratuito incluso in ogni account. Leggi il saldo via MCP con get_ai_credits e nella dashboard in AI Usage. Quando il saldo si esaurisce, la chiamata restituisce 402 con un link per l'upgrade invece di fallire in silenzio.

Inizia a sviluppare

get_ai_credits

Chiedi all'agente quanti crediti restano prima di un grosso lotto.

402 chiaro

Un saldo esaurito è un errore esplicito, mai un post scritto a metà.

Limitato al workspace

Crediti e prompt restano nel workspace a cui appartiene la chiave.

API IA: le risposte alle tue domande

Quali funzionalità IA sono disponibili nell'API REST?

Un endpoint: POST /v1/ai/generate-caption, con lo scope ai. La riscrittura per rete, i suggerimenti di hashtag e il riutilizzo di un URL sono disponibili come strumenti MCP e nell'agente in-app, non come endpoint REST pubblici al momento.

Quale modello usa?

FoPost non espone il fornitore né il modello. Scegli una funzionalità e un tono: il servizio decide cosa la esegue e può cambiarlo senza alcuna modifica da parte tua.

Pubblica da solo?

No. Ogni endpoint e strumento IA restituisce testo. La pubblicazione è una richiesta separata, e i client MCP mostrano la chiamata schedule_post per l'approvazione prima di eseguirla.

Come vengono addebitati i crediti?

Ogni chiamata viene conteggiata sul tuo account di fatturazione e il consumo viene restituito con la risposta. L'utilizzo attinge prima al credito mensile gratuito; con una carta registrata, ciò che eccede viene fatturato esattamente per quanto usi.

Conosce la voce del mio brand?

Le chiamate dall'agente in-app possono associare un brand, che integra voce e stile nel prompt. L'endpoint REST accetta un brand_voice_id, oppure usa il brand predefinito del workspace, insieme al brief che invii.

Quale scope serve alla chiave?

Lo scope ai. Una chiave senza di esso riceve un 403 su questo endpoint, ma continua a funzionare per gli altri scope che ha.

Sviluppa oggi con API IA

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API