Docs

API docs

Create a prediction, get the result, integrate it.

Request API Key

Request a model API key

Request a FounderHooks API key to call model capabilities through one stable interface.

API access

Unified model API

Call enabled model capabilities with one FounderHooks API key.

Use one request format for playground tests, product integrations, and async result checks.

Keep the required run records for debugging and usage management.

Predictions lifecycle

FounderHooks accepts a model and input payload, creates a prediction, and returns a standard response shape.

Create a prediction with model + input payload.

Poll status through the FounderHooks prediction id endpoint.

Manage credentials and usage from the FounderHooks workspace.

Streaming output

Language and voice models often benefit from streaming. The platform UX should treat streaming as a first-class product surface, not a hidden SDK detail.

Stream partial output or intermediate events.

Surface partial output in the playground immediately.

Mirror the same behavior in the API snippets.

Webhooks and async delivery

For video, image batches, or multi-step runs, webhook delivery becomes the default integration surface. FounderHooks keeps the webhook pattern obvious in both docs and example code.

Attach a callback URL on prediction create.

Retry delivery on transient failures.

Log event receipts per prediction for debugging.

curl

API sample

curl -s -X POST https://www.founderhooks.com/api/v1/predictions \
  -H "Authorization: Bearer $FOUNDERHOOKS_API_KEY" \
  -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 sample

const response = await fetch("https://www.founderhooks.com/api/v1/predictions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FOUNDERHOOKS_API_KEY}`,
    "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();