AI APIAPI

AIライティングを、実際に呼び出す形で

RESTエンドポイント1つで、概要からキャプションを生成します。ネットワークごとの下書きの書き換えやURLの再活用など、残りのライティングツールはFoPostのMCPサーバーにあり、AIクライアントがそのまま予約投稿につなげられます。

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

RESTエンドポイント1つ

generate-captionは概要と対象プラットフォームを受け取り、すぐ使える文章を返します。

3つのMCPツール

generate_caption、rewrite_for_platforms、repurpose_urlを、任意のMCPクライアントから使えます。

クレジット制

呼び出しのたびにワークスペースのAIクレジットを消費します。残高はいつでも確認できます。

REST

自社のパイプラインからキャプションを生成

短い概要と対象ネットワークを送ると、そのネットワークの制限内で書かれたキャプションが返ります。キーにはaiスコープが必要です。レスポンスはテキストなので、自分でPOST /v1/postsに渡すまで何も公開されません。

AIリファレンスを読む
レスポンス
{
  "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 }
}

プラットフォームに最適化

文字数、ハッシュタグの使い方、改行は、指定したネットワークに合わせます。

自動投稿はしない

エンドポイントが返すのはテキストです。公開は別の明示的なリクエストで行います。

aiスコープ

クレジットを使ってよいキーにだけ付与します。

MCP

AIクライアントから書き換えと再活用

MCPサーバーはライティングツール一式を提供します。rewrite_for_platformsは1つの下書きを、X向けのスレッドとLinkedIn向けの段落に変えます。repurpose_urlはページを読み込み、一連の投稿を提案します。どちらも同じセッション内で出力をschedule_postに渡し、公開前には必ずクライアントが確認します。

MCPサーバーを設定する
プロンプト
> 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

下書きを1つ入れると、ネットワークごとに制限内のバージョンが出てきます。

repurpose_url

投稿、変更履歴、ドキュメントページを指定すれば、一連の投稿が返ってきます。

そのまま予約投稿へ

エージェントはチャットを離れずに、ライティングツールをschedule_postにつなげます。

クレジット

利用額は見える化され、上限付きで、ワークスペース単位

AIの呼び出しはすべて、各アカウントに含まれる毎月の無料利用クレジットに対して計測されます。残高はMCPのget_ai_creditsで、またダッシュボードの「AI利用状況」で確認できます。残高がなくなると、黙って失敗するのではなく、アップグレード用リンク付きの402が返ります。

開発を始める
保存済みのブランドボイスで複数のネットワーク向けに投稿を下書きするエージェント

get_ai_credits

大量の処理の前に、残りクレジットをエージェントに聞けます。

明確な402

残高切れは明示的なエラーになり、書きかけの投稿が残ることはありません。

ワークスペース単位

クレジットとプロンプトは、キーが属するワークスペースの中にとどまります。

AI APIに関するよくある質問

REST APIで使えるAI機能は?

aiスコープ付きのPOST /v1/ai/generate-captionエンドポイント1つです。ネットワークごとの書き換え、ハッシュタグの提案、URLの再活用は、MCPツールとアプリ内エージェントで利用でき、現時点では公開RESTエンドポイントではありません。

どのモデルを使っていますか?

FoPostはプロバイダーやモデルを公開していません。選ぶのは機能とトーンだけで、実行するものはサービス側が選び、利用者側の変更なしに切り替えることがあります。

勝手に公開することはありますか?

いいえ。AIのエンドポイントとツールはすべてテキストを返します。公開は別のリクエストで行い、MCPクライアントはschedule_postの呼び出しを実行前に表示して承認を求めます。

クレジットはどう課金されますか?

各呼び出しは請求アカウントに対して計測され、レスポンスとともに返されます。利用分はまず毎月の無料クレジットから差し引かれ、カードを登録していれば、それを超えた分は使った分だけ正確に請求されます。

ブランドボイスを反映できますか?

アプリ内エージェントからの呼び出しではブランドを指定でき、そのボイスとスタイルがプロンプトに反映されます。RESTエンドポイントはbrand_voice_idを受け取り、指定がなければワークスペースのデフォルトのブランドを使い、送った概要と組み合わせます。

キーに必要なスコープは?

aiスコープです。これがないキーはこのエンドポイントで403になりますが、持っているほかのスコープの操作は引き続き使えます。

今日からAI APIで開発を

無料で始められ、API全体が含まれます。キーを作成すれば、数分で最初の呼び出しができます。

APIキーを取得