AI-APIAPI

Schrijven met AI, beschikbaar zoals je het echt aanroept

Eén REST-endpoint genereert een bijschrift op basis van een briefing. De rest van de schrijftools, zoals een concept herschrijven per netwerk en een URL hergebruiken, zit in de MCP-server van FoPost, waar een AI-client ze direct kan koppelen aan het inplannen.

Haal je API-sleutel op Lees de documentatie

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

Eén REST-endpoint

generate-caption neemt een briefing en de doelplatforms en geeft kant-en-klare tekst terug.

Drie MCP-tools

generate_caption, rewrite_for_platforms en repurpose_url voor elke MCP-client.

Op basis van credits

Elke aanroep gaat af van de AI-credits van de werkruimte. Bekijk het saldo wanneer je wilt.

REST

Genereer een bijschrift vanuit je eigen pipeline

Stuur een korte briefing en het doelnetwerk, en krijg een bijschrift terug dat binnen de limieten van dat netwerk past. De sleutel heeft de ai-scope nodig. Het antwoord is tekst: er wordt niets gepubliceerd tot je het zelf doorgeeft aan POST /v1/posts.

AI-documentatie lezen

Response

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

Kent elk platform

Lengte, hashtaggebruik en regeleinden volgen het netwerk dat je opgeeft.

Post nooit automatisch

Het endpoint geeft tekst terug. Publiceren is een apart, expliciet verzoek.

ai-scope

Geef hem alleen aan sleutels die credits mogen uitgeven.

MCP

Herschrijven en hergebruiken vanuit een AI-client

De MCP-server biedt de volledige set schrijftools. rewrite_for_platforms maakt van één concept een thread voor X en een alinea voor LinkedIn. repurpose_url leest een pagina en stelt een reeks posts voor. Beide geven hun resultaat in dezelfde sessie door aan schedule_post, en de client vraagt het je voordat er iets live gaat.

MCP-server instellen

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

Eén concept erin, één versie per netwerk eruit, elk binnen de limieten.

repurpose_url

Wijs naar een post, changelog of documentatiepagina en krijg een reeks terug.

Direct inplannen

De agent koppelt schrijftools aan schedule_post zonder de chat te verlaten.

Credits

Uitgaven zijn zichtbaar, begrensd en per werkruimte

Elke AI-aanroep wordt afgeboekt van het gratis maandelijkse gebruikstegoed dat bij elk account zit. Bekijk het saldo via MCP met get_ai_credits, en in het dashboard onder AI Usage. Als het saldo op is, geeft de aanroep een 402 terug met een upgradelink, in plaats van stilletjes te mislukken.

Begin met bouwen

De agent die posts voor meerdere netwerken schrijft in een opgeslagen merkstem

get_ai_credits

Vraag de agent hoeveel credits er nog over zijn voor een grote batch.

Duidelijke 402

Een leeg saldo is een expliciete fout, nooit een half geschreven post.

Per werkruimte

Credits en prompts blijven binnen de werkruimte waartoe de sleutel behoort.

Vragen over AI-API, beantwoord

Welke AI-functies zitten in de REST API?

Eén endpoint: POST /v1/ai/generate-caption, met de ai-scope. Herschrijven per netwerk, hashtagsuggesties en een URL hergebruiken zijn beschikbaar als MCP-tools en in de agent in de app, maar op dit moment niet als openbare REST-endpoints.

Welk model wordt gebruikt?

FoPost maakt de provider of het model niet bekend. Jij kiest een functie en een toon, de dienst kiest waarop het draait en kan dat wijzigen zonder dat jij iets hoeft aan te passen.

Publiceert de agent uit zichzelf?

Nee. Elk AI-endpoint en elke AI-tool geeft tekst terug. Publiceren is een apart verzoek, en MCP-clients tonen de schedule_post-aanroep ter goedkeuring voordat die wordt uitgevoerd.

Hoe worden credits berekend?

Elke aanroep wordt afgeboekt van je facturatieaccount en komt terug in het antwoord. Gebruik gaat eerst af van het gratis maandelijkse tegoed. Met een opgeslagen kaart wordt alles daarboven gefactureerd voor precies wat je gebruikt.

Kent het mijn merkstem?

Aanroepen vanuit de agent in de app kunnen een merk meekrijgen, waardoor de stem en stijl ervan in de prompt worden opgenomen. Het REST-endpoint neemt een brand_voice_id, of gebruikt het standaardmerk van de werkruimte, plus de briefing die je stuurt.

Welke scope heeft de sleutel nodig?

De ai-scope. Een sleutel zonder die scope krijgt een 403 op dit endpoint, maar blijft werken voor de andere scopes die hij heeft.

Bouw vandaag nog op de AI-API

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op