Choose an OpenAI API model using the documented identifier, input capabilities and request interface. Keep your application’s evaluation criteria independent of the model’s marketing description.

Model families at OpenAI

The official model catalog groups general reasoning and text models alongside specialized capabilities. Its current model entries provide the identifiers used by the API. Official documentation.

For a shortlist, record the required input, output form, tool support and latency tolerance. A text-generation candidate is not automatically a substitute for an embedding or speech endpoint.

Define the job before selecting an identifier. An extraction application needs reliable fields and evidence handling; a coding application needs changes that pass the repository’s checks; a voice application needs an audio path whose output can be evaluated by listening. These requirements should determine the model shortlist rather than the order of a marketing catalog.

Keep model capability and application quality separate. A documented structured-output feature may help constrain shape, but you still need to check the values. A tool-capable model still needs a correct application tool loop. Write evaluation criteria for both layers and preserve the fixtures used to test them.

Compare candidates on the same task and with the same acceptance bar. Review failed cases before turning a price difference into a recommendation. A model that produces an acceptable result less often may require additional work elsewhere in the application. Record that repair effort rather than counting every generated answer as a completed task.

All models

Model catalog
ModelOfficial identifierModalitiesContext tokensInput USD / 1MOutput USD / 1MStatus
babbage-002 Reference pendingbabbage-002textNot documented$0.4$0.4Hidden
chat-latest Reference pendingchat-latesttextNot documentedNot documentedNot documentedHidden
chatgpt-image-latest Reference pendingchatgpt-image-latesttextNot documentedNot documentedNot documentedHidden
computer-use-preview Reference pendingcomputer-use-previewtextNot documentedNot documentedNot documentedHidden
computer-use-preview-2025-03-11 Reference pendingcomputer-use-preview-2025-03-11textNot documentedNot documentedNot documentedHidden
davinci-002 Reference pendingdavinci-002textNot documented$2$2Hidden
gpt-3.5-turbo Reference pendinggpt-3.5-turbotextNot documented$0.5$1.5Hidden
gpt-3.5-turbo-0125 Reference pendinggpt-3.5-turbo-0125textNot documented$0.5$1.5Hidden
gpt-3.5-turbo-1106 Reference pendinggpt-3.5-turbo-1106textNot documented$1$2Hidden
gpt-3.5-turbo-16k Reference pendinggpt-3.5-turbo-16ktextNot documentedNot documentedNot documentedHidden
gpt-3.5-turbo-instruct Reference pendinggpt-3.5-turbo-instructtextNot documented$1.5$2Hidden
gpt-3.5-turbo-instruct-0914 Reference pendinggpt-3.5-turbo-instruct-0914textNot documentedNot documentedNot documentedHidden
gpt-4 Reference pendinggpt-4textNot documentedNot documentedNot documentedHidden
gpt-4-0613 Reference pendinggpt-4-0613textNot documented$30$60Hidden
gpt-4-turbo Reference pendinggpt-4-turbotextNot documentedNot documentedNot documentedHidden
gpt-4-turbo-2024-04-09 Reference pendinggpt-4-turbo-2024-04-09textNot documented$10$30Hidden
gpt-4.1 Reference pendinggpt-4.1text1,047,576$2$8Hidden
gpt-4.1-2025-04-14 Reference pendinggpt-4.1-2025-04-14textNot documentedNot documentedNot documentedHidden
gpt-4.1-mini Reference pendinggpt-4.1-minitext1,047,576$0.4$1.6Hidden
gpt-4.1-mini-2025-04-14 Reference pendinggpt-4.1-mini-2025-04-14textNot documentedNot documentedNot documentedHidden
gpt-4.1-nano Reference pendinggpt-4.1-nanotextNot documented$0.1$0.4Hidden
gpt-4.1-nano-2025-04-14 Reference pendinggpt-4.1-nano-2025-04-14textNot documentedNot documentedNot documentedHidden
gpt-4o Reference pendinggpt-4otextNot documented$2.5$10Hidden
gpt-4o-2024-05-13 Reference pendinggpt-4o-2024-05-13textNot documented$5$15Hidden
gpt-4o-2024-08-06 Reference pendinggpt-4o-2024-08-06textNot documentedNot documentedNot documentedHidden
gpt-4o-2024-11-20 Reference pendinggpt-4o-2024-11-20textNot documentedNot documentedNot documentedHidden
gpt-4o-mini Reference pendinggpt-4o-minitextNot documented$0.15$0.6Hidden
gpt-4o-mini-2024-07-18 Reference pendinggpt-4o-mini-2024-07-18textNot documentedNot documentedNot documentedHidden
gpt-4o-mini-search-preview Reference pendinggpt-4o-mini-search-previewtextNot documentedNot documentedNot documentedHidden
gpt-4o-mini-search-preview-2025-03-11 Reference pendinggpt-4o-mini-search-preview-2025-03-11textNot documentedNot documentedNot documentedHidden
gpt-4o-mini-transcribe Reference pendinggpt-4o-mini-transcribetextNot documentedNot documentedNot documentedHidden
gpt-4o-mini-transcribe-2025-03-20 Reference pendinggpt-4o-mini-transcribe-2025-03-20textNot documentedNot documentedNot documentedHidden
gpt-4o-mini-transcribe-2025-12-15 Reference pendinggpt-4o-mini-transcribe-2025-12-15textNot documentedNot documentedNot documentedHidden
gpt-4o-mini-tts Reference pendinggpt-4o-mini-ttstextNot documentedNot documentedNot documentedHidden
gpt-4o-mini-tts-2025-03-20 Reference pendinggpt-4o-mini-tts-2025-03-20textNot documentedNot documentedNot documentedHidden
gpt-4o-mini-tts-2025-12-15 Reference pendinggpt-4o-mini-tts-2025-12-15textNot documentedNot documentedNot documentedHidden
gpt-4o-search-preview Reference pendinggpt-4o-search-previewtextNot documentedNot documentedNot documentedHidden
gpt-4o-search-preview-2025-03-11 Reference pendinggpt-4o-search-preview-2025-03-11textNot documentedNot documentedNot documentedHidden
gpt-4o-transcribe Reference pendinggpt-4o-transcribetextNot documentedNot documentedNot documentedHidden
gpt-4o-transcribe-diarize Reference pendinggpt-4o-transcribe-diarizetextNot documentedNot documentedNot documentedHidden
gpt-5 Reference pendinggpt-5textNot documented$1.25$10Hidden
gpt-5-2025-08-07 Reference pendinggpt-5-2025-08-07textNot documentedNot documentedNot documentedHidden
gpt-5-chat-latest Reference pendinggpt-5-chat-latesttextNot documentedNot documentedNot documentedHidden
gpt-5-codex Reference pendinggpt-5-codextextNot documentedNot documentedNot documentedHidden
gpt-5-mini Reference pendinggpt-5-minitextNot documented$0.25$2Hidden
gpt-5-mini-2025-08-07 Reference pendinggpt-5-mini-2025-08-07textNot documentedNot documentedNot documentedHidden
gpt-5-nano Reference pendinggpt-5-nanotextNot documented$0.05$0.4Hidden
gpt-5-nano-2025-08-07 Reference pendinggpt-5-nano-2025-08-07textNot documentedNot documentedNot documentedHidden
gpt-5-pro Reference pendinggpt-5-protextNot documented$15$120Hidden
gpt-5-pro-2025-10-06 Reference pendinggpt-5-pro-2025-10-06textNot documentedNot documentedNot documentedHidden
gpt-5-search-api Reference pendinggpt-5-search-apitextNot documentedNot documentedNot documentedHidden
gpt-5-search-api-2025-10-14 Reference pendinggpt-5-search-api-2025-10-14textNot documentedNot documentedNot documentedHidden
gpt-5.1 Reference pendinggpt-5.1textNot documented$1.25$10Hidden
gpt-5.1-2025-11-13 Reference pendinggpt-5.1-2025-11-13textNot documentedNot documentedNot documentedHidden
gpt-5.1-chat-latest Reference pendinggpt-5.1-chat-latesttextNot documentedNot documentedNot documentedHidden
gpt-5.1-codex Reference pendinggpt-5.1-codextextNot documentedNot documentedNot documentedHidden
gpt-5.1-codex-max Reference pendinggpt-5.1-codex-maxtextNot documentedNot documentedNot documentedHidden
gpt-5.1-codex-mini Reference pendinggpt-5.1-codex-minitextNot documentedNot documentedNot documentedHidden
gpt-5.2 Reference pendinggpt-5.2textNot documented$1.75$14Hidden
gpt-5.2-2025-12-11 Reference pendinggpt-5.2-2025-12-11textNot documentedNot documentedNot documentedHidden
gpt-5.2-chat-latest Reference pendinggpt-5.2-chat-latesttextNot documentedNot documentedNot documentedHidden
gpt-5.2-codex Reference pendinggpt-5.2-codextextNot documentedNot documentedNot documentedHidden
gpt-5.2-pro Reference pendinggpt-5.2-protextNot documented$21$168Hidden
gpt-5.2-pro-2025-12-11 Reference pendinggpt-5.2-pro-2025-12-11textNot documentedNot documentedNot documentedHidden
gpt-5.3-chat-latest Reference pendinggpt-5.3-chat-latesttextNot documentedNot documentedNot documentedHidden
gpt-5.3-codex Reference pendinggpt-5.3-codextextNot documentedNot documentedNot documentedHidden
gpt-5.4 Reference pendinggpt-5.4textNot documented$2.5$15Hidden
gpt-5.4-2026-03-05 Reference pendinggpt-5.4-2026-03-05textNot documentedNot documentedNot documentedHidden
gpt-5.4-mini Reference pendinggpt-5.4-minitextNot documented$0.75$4.5Hidden
gpt-5.4-mini-2026-03-17 Reference pendinggpt-5.4-mini-2026-03-17textNot documentedNot documentedNot documentedHidden
gpt-5.4-nano Reference pendinggpt-5.4-nanotextNot documented$0.2$1.25Hidden
gpt-5.4-nano-2026-03-17 Reference pendinggpt-5.4-nano-2026-03-17textNot documentedNot documentedNot documentedHidden
gpt-5.4-pro Reference pendinggpt-5.4-protextNot documented$30$180Hidden
gpt-5.4-pro-2026-03-05 Reference pendinggpt-5.4-pro-2026-03-05textNot documentedNot documentedNot documentedHidden
gpt-5.5 Reference pendinggpt-5.5textNot documented$5$30Hidden
gpt-5.5-2026-04-23 Reference pendinggpt-5.5-2026-04-23textNot documentedNot documentedNot documentedHidden
gpt-5.5-pro Reference pendinggpt-5.5-protextNot documented$30$180Hidden
gpt-5.5-pro-2026-04-23 Reference pendinggpt-5.5-pro-2026-04-23textNot documentedNot documentedNot documentedHidden
gpt-5.6-lunagpt-5.6-lunatext1,050,000$0.2$1.2Active
gpt-5.6-solgpt-5.6-soltext1,050,000$4$20Active
gpt-5.6-terragpt-5.6-terratext1,050,000$2$12Active
gpt-6-astragpt-6-astratext1,050,000$10$50Active
gpt-audio Reference pendinggpt-audiotextNot documentedNot documentedNot documentedHidden
gpt-audio-1.5 Reference pendinggpt-audio-1.5textNot documentedNot documentedNot documentedHidden
gpt-audio-2025-08-28 Reference pendinggpt-audio-2025-08-28textNot documentedNot documentedNot documentedHidden
gpt-audio-mini Reference pendinggpt-audio-minitextNot documentedNot documentedNot documentedHidden
gpt-audio-mini-2025-10-06 Reference pendinggpt-audio-mini-2025-10-06textNot documentedNot documentedNot documentedHidden
gpt-audio-mini-2025-12-15 Reference pendinggpt-audio-mini-2025-12-15textNot documentedNot documentedNot documentedHidden
gpt-image-1 Reference pendinggpt-image-1textNot documentedNot documentedNot documentedHidden
gpt-image-1-mini Reference pendinggpt-image-1-minitextNot documentedNot documentedNot documentedHidden
gpt-image-1.5 Reference pendinggpt-image-1.5textNot documentedNot documentedNot documentedHidden
gpt-image-2 Reference pendinggpt-image-2textNot documentedNot documentedNot documentedHidden
gpt-image-2-2026-04-21 Reference pendinggpt-image-2-2026-04-21textNot documentedNot documentedNot documentedHidden
gpt-image-2.5-flare Reference pendinggpt-image-2.5-flaretextNot documentedNot documentedNot documentedHidden
gpt-image-2.5-flare-2026-09-08 Reference pendinggpt-image-2.5-flare-2026-09-08textNot documentedNot documentedNot documentedHidden
gpt-image-2.5-sunburst Reference pendinggpt-image-2.5-sunbursttextNot documentedNot documentedNot documentedHidden
gpt-image-2.5-sunburst-2026-09-08 Reference pendinggpt-image-2.5-sunburst-2026-09-08textNot documentedNot documentedNot documentedHidden
gpt-live-1 Reference pendinggpt-live-1audio-in, audio-outNot documentedNot documentedNot documentedHidden
gpt-live-transcribe Reference pendinggpt-live-transcribetextNot documentedNot documentedNot documentedHidden
gpt-realtime Reference pendinggpt-realtimetextNot documentedNot documentedNot documentedHidden
gpt-realtime-1.5 Reference pendinggpt-realtime-1.5textNot documentedNot documentedNot documentedHidden
gpt-realtime-2 Reference pendinggpt-realtime-2textNot documentedNot documentedNot documentedHidden
gpt-realtime-2.1 Reference pendinggpt-realtime-2.1textNot documentedNot documentedNot documentedHidden
gpt-realtime-2.1-mini Reference pendinggpt-realtime-2.1-minitextNot documentedNot documentedNot documentedHidden
gpt-realtime-2025-08-28 Reference pendinggpt-realtime-2025-08-28textNot documentedNot documentedNot documentedHidden
gpt-realtime-mini Reference pendinggpt-realtime-minitextNot documentedNot documentedNot documentedHidden
gpt-realtime-mini-2025-12-15 Reference pendinggpt-realtime-mini-2025-12-15textNot documentedNot documentedNot documentedHidden
gpt-realtime-translate Reference pendinggpt-realtime-translatetextNot documentedNot documentedNot documentedHidden
gpt-realtime-whisper Reference pendinggpt-realtime-whispertextNot documentedNot documentedNot documentedHidden
gpt-transcribe Reference pendinggpt-transcribetextNot documentedNot documentedNot documentedHidden
o1 Reference pendingo1textNot documented$15$60Hidden
o1-2024-12-17 Reference pendingo1-2024-12-17textNot documentedNot documentedNot documentedHidden
o1-pro Reference pendingo1-protextNot documented$150$600Hidden
o1-pro-2025-03-19 Reference pendingo1-pro-2025-03-19textNot documentedNot documentedNot documentedHidden
o3 Reference pendingo3textNot documented$2$8Hidden
o3-2025-04-16 Reference pendingo3-2025-04-16textNot documentedNot documentedNot documentedHidden
o3-deep-research Reference pendingo3-deep-researchtextNot documentedNot documentedNot documentedHidden
o3-deep-research-2025-06-26 Reference pendingo3-deep-research-2025-06-26textNot documentedNot documentedNot documentedHidden
o3-mini Reference pendingo3-minitextNot documented$1.1$4.4Hidden
o3-mini-2025-01-31 Reference pendingo3-mini-2025-01-31textNot documentedNot documentedNot documentedHidden
o3-pro Reference pendingo3-protextNot documented$20$80Hidden
o3-pro-2025-06-10 Reference pendingo3-pro-2025-06-10textNot documentedNot documentedNot documentedHidden
o4-mini Reference pendingo4-minitextNot documented$1.1$4.4Hidden
o4-mini-2025-04-16 Reference pendingo4-mini-2025-04-16textNot documentedNot documentedNot documentedHidden
o4-mini-deep-research Reference pendingo4-mini-deep-researchtextNot documentedNot documentedNot documentedHidden
o4-mini-deep-research-2025-06-26 Reference pendingo4-mini-deep-research-2025-06-26textNot documentedNot documentedNot documentedHidden
omni-moderation-2024-09-26 Reference pendingomni-moderation-2024-09-26textNot documentedNot documentedNot documentedHidden
omni-moderation-latest Reference pendingomni-moderation-latesttextNot documentedNot documentedNot documentedHidden
sora-2 Reference pendingsora-2textNot documentedNot documentedNot documentedHidden
sora-2-pro Reference pendingsora-2-protextNot documentedNot documentedNot documentedHidden
text-embedding-3-large Reference pendingtext-embedding-3-largetextNot documentedNot documentedNot documentedHidden
text-embedding-3-small Reference pendingtext-embedding-3-smalltextNot documentedNot documentedNot documentedHidden
text-embedding-ada-002 Reference pendingtext-embedding-ada-002textNot documentedNot documentedNot documentedHidden
tts-1 Reference pendingtts-1textNot documentedNot documentedNot documentedHidden
tts-1-1106 Reference pendingtts-1-1106textNot documentedNot documentedNot documentedHidden
tts-1-hd Reference pendingtts-1-hdtextNot documentedNot documentedNot documentedHidden
tts-1-hd-1106 Reference pendingtts-1-hd-1106textNot documentedNot documentedNot documentedHidden
whisper-1 Reference pendingwhisper-1textNot documentedNot documentedNot documentedHidden

