text-moderation

text-moderation-stable

by OpenAI · Retired; access ended October 27, 2025

OpenAI's text-moderation-stable alias provided free text safety classification through the Moderation API. It used the text-moderation-007 snapshot, returned category flags and confidence scores, accepted text only, and was retired on October 27, 2025 in favor of omni-moderation.

Text Reasoning Coding
text-moderation-stable was OpenAI's stable alias for a text-only safety-classification model. It assessed submitted text for categories including harassment, hate, violence, sexual content, and self-harm, returning structured flags and scores rather than conversational responses. The alias and its text-moderation-007 snapshot are retired, so new integrations should use OpenAI's newer omni-moderation family.
Outputs

What text-moderation-stable can produce

Text
Inputs

What it can understand

Text
Capabilities

Supported features

Structured output Batch API
Model profile

Performance characteristics

1/10 Reasoning
1/10 Coding
8/10 Speed
10/10 Cost efficiency
Specifications

Technical details

Model family text-moderation
Model type Other
Maximum output 33K tokens
Knowledge cutoff September 1, 2021
Release date 2024-01-25 alias update to text-moderation-007
Status Retired; access ended October 27, 2025
Deprecation date 2025-04-28
Shutdown date 2025-10-27
Knowledge cutoff notes

The official model page identifies September 1, 2021 as the model's knowledge cutoff. This is the underlying model cutoff and is not changed by application-supplied context or external moderation policy.

Model notes

This stable alias resolved to the text-moderation-007 snapshot. OpenAI announced deprecation and removal on April 28, 2025, with shutdown on October 27, 2025. The model accepted text and returned structured moderation categories, flags, and scores. OpenAI recommended omni-moderation as the replacement. The official model page lists 32,768 maximum output tokens and a September 1, 2021 knowledge cutoff, but does not provide a separate context-window value.

Cost

Model pricing

Input Free through the Moderation API
Output Free through the Moderation API
Model guide

text-moderation-stable: Capabilities, Moderation API and Retirement

text-moderation-stable was OpenAI's previous-generation, text-only moderation model. It resolved to the text-moderation-007 snapshot, classified potentially harmful text through the free Moderation API, and returned category flags and confidence scores. OpenAI retired it on October 27, 2025, recommending omni-moderation as the replacement.

What was text-moderation-stable?

text-moderation-stable was an OpenAI model alias for detecting potentially harmful content in text. It was not a general-purpose language model and was not intended to write answers, summarize documents, generate code, or take actions. Its job was narrower: evaluate text and provide moderation signals that an application could use in its own safety workflow.

The stable alias resolved to the text-moderation-007 model snapshot. OpenAI offered moderation models through the Moderation API at no charge. The model was useful for screening user submissions, checking generated text, and routing questionable content for additional review.

How the model classified text

An application submitted a text string, or an array of text inputs, to OpenAI's /v1/moderations endpoint. The response included an overall flagged decision, category-level flags, and confidence scores. Categories covered areas such as harassment, hate, violence, sexual content, and self-harm.

A flag was a signal for application policy, not a complete decision about what a user should be allowed to do. For example, a service might use a high-confidence result to block a post, send an uncertain result to a human moderator, or apply a separate rule based on the user's history and the surrounding conversation. The model's scores therefore worked best as one component in a broader review process.

Capabilities and supported modalities

text-moderation-stable accepted text input and returned structured text-based moderation results. It did not accept images, audio, or video. It also did not produce images, audio, video, embeddings, executable actions, or tool calls. Its output was a classification-style response containing moderation categories, flags, and scores.

This text-only design was an important limitation. A service receiving image captions, uploaded photographs, voice recordings, or videos could not send those raw media types to this model for direct assessment. Developers needed a separate workflow for non-text content, or a newer moderation model with broader modality support.

Technical specifications

ProviderOpenAI
Model aliastext-moderation-stable
Underlying snapshottext-moderation-007
Primary taskText safety classification
InputText
OutputStructured moderation categories, flags, and confidence scores
Knowledge cutoffSeptember 1, 2021
Maximum output tokens32,768
Context-window valueNot separately provided in the supplied documentation
API priceFree through the Moderation API
Deprecation announcementApril 28, 2025
Access endedOctober 27, 2025

The documented maximum output-token figure should not be interpreted as a promise that ordinary moderation responses would use that many tokens. Moderation responses are structured classification results, and the supplied model information does not provide a separate context-window specification.

Strengths and trade-offs

