IronStratum Get an API key

Classification API: taxonomy labels, typed extraction, or decision scores

A classification API takes text in and hands back a label: what this page is about, which of my types appear in this document, which choice wins. Buyers searching this product type meet two walls of noise. One is the chat-model marketing that treats labeling as a prompt-engineering chore. The other is the enterprise suite that sells the same three routes at suite prices. The decision that actually matters is simpler: name the labeling job, and the route follows. This platform's classification category is built as three routes over that choice, and this page states where each one stands. All six lanes answer calls as of September 25, 2026. What follows is the framework for choosing a route, what the model classes behind them are, and what the open-weights road looks like.

Last verified: 2026-09-25

What a classification API does

The service contract is a small one, and that is the point. Text goes in. A label, or a set of labels with scores, comes out. Everything a buyer needs to know is in how the label set is defined.

Three ways to define it cover the market. One is a fixed standard label set, owned by an industry body. Every participant labels against the same list, so a label means the same thing on both sides of a transaction. Another is a caller-owned label set, where the types travel with the request and change per call. The last is a choice set: the caller supplies the options, and the model returns a score per option. Those three definitions produce three different products, and the strongest search results rarely separate them.

Two neighbors get folded into the same searches and should not be. A chat model generates text. Used for labeling, it generates an answer that then needs parsing, at generation prices. An embedding model maps text into a coordinate space where you find neighbors by similarity. Nothing labels anything until you build that layer yourself. Classification is the direct route: the API answers with a label from a set both sides agreed on in advance.

Three routes for three labeling jobs

This platform's classification category is three routes, each with an open-weight model class behind it. Each lane page carries its complete working contract.

Taxonomy labels: the IAB lanes

The fixed-standard route. The IAB Content Taxonomy is the advertising industry's shared label set for content, maintained by IAB Tech Lab. It is the reason a publisher's "news" and a buyer's "news" can shake hands. Version 2.x is the line most live ad stacks still label against today. The 3.1 revision rebuilt the tree. The Tech Lab frames the move as roughly 400 categories growing to more than 1,500. The official files count 1,196 named entries in 2.2 including descriptor groups, and 704 in 3.1 after the restructure. That restructuring, not size alone, is why a migration industry exists around it. There is no official hosted API for the taxonomy from the Tech Lab itself, which is the gap a hosted lane fills. Two lanes cover it here. The 2.x categorization lane is for stacks that still label against the legacy line. The 3.1 lane carries the cross-version map for stacks moving forward. A guide listed with this page works the 2.x to 3.1 migration end to end.

Typed extraction: zero-shot, no training loop

The caller-owned route. GLiNER is the open model class introduced in its 2023 paper. It takes a type list as part of the request and finds mentions of those types in text it has never seen, with no fine-tuning step on your data. Swap the type list, and the same call extracts invoice fields, contract clauses, or safety-relevant mentions. Adding a type is a text edit rather than a retrain. That property is what made the class a standard building block. The extraction lane page carries the request shape, the honest comparison against prompting a chat model for the same job, and the limits.

Decision models: score instead of generate

The choice-set route. The class became visible through one vendor's closed-weight decision system, and a family of open-weight classmates has since landed. The 421M parameter fast lane scores in tens of milliseconds. The 2B causal lane is for passes that need the bigger reasoner. The encoder lane is built for text batch work at volume. All three answer the same call shape: choices in, scores out. Cost shape is the story: scoring a choice is a smaller job than generating prose. The flows that run thousands of scores an hour, routing, ranking, triage, approval, are where the class costs less than the generate-then-parse pattern. The decision-model guide listed with this page explains the family from the ground up. It covers the closed-weight original and what the open classmates do and do not carry over.

One more model belongs to this set, and it is not a classifier. It is a multimodal embeddings model for text, images, and video. It belongs to the embeddings category, and its lane page carries it.

Choosing by the job

The fastest route to a decision is to name the labeling job, not the model.

The job you haveThe routeWhy
Label ad inventory against the industry standardIAB lanesThe label set is fixed by the standard; correctness means version fidelity and coverage
Find your own types in text, types that change per requestTyped extractionThe type list travels with the call; no training loop, no retrain to add a type
Score choices at volume: route, rank, triage, approveDecision modelsA score is cheaper and faster than generated prose; the call shape is choices in, scores out
Search by similarity across text, images, videoEmbeddingsNearest-neighbor search is a different job; no label set involved

One honesty note belongs next to that table. A fixed taxonomy is only as good as its version discipline. Labels applied against 2.x do not mean the same thing as 3.1 labels, and the migration between them is real work, which is why it gets its own guide here. Zero-shot is strong at finding mentions but is not a substitute for a trained model when the label set is stable and the accuracy bar is high. The extraction lane page states where that line sits.

The classification catalog on this platform

This section states the offering at offering level. The models table on this page is machine-generated from the platform's own model data, and that data decides what serves. The table renders the taxonomy and extraction lanes; the three decision lanes are chat-route rows, so they render in the chat catalog and link from here.

Every lane named above is a serving model page: the model identity, its license, the use cases, and the exact request the hosted lane takes. The aliases answer calls, the lanes meter, and each rate renders on the pricing page. The models index shows every row's current state at any moment.