Last verified · Source ↗

Inspect exact identifiers and lifecycle status, not just family names. If the live record does not contain verified evidence for a field, leave the field unresolved. The catalog is a reference for what is documented, not a promise that your particular account can call every listed model.

Keep the endpoint alongside the model in your application inventory. A Responses request, an embedding request and an audio-generation request should not be treated as interchangeable simply because they use the same provider account. The request schema and response handling belong in the model selection decision.

When reviewing a code example, copy identifiers from the current catalog rather than building them from a display label. Record which model the running application actually selected, including configuration overrides. This helps explain why a deployed worker can behave differently from an editor that appears to use the same model family.

Cheapest / strongest / longest-context

Only active candidates with documented values for this ranking are included. Prices retain the tier and deployment condition shown below.

Models ranked by input price
ModelProviderInput USD / 1MOutput USD / 1MContext tokensPrice conditionCost
gpt-5.6-lunaOpenAI$0.2$1.21,050,000StandardEstimate cost
gpt-5.6-terraOpenAI$2$121,050,000StandardEstimate cost
gpt-5.6-solOpenAI$4$201,050,000StandardEstimate cost
gpt-6-astraOpenAI$10$501,050,000StandardEstimate cost

Last verified · Source ↗

Only active candidates with documented values for this ranking are included. Prices retain the tier and deployment condition shown below.

Models ranked by context
ModelProviderInput USD / 1MOutput USD / 1MCached input USD / 1MContext tokensPrice conditionCost
gpt-5.6-lunaOpenAI$0.2$1.2$0.021,050,000StandardEstimate cost
gpt-5.6-solOpenAI$4$20$0.41,050,000StandardEstimate cost
gpt-5.6-terraOpenAI$2$12$0.21,050,000StandardEstimate cost
gpt-6-astraOpenAI$10$50$11,050,000StandardEstimate cost

Last verified · Source ↗

Price and context rankings are measurable attributes. The strongest candidate for your workflow still depends on accepted results from representative tasks.

Use numerical rankings to filter candidates, then test the survivors. Input price, output price and context capacity describe different attributes. An application that produces detailed patches should not rank candidates solely by the cost of its short user instruction. A retrieval-heavy workflow should not assume that the largest context necessarily finds evidence most accurately.

Prepare a comparison record with task quality, accepted completion, elapsed time and returned usage. Label whether each item is documented by the provider or measured by your own evaluation. Do not combine a vendor positioning statement with an unrelated benchmark into an invented overall strength score.

If you lack quality evidence, state the fit you can establish: the model accepts the required input and supports the needed interface. Leave the stronger claim unresolved. That is still a useful shortlist and gives the next evaluation a clear purpose.

Deprecations and replacements

Keep a saved baseline and review the provider’s linked deprecation guidance before changing production identifiers. Test request fields as well as response quality when moving between model generations.

Before a migration, save a baseline of requests, outputs and application checks. Inventory optional fields, output parsers and hosted features that depend on the current model or interface. An identifier change can affect more than response wording, so the test should cover the complete request path.

Read the linked lifecycle and migration guidance for the selected model. Treat a recommended replacement as a candidate to evaluate, not a guarantee of identical behavior. Keep difficult inputs and failure cases in the regression set. Make rollback a deliberate decision while the previous deployment remains available.

After adopting a replacement, update the configuration, evaluation record, budget assumptions and operating documentation together. Preserve the reason for the change and the evidence that supported it. A future maintainer should be able to distinguish a deliberate migration from an unexplained model string copied into a worker.

Naming and versions

The catalog distinguishes model IDs and, where applicable, aliases. Preserve the actual selected identifier in your application configuration. Official documentation.

Check the model’s price categories and available throughput as part of the same decision.

Use the AI API cost calculator to turn the model and workload you are considering into an estimate.

Use a display name in human-facing explanations and an exact API identifier in configuration. If an alias is offered, decide whether convenience or reproducibility is more important for this application. Preserve the actual selected identifier with evaluation results so a later review can understand what produced them.

Search the application inventory for hidden model selections before declaring a migration complete. Examples, background jobs and deployment settings can each contain their own value. Centralize the decision where practical and make changes reviewable rather than allowing every call site to choose independently.

When a model-not-found error appears, inspect the runtime value and account access. Do not replace it with a familiar name merely to get any response. Select a documented candidate that fits the task and rerun the relevant checks before restoring unattended work.

Last verified · Source ↗

Frequently asked questions

Which interface does this starter use?
It uses the Responses API through the official Python client. Official documentation.
Can I substitute a model display name?
Copy an actual API identifier from the model catalog; display names and aliases are documented separately. Official documentation.
Where should a production key live?
Load it through environment configuration or a secret-management service. Official documentation.
Does every capacity error mean I should retry?
No. The error code distinguishes throttling from credit, spend and usage limits. Official documentation.
How do I compare a model change?
Keep representative inputs and acceptance criteria fixed; measure quality, elapsed time and returned usage for each candidate.

Sources

Last verified · Source ↗