# Hindsight Models Inference API: Setup and Pricing

By Ingrid Kovarová · 2026-11-04 · Source: https://www.activepieces.com/blog/hindsight-models-inference-api-setup-and-pricing

---
<aside class="tldr"><p class="tldr-label">Summary</p><p>A nightly batch on Hindsight Models Inference API hit rate limits at 2:10am, causing instant retries that created duplicates and customer-facing failures because retry caps, done-markers and alerts were missing. -</p><ul><li>Rate-limit errors at 2:10am triggered retries with no backoff, creating duplicate calls.</li><li>Flow had no retry cap, done-marker or alert, discovered by a customer.</li></ul></aside>

The [Hindsight](https://hindsight.vectorize.io/blog/2026/11/03/hindsight-models) models inference API, which its docs call Hindsight Inference, is a hosted service that serves the models behind Hindsight's own retrieval directly to your applications, whether those are agents, scripts, or workflows built in tools like [Activepieces](https://www.activepieces.com).

The [Hindsight docs](https://docs.hindsight.vectorize.io) describe it as something you adopt "by changing a base URL."

That's convenient for a first call. It also means whoever changes the URL owns what happens when the service throttles or errors, so name that person before the flow ships.

## Getting a Hindsight inference API key

### What the Hindsight inference API is

Because the docs live under the vectorize.io domain, Vectorize looks like the maker. The page text we worked from doesn't say so in words, so treat the attribution as inferred from the host.

The service is new. We found no release date stated in the material we read, and we're not going to estimate one.

Read the model types on offer in the docs, not here, since the docs list them. A Text AI step in a flow is the slot where a call like this would sit.

![Activepieces workflow builder showing a Page Audit step using Text AI with OpenAI GPT-4o to create an SEO audit.](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/06a8a527-00bb-443a-8a42-78ad1fd5fa1a/enterprise-ai-security-framework-for-automation-032ed84e.webp)

In the flow below, built in [Activepieces](https://www.activepieces.com), which has an MIT-licensed core and 747 integrations, there is a "Page Audit" step, so you likely won't need custom connectors for common services.

![Activepieces workflow builder with HTTP request step selected and its settings panel open showing method, URL, headers, and…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/9e36e973-de4a-435f-8912-12e666216b2d/self-host-mistral-ai-enterprise-deployment-guide-3f7fe28d.webp)

That step asks a model to score a site and write a short executive summary, with a step that strips HTML before it and a document-creation step after.

Not Hindsight: that step uses a different provider. It shows how little the step exposes: provider, model and prompt, with nothing about retries, caps or duplicates.

Retries, caps and duplicates: those missing controls are what the sections that follow cover.

### Getting access and creating a Hindsight API key

We didn't find step-by-step instructions for access and key creation in the material we have, though the docs cover both. We haven't created a key, so we can't say whether signup is open, gated or paid, or what the key looks like.

Start from the docs page above and check who in your organisation may issue and hold the key, because that person gets paged when it stops working.

As read on 2026-11-04, everything here comes from the maker's docs. We haven't run the API, so nothing in this article is a measured result.

Where the docs are silent, we say so, and the later sections mark every rule as a design choice to confirm against your own first batch.

## Hindsight API first request and undocumented limits

**Nothing in the first request touches a limit**, and the Hindsight docs publish few of the limits that a real batch will hit.

Picture a hypothetical three-person operations team that wires the API into a nightly job. Whoever owns that job is the person paged when it stalls at 2am, so the question of who owns the limits comes before the first call.

Look at the two documented models: hs-embed-1 and hs-decide-1-flash. The names suggest embedding and fast decision work, so a flow that uses both has two separate price and limit profiles to track.

### Hindsight model pricing and rate limits by tier

**Pricing is pay as you go**: usage draws on the same shared credits as Hindsight Cloud.

hs-embed-1 handles embeddings and hs-decide-1-flash handles fast decisions. The docs publish few rate limits for either.

With no published limit, the ceiling is something you discover by hitting it, which is why the first batch has to be small and watched.

To see how much the tier matters, look at other hosted LLM APIs. According to [Deploybase](https://deploybase.ai/articles/llm-api-rate-limits-compared-all-providers), the requests-per-minute allowances run like this:

| Provider and tier | Requests per minute | Note |
|---|---|---|
| OpenAI free trial | 3 | A loop of 100 records takes over half an hour |
| Gemini Tier 1 | 150 | Enough for a pilot but not a backlog |
| Claude Start | 1,000 | |
| Gemini Tier 2 | 1,000 | |
| Gemini Tier 3 | 2,000 | |
| OpenAI Tier 5 | 10,000 | More than three thousand times the trial figure |

_Checked against [docs.hindsight.vectorize.io](https://docs.hindsight.vectorize.io) on November 4, 2026._

Depending on which tier the account sits in, the same code can behave completely differently.

A minimal request, step by step:

1. Store the API key in the automation's secret store, not in the flow definition.
2. Send one short input to hs-embed-1 and confirm a success status.
3. Record the token usage the response reports.
4. Repeat for hs-decide-1-flash.
5. Write down the account tier and who can change it.

All a single success proves is that the credentials and the request shape work. It says nothing about retries, caps or duplicates, and the next section covers those.

## Hindsight API rate-limit errors in a nightly batch

At 2:10am, ten minutes into an unattended batch, the first rate-limit errors arrive. A flow with no retry rules turns them into the failure that pages whoever owns the job.

Nothing in this hypothetical night is a malformed request, which is why the first successful call never warned anyone. The night shows how a limit becomes a duplicate problem.

1. 2:00: the batch starts and sends records as fast as the flow allows.
2. 2:10: the first 429 "too many requests" errors come back.
3. 2:10 onward: retries fire instantly, with no wait, adding load to the very limit that caused the errors.
4. Shortly after: calls that timed out are sent again, though some were already processed.
5. Morning: the batch ends with half-processed records and no one sure which half.

The next two subsections take the log and the duplicates in turn.

### Hindsight API 429 and 5xx errors explained

By general HTTP convention, 429 means slow down and 5xx means the server failed. The two need different handling, and a flow that treats both as "try again now" fails at both. Hosted model APIs also fail often enough that this is routine.

For a benchmark, [Rewindex](https://rewindex.com/company/anthropic/reports) tracked incidents on the Claude API, Anthropic's model API; this is not Hindsight data. It logged 26 in November 2025, so even a quiet month brought nearly one a day.

![Claude API incidents logged each month](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/eb9cc92f-7de8-4841-af55-6b28cbf3f905/hindsight-models-inference-api-setup-and-pricing-b5e28329.svg "Source: Rewindex")

At 13, September 2026 was the lowest, which still means a nightly job meets trouble most weeks.

In January 2026 it returned to 26, then February jumped to 58, roughly two a day. March recorded 51 and April 49, so the higher level persisted rather than being a one-month spike. Plan for the bad months, not the quiet ones.

### API timeouts and duplicate requests

When a call times out, all you know is that no answer arrived, not that nothing happened. The server may have processed the record and the response got lost.

<blockquote class="pull"><p>When a call times out, all you know is that no answer arrived, not that nothing happened.</p></blockquote>

A flow that resends on timeout, with no record of what it already sent and no duplicate-protection key, writes that record twice.

That's the point where ownership matters. **Someone must decide, before the first real batch, who is paged, what the cap on retries is, and how a record is marked as done.**

## Cost of the failed Hindsight batch run

By the end, most of a working day had gone on cleanup for the person who was paged. The night also left a block of half-processed records, a run of duplicate calls billed at full price, and customers who saw the fault before anyone did.

I've fixed no figures here. Any number I invented would be read as a benchmark, and the real inputs are your own rate limit, retry cap and unit price.

In place of figures, the table gives each row a stand-in in words, the formula that turns it into a number, and the place where your real limit goes.

Read it as a way to size your own incident before the batch runs, not as a forecast.

| Row | Invented value | Formula | Where you enter your real limit |
|---|---|---|---|
| Cleanup hours | Most of one person's day | Half-processed records × minutes to inspect and repair each ÷ 60 | Your own repair time per record, measured on a small sample |
| Half-processed records | The share of the batch in flight when the limit hit | Requests in flight at the failure × share that had already written a result | Your concurrency setting and the provider's documented rate limit |
| Duplicate calls | One extra call per record that was retried without a done-marker | Records retried × retries per record, up to the cap | Your retry cap |
| Duplicate spend | Every duplicate call paid for in full | Duplicate calls × documented unit price per call | The unit price on the provider's pricing page for the model you call |
| Customers affected | Those whose records sat in the half-processed set | Half-processed records that reach a customer-facing step | Your count of records that trigger a message or update |

Pull on one row and the others move. A lower retry cap shrinks duplicate calls, and a done-marker written before the next step shrinks half-processed records.

Both cut cleanup hours and the customer count in turn. Duplicate spend is the easiest row to measure, but it's rarely the costly one.

Run the arithmetic with your own limits before the first real batch. If the cleanup-hours row comes out larger than the time you are willing to give up at 2am, the cap and the done-marker need tightening first.

## Missing rate limit defenses in the workflow

Whoever owned the workflow found out from a customer, not from the system, after five missing controls stacked up and it failed. Each gap is ordinary, and each one stays invisible until the first real batch arrives.

### Setting batch size within the tier limit

Sized by how many records needed processing, the batch ignored how many requests the account's tier allows per minute.

Test a handful of records and you never come near a per-minute limit, so the first working request proves nothing about it. A full batch hits the gate within seconds, and everything past it is rejected.

Put a queue between the records and the worker; that is the generic fix. The worker drains it at a rate set below the published limit.

If you move to a higher tier, that raises the ceiling and fixes volume only. It does nothing for the missing retry, cap and duplicate rules, so a larger batch just fails the same way, faster.

### Retries that made the outage worse

When the gate rejected a request, the flow retried immediately, with no pause and no stop condition. Each rejection produced another request, so the worker spent its whole run pressing against a limit that only eases when it stops pressing.

![A small worker box pressed against a narrow gate; three short arrows curl from the gate straight back into the worker with…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/d134cacd-62ba-4cca-aca0-9f580f9db721/hindsight-models-inference-api-setup-and-pricing-f5d45cb7.webp)

Look at the illustration below: the retry arrows loop from the gate straight back to the worker with no gap between them, and the worker never gets a quiet minute in which the limit could reset.

To repair this, use backoff with jitter, the standard approach. The wait grows after each failure, and a random offset keeps parallel workers from retrying in step.

Pair it with a hard cap on attempts per record and a spend ceiling per run. Without those two, a retry loop is an open-ended bill with nobody assigned to watch it.

What follows from the picture is the quieter half of the failure: the loop was noisy to the API, yet silent to the people who owned the flow.

### Idempotency keys and alerts for API failures

Before the error came back, some retried requests had in fact succeeded, so the retry processed the same record twice. The duplicate cards in the illustration pile up past the gate for that reason.

![A narrow gate with a few record cards passing through; on the far side two identical copies of the same card lie stacked…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/a5d6f58b-fd00-42a4-aa16-49b302cf3101/hindsight-models-inference-api-setup-and-pricing-0b25632b.webp)

To fix it, use an idempotency key per record and a done-marker written only after a confirmed result, so a repeat is recognised and skipped.

Then there is the bell that never rang. Nothing counted rejections, nothing flagged a record that exhausted its attempts, and nothing paged a named person.

A flow with no alert and no owner fails correctly, in the sense that it does exactly what it was built to do, **until someone notices the bill or the backlog**.

## Fix it in a workflow with Activepieces: the rules that changed

The rules go into the flow by hand, and whoever builds the flow owns them. The connection options, in order of simplicity:

1. An HTTP request step.
2. An AI step pointed at a custom or OpenAI-compatible provider.
3. An MCP server.

The rules can also be described rather than assembled step by step.

Describe the retry cap, the done-marker and the alert in Activepieces' built-in chat, and what it publishes is a live flow in your account, editable like one a builder assembled by hand, with a run trace for every execution showing exactly what happened.

![Activepieces workflow builder showing a Skyvern agent task step with API configuration fields and failure handling options.](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/e773f985-47ff-4e08-b329-e17a067db6e5/activepieces-vs-temporal-for-workflow-automation-4b459e5d.webp)

It sits under the same RBAC and audit logs as every other flow, and MoneyGram, Moneypenny, Alan and FundingSocieties run Activepieces in production.

### Option 1: the HTTP request step

Start here. It calls the API directly, so every header, timeout and error code stays visible to you.

The cost of a bad retry is the part people miss. On the [Activepieces pricing page](https://www.activepieces.com/pricing), Free carries 1,000 credits a month, and a large batch of runs, especially with AI steps, or repeated test runs can use it up faster than expected.

![Monthly task credits by Activepieces plan](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/447adbdb-9401-46b3-8a4b-25f57e4e450c/hindsight-models-inference-api-setup-and-pricing-afc52221.svg "Source: Activepieces")

With your own AI keys on Plus and up, every AI step costs 1 credit and the model cost goes to your own provider bill.

Plus carries 10,000, which buys room but also lets a runaway loop burn for longer before anyone notices.

On Team, which carries 50,000, a loop can run unattended for days and the invoice becomes your alert. Next come the connections that add less control.

Option 2, an AI step with a custom provider: use this only if the AI step accepts a custom base URL and Hindsight's endpoint speaks the OpenAI request format.

I haven't confirmed either, so do not build on it before testing one request. Where it works, you trade control over errors and retries for convenience.

Option 3, an MCP server: treat this as unavailable until Hindsight publishes an MCP server. Without one, there's nothing to connect.

The five rules now in the flow:

1. Retry only on rate-limit and server errors, a fixed number of times, with a growing delay between attempts.
2. Never retry a client error such as a malformed request. It will fail identically every time.
3. Cap each run's call count and each day's total, so a loop stops well short of your plan's credits.
4. Store a unique key per input record and check it before calling, so a restarted batch skips finished work.
5. Alert a named person when a cap trips or retries run out.

Monday checklist:

- Confirm the flow has a named owner.
Run ten records through it before the full batch, so you'll catch configuration problems before scaling to the full dataset.
- Check that the alert reaches a real inbox.

## Frequently asked questions

None of the four questions below is answered by the Hindsight docs I can cite, and each one decides who gets paged when a flow stops working.

The table records what the docs state for each, so you can tell a documented fact from an assumption before you build on it.

| Question | What the Hindsight docs state | Source link |
|---|---|---|
| Free tier | Docs silent | None to cite |
| Client-library compatibility | Docs silent | None to cite |
| Key rotation | Docs silent | None to cite |
| Where pricing and limit changes are posted | Docs silent | None to cite |

With every row reading "docs silent", each answer below is a rule for working around the gap, not a fact about the service. Put a named owner on each gap before the first real batch.

### Is there a free tier for the Hindsight models inference API?

Plan as if there's no free tier, because the docs are silent on one. A flow that quietly depends on free usage fails the first time the account is billed or throttled.

Ask the vendor in writing, keep the answer with the flow's runbook, and set your own spend cap in the flow so a loop can't create the bill for you.

### Is the Hindsight API compatible with OpenAI client libraries?

Do not assume compatibility with OpenAI client libraries; the docs state nothing on it.

A library that appears to work on one request may mishandle error bodies, retry headers or streaming, and those are the paths a first request never exercises.

If you test a library, test it against a forced failure, not only a success, and record which version you tested.

For rotating or revoking a Hindsight API key, the docs describe no procedure. That makes key ownership your problem: record who issued each key, where it's stored and who can replace it.

![A workflow builder showing a Skyvern step selected with its configuration panel open on the right, displaying API Key and…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/f8e7c6dd-e9bb-4aff-a41a-53393d8279d8/applied-epic-ai-integration-a-2026-guide-for-age-a415e648.webp)

Keep keys in one secret store, not copied into individual flows, so that if the vendor offers no rotation path you can at least replace a key in one place.

### Where do I check for changes to Hindsight pricing and limits?

Nobody will warn you by default: the docs name no changelog, status page or notice channel for pricing and limit changes. So assign one person to check the vendor's pages on a schedule and to read account emails.

![A person at a desk facing a wall calendar with every square empty, back turned to a window where a worker on a ladder…](https://ap-marketing-media.fra1.cdn.digitaloceanspaces.com/uploads/3364c2e0-d701-426f-a714-648dc965dca1/hindsight-models-inference-api-setup-and-pricing-d68fec0b.webp)

Have the flow log every limit or rate error it receives, because a sudden rise in those errors may be the first sign that a limit changed.

## Related reading

- [Hindsight Models for Agent Memory: What Each Does](https://www.activepieces.com/blog/hindsight-models-for-agent-memory-what-each-does)
- [Hugging Face Inference API Pricing: A 2026 Guide](https://www.activepieces.com/blog/hugging-face-inference-api-pricing-a-2026-guide)
- [DeepInfer (2026): DeepSeek's Inference Framework, Oct 20](https://www.activepieces.com/blog/deepinfer-2026-guide)

## References

- [Activepieces](https://www.activepieces.com/pricing)
- [Deploybase, Standard Compute, Google AI forum](https://deploybase.ai/articles/llm-api-rate-limits-compared-all-providers)
- [Rewindex](https://rewindex.com/company/anthropic/reports)