The model's main strength was specialization. Because it focused on text safety classification rather than open-ended generation, it fit applications that needed a straightforward moderation check. Its free API pricing also made it practical for legacy systems that needed to screen substantial volumes of text without adding a separate per-token moderation charge.

It was also easy to reason about operationally: submit text, inspect the category results, and apply application-specific rules. The returned category scores could support different thresholds for different risks instead of forcing every category into the same yes-or-no policy.

Its main trade-off was limited scope. It was text-only, tied to an older model snapshot, and designed for a narrower moderation task than newer multimodal systems. It was not a replacement for human review, identity or abuse controls, rate limiting, account enforcement, or policy logic. OpenAI also stated that the Moderation API was not designed to handle known or suspected child sexual abuse material and should not be treated as a dedicated child-safety system.

Reasoning, coding, and tool support

text-moderation-stable was not a reasoning or coding model in the usual sense. It did not provide general chain-of-thought reasoning, code generation, code execution, browsing, function calling, or external tool use. Any apparent sophistication in its category scores should be understood as classification behavior rather than a general reasoning capability.

For an application, this distinction matters. A moderation result could help decide whether another model's generated answer should be shown, revised, or reviewed, but text-moderation-stable could not itself rewrite the answer, explain a policy to the user, or investigate additional context through a tool.

Pricing and availability

When it was available, text-moderation-stable was free through OpenAI's Moderation API. That pricing applied to the moderation endpoint rather than representing a general free tier for OpenAI's other models or services.

The alias was deprecated on April 28, 2025, and access ended on October 27, 2025. As a result, it is a retired model rather than a viable choice for a new production integration. Existing systems that still refer to the alias should be migrated and tested against the recommended replacement instead of assuming that the old behavior remains available.

Replacement: omni-moderation

OpenAI recommended omni-moderation-latest as the replacement. The replacement belongs to a newer multimodal moderation direction and supports text and image inputs, whereas text-moderation-stable handled text only. The two models should not be treated as behaviorally identical: a migration can change category decisions, thresholds, response details, and handling of edge cases.

OpenAI also has a dedicated page for Omni Moderation, which is useful when evaluating the successor's broader input support. Applications should compare the replacement on representative content, calibrate policy thresholds, and confirm how the new response format fits existing enforcement logic.

When to choose text-moderation-stable

For a current project, there is no supported reason to choose this model because access ended in October 2025. Its historical role is still relevant when maintaining or auditing a legacy integration. In that context, the model's profile was a good fit for:

  • Legacy text-only applications that needed a basic harmful-content classification step.
  • Systems that relied on category flags and confidence scores for automated routing.
  • Historical analysis of decisions made by the text-moderation-007 snapshot.
  • Documentation or migration work involving older OpenAI Moderation API integrations.

It was not an appropriate choice for new applications, direct image moderation, audio or video moderation, general-purpose reasoning, code generation, or workflows requiring current model support. New systems should evaluate omni-moderation-latest or another currently supported moderation option, particularly when content can include images as well as text.

Bottom line

text-moderation-stable was a focused, free, text-only OpenAI moderation model that returned category flags and confidence scores through the Moderation API. Its specialization and cost made it useful for earlier text-screening workflows, but its older snapshot, lack of multimodal input, and absence of general-purpose generation or tool capabilities limited its scope. Because OpenAI retired it on October 27, 2025, its practical importance today is mainly as a legacy model that must be replaced rather than deployed.


Answers to Frequently Asked Questions

Was text-moderation-stable free to use?
Yes. When available, text-moderation-stable was provided at no charge through OpenAI's Moderation API. This free pricing applied to the moderation endpoint and did not represent a general free tier for other OpenAI models or services.
What replaced text-moderation-stable?
OpenAI recommended omni-moderation-latest as the replacement. It supports text and image inputs, but its behavior, response details, category decisions, and thresholds may differ from the older text-moderation-007 snapshot.
Is text-moderation-stable still available?
No. OpenAI deprecated text-moderation-stable on April 28, 2025, and access ended on October 27, 2025. It is now a retired model and should not be used for new production integrations.
What inputs and outputs did text-moderation-stable support?
The model accepted text input, including arrays of text, and returned structured moderation categories, flags, and confidence scores. It did not support images, audio, video, embeddings, code generation, tool calls, or executable actions.
What was text-moderation-stable used for?
text-moderation-stable was an OpenAI model alias for detecting potentially harmful content in text. It returned an overall flagged decision, category-level flags, and confidence scores through the Moderation API.


Sources 6
Provider

About OpenAI