Docs

调用文档

创建 prediction,拿结果,接进产品。

申请 API Key

用 FounderHooks Key 调模型

前端用户只拿我们的 key。服务端会用 FounderHooks 配置的 Replicate token 代发请求。

代理层

一层简单的 Replicate 套壳

用户调用 FounderHooks API,不接触 Replicate token。
服务端用 REPLICATE_API_TOKEN 转发到 Replicate。
每次请求会记录 key、模型、prediction id 和上游状态。
Predictions 生命周期

FounderHooks 接收你自己的 API key,再由服务端转发到 Replicate,并返回 prediction 结果。

用 model + input payload 创建 prediction。
通过 FounderHooks prediction id 端点轮询状态。
你的 Replicate token 只保存在 FounderHooks 服务端。
流式输出

语言和语音模型往往需要流式输出。平台体验应该把 streaming 当成一等能力,而不是藏在 SDK 里的细节。

流式返回 token 或中间事件。
在 playground 里立即展示部分结果。
API 示例也保持同样的调用方式。
Webhooks 与异步回调

对视频、批量图像或多步骤运行来说,webhook 往往是默认集成方式。FounderHooks 会把 webhook 模式直接讲清楚,并放进示例代码里。

在创建 prediction 时附带 callback URL。
遇到临时失败时自动重试。
按 prediction 记录事件回执,方便调试。
curl
API 示例
curl -s -X POST https://www.founderhooks.com/api/v1/predictions \
  -H "Authorization: Bearer $FOUNDERHOOKS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "black-forest-labs/flux-schnell",
    "input": {
      "prompt": "Generate a polished product visual for an AI platform homepage"
    },
    "wait": 10
  }'
JavaScript
API 示例
const response = await fetch("https://www.founderhooks.com/api/v1/predictions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FOUNDERHOOKS_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "black-forest-labs/flux-schnell",
    input: {
      "prompt": "Generate a polished product visual for an AI platform homepage"
    },
    wait: 10,
  }),
});

const prediction = await response.json();