The metering is live. The taxonomy lanes meter by the page, the extraction lane by the search, and the decision lanes by the token, all paid from the prepaid wallet. A call that arrives after the balance is gone is refused with a named error rather than overrunning the deposit. A request the gateway turns away before relaying is never metered, so refusals cost nothing. Each rate renders on the pricing page from the platform's model data, which is why no number is typed here.

Running the models yourself

Every model class behind these lanes ships open weights, so the weights are not what a hosted lane sells. GLiNER trains and runs on a single GPU and has a plain Python path. The decision family spans three sizes on permissive weights: Apache 2.0 for the fast lane, Apache 2.0 for the causal lane, and Apache 2.0 for the encoder lane. That lane's deberta base is the MIT one. The smallest of them is laptop-scale. The IAB taxonomy itself is a published standard, so the label set was never the moat either. What a hosted lane sells is the service around the models. That service is an endpoint that stays up through a labeling spike, meters every request, and leaves the model-ops work on someone else's desk.

Running it yourself wins when the text must not leave your boundary, when volume is high and steady enough to justify a machine, or when you are tuning the model itself. The hosted lane earns its keep under the opposite conditions. The labeling is a means to an end. The type lists change per customer. Or the accuracy drift of a self-run open model on your own data is a risk nobody on the team owns. The lane pages each carry their own version of that trade.

Getting started

  1. Request an invitation through the console. The beta is invite-only for now; the wallet, API keys, and full spend history live there, and an account opened today can call every classification lane.
  2. Name the labeling job before the model. The table above routes the job to the lane; the lane page then carries the exact request to copy.
  3. Read the guide that matches the job. The migration guide covers the 2.x to 3.1 jump; the decision-model guide covers the fast, causal, and batch lanes from the ground up.
  4. The models index is the availability truth. Every row's rate renders on the pricing page, and the index shows each row's current state.

Everything else the platform serves is mapped on the models index. Chat, speech, transcription, embeddings, rerank, document parsing, and image generation all draw from one wallet.

The catalog table

Specialty models — kind and unit price
ModelKindPrice
iab-2xclassification$0.70 / 1k pages
iab-3xclassification$0.70 / 1k pages
gliner-extractclassification$0.90 / 1k searches

Token prices per 1M unless the unit says otherwise; a dash means the value isn't set yet — confirmed when the model goes live. Everything here is served by the same API that bills you: GET /v1/models. The full list with model details lives on the model index.

Guides

Questions

What is a text classification API?
It is an HTTP service that takes text in and returns labels from a defined set, usually with a confidence score. The label set is the distinguishing part. Some services label text against a fixed industry standard. Some let you send your own type list with the request. Some score a set of choices, which is what decision models do. The term sits next to two neighbors it is often confused with. A chat model generates new text rather than choosing labels. An embedding model maps text to a coordinate you search by similarity. A classification API is the one that answers with a label.
What is the IAB Content Taxonomy?
It is the advertising industry's standard label set for what a page or a video is about. It is the backbone of content classification in digital advertising, published by IAB Tech Lab. Most live ad stacks still run the 2.x line. The current 3.1 revision is a restructure, not just growth. The Tech Lab frames the counts as roughly 400 categories against more than 1,500. The official files count 1,196 named entries in 2.2 including descriptor groups and 704 in 3.1. That is why the 2.x to 3.1 migration is its own project. Publishers and ad platforms label inventory against it so that buyer-side controls mean the same thing everywhere. This platform has two lanes built around it. One covers 2.x categorization, and one covers 3.1 with the cross-version map. A guide on the migration itself is listed with this page.
Can I classify text into my own labels without training a model?
Yes, that is what zero-shot extraction is. GLiNER, the open model class built for it, takes your type list as part of the request and finds mentions of those types in the text without a training loop on your data. You swap label sets per request, and adding a type is a text edit, not a retrain. This platform's extraction lane is built around that mechanism, and the lane page carries the exact request shape and the limits that come with it.
What is a decision model?
It is a classifier built to score choices rather than write prose. The class became visible through one vendor's closed-weight system, and a family of open-weight classmates now exists. One is a 421M parameter model that scores in tens of milliseconds. Another is a 2B model that reasons before it decides. The last is an encoder variant that labels text in batches. The practical difference from a chat model is cost and latency: scoring a choice is a smaller job than generating an essay. Routing, ranking, and approval flows that run thousands of times an hour are where the class earns its keep. The decision-model guide linked from this page works through the whole family.
What does classification cost on this platform?
The taxonomy lanes meter by the page, the extraction lane by the search, and the decision lanes by the token. Every rate comes from the platform's own model data and renders on the pricing page. That page is where every listed model's rate lives, and where a change shows first. Spend on any lane draws down a prepaid wallet. An empty wallet refuses the next call with a named error instead of overrunning the deposit. No number is typed on this page by design.
Can I call these classification lanes today?
Yes. All six lanes answer calls as of September 25, 2026: the two IAB lanes, the extraction lane, and the three decision lanes. The decision lanes serve on the chat completions route under their own model ids; the taxonomy and extraction lanes serve on the classification routes. Access runs through the console's invite flow with a wallet top-up. The models all ship open weights, so a local setup remains open to anyone.