AI APIAPI

AI 写作,以你真正会用的方式开放

一个 REST 端点根据简要说明生成文案。其余写作工具,包括为每个网络改写草稿和二次利用 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 端点

generate-caption 接收简要说明和目标平台,返回可直接使用的文案。

三个 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 把一份草稿变成 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

输入一份草稿,为每个网络输出一个版本,各自符合限制。

repurpose_url

指向一篇文章、一份更新日志或一个文档页面,就能得到一系列帖子。

直接进入排期

智能体把写作工具串联到 schedule_post,全程不离开对话。

额度

花费可见、有上限、按工作区划分

每次 AI 调用都会从每个账号附带的每月免费使用额度中计量扣除。可通过 MCP 用 get_ai_credits 查看余额,也可在控制台的 AI 用量中查看。余额用完时,调用会返回 402 和升级链接,而不是悄无声息地失败。

开始构建
智能体用已保存的品牌语调为多个网络撰写帖子草稿

get_ai_credits

在大批量操作前,先问智能体还剩多少额度。

明确的 402

余额耗尽是一个明确的错误,绝不会产生写了一半的帖子。

按工作区隔离

额度和提示词都留在密钥所属的工作区内。

关于 AI API 的常见问题解答

REST API 上有哪些 AI 功能?

一个端点:POST /v1/ai/generate-caption,需要 ai 权限。按网络改写、话题标签建议和二次利用 URL 以 MCP 工具形式提供,也可在应用内的智能体中使用,目前尚无公开的 REST 端点。

它使用哪个模型?

FoPost 不公开服务商或模型。你选择功能和语气,服务会决定由什么来运行,并且可以在你无需改动的情况下更换。

它会自行发布吗?

不会。每个 AI 端点和工具都只返回文本。发布是另一个独立的请求,MCP 客户端在运行 schedule_post 调用前会先展示给你审批。

额度如何计费?

每次调用都按你的计费账户计量,并随响应一并返回。用量首先从每月免费额度中扣除;如果已绑定银行卡,超出部分按实际用量计费。

它了解我的品牌语调吗?

在应用内智能体中发起的调用可以附加一个品牌,把它的语调和风格融入提示词。REST 端点接收 brand_voice_id,或使用工作区的默认品牌,再加上你发送的简要说明。

密钥需要哪个权限范围?

ai 权限。没有该权限的密钥在此端点会收到 403,但仍可用于它拥有的其他权限范围。

今天就基于 AI API 开始构建

免费开始,包含完整 API。创建密钥,几分钟内完成第一次调用。

获取 API 密钥