Choosing a Model, and Reading the Models Page Instead of Memorizing Names

Ma Mahalakshmi V Updated 13 Sep 2026
9 min read ·Lesson 10 of 224

Why This Lesson Exists

Unit 1 already made one point that's worth restating before going further: model names change faster than almost anything else in this ecosystem. gpt-6-astra and gpt-5.6-luna are today's names; by the time you're reading this, OpenAI may well have shipped another generation. If this lesson taught you to memorize "use gpt-5.6-luna for cheap tasks," that advice would quietly expire and you wouldn't necessarily notice — your code would keep running against a model that's no longer the best (or cheapest, or fastest) option for the job.

So instead, this lesson teaches you two things that don't expire: a decision process for picking a model based on what your task actually needs, and how to read OpenAI's models and pricing pages so you can apply that process to whatever models exist when you're actually building.

The Decision Process: Accuracy First, Then Cost and Speed

OpenAI's own model-selection guidance boils down to a specific order of operations, and it's worth following rather than reinventing:

1. Start with the most capable model you have access to, and establish whether it can do the task at all. Before optimizing for cost, confirm the ceiling — build a small evaluation set (even 10–20 representative examples of your actual task) and run it against the strongest available model, currently something like gpt-6-astra. If even the most capable model can't reliably do what you need, no amount of model selection further down the list will fix that; you have a task-design problem, not a model-selection problem.

2. Once you have a working baseline, work backward toward "cheapest and fastest model that still hits your accuracy target." This is the part people skip, and it's where real money gets left on the table. A huge share of production AI features — classifying a support ticket's category, extracting a name and date from text, answering a narrow FAQ — do not need a flagship reasoning model. They need a small, fast, cheap model that's good enough, run against the same evaluation set you built in step 1 to confirm it's still accurate enough once you swap down.

3. Re-run your evaluation set every time you change models. "Good enough" for one prompt and one task is not transferable — always verify empirically rather than assuming a cheaper model will behave the same way a more capable one did.

This process matters more than any specific model name, because it's the same process whether you're choosing between today's four model tiers or a completely different lineup two years from now.

The Axes That Actually Differentiate Models

When you open OpenAI's models page, you'll see each model described along a handful of consistent axes. Understanding what each one means lets you read that page intelligently instead of pattern-matching on names.

Capability tier. Models are generally organized into a small number of tiers — a flagship/frontier tier (maximum capability, highest cost), one or two mid tiers, and a lightweight/fast tier. As of this writing, OpenAI's lineup looks roughly like this:

ModelTierInput (per 1M tokens, short context)Output (per 1M tokens, short context)
gpt-6-astraFlagship / advanced reasoning$10.00$50.00
gpt-5.6-solHigh-performance$4.00$20.00
gpt-5.6-terraMid-tier$2.00$12.00
gpt-5.6-lunaLightweight / fast$0.20$1.20

Treat every number in that table as a snapshot, not a fact to memorize. Prices move, tiers get renamed, and new models slot in above or below existing ones. What's durable is the shape of the table: there is consistently a spread of roughly 50x between the cheapest and most capable models, and that spread is the entire reason step 2 of the decision process above matters — picking the wrong tier for a high-volume task can mean paying fifty times more than necessary for no accuracy benefit.

Context window: short vs. long. Notice the pricing table above only shows "short context" rates — most current models actually have two pricing tiers depending on how much text you're sending in a single request (a "long context" rate applies above a certain input size, and it's noticeably higher — for gpt-6-astra, roughly double). This matters directly for cost planning: a task that processes long documents needs its cost estimated at the long-context rate, not the headline short-context number that's easiest to remember.

Reasoning vs. non-reasoning. Some models (like gpt-6-astra, and specific reasoning-focused snapshots) do internal, extended reasoning before answering — useful for math, multi-step logic, and complex debugging, at the cost of higher latency and more output tokens (since reasoning consumes tokens too, billed at the output rate, even when you don't see the reasoning text itself). Others are tuned for fast, direct responses without that extended reasoning step. Unit 3 covers how to control this behavior explicitly via reasoning_effort; for model selection purposes, the takeaway is: don't reach for a reasoning-tier model for tasks that don't need multi-step logic — you'll pay more and wait longer for no benefit.

Caching discount. Every current model offers a steep discount — roughly 90% off the standard input rate — for tokens the API recognizes as repeated from a recent prior request (this is the same caching behavior referenced in Lesson 1's discussion of why the Responses API improves cache hit rates). If your application repeatedly sends a large, mostly-unchanging block of instructions or context, this discount can dominate your actual cost far more than the headline per-token price does.

Specialized variants. Beyond the general-purpose tiers, OpenAI publishes narrower models for specific jobs — for example, a coding-specialized model (gpt-5.3-codex in the current lineup) or a chat-optimized snapshot (chat-latest). These exist because a model tuned for one job can outperform a larger general-purpose model at that specific job, often at a lower price. Don't assume "biggest general model" beats "smaller specialized model" for a specialized task — check, using the same evaluation-driven process as everything else in this lesson.

Reading the Models Page Itself

When you open OpenAI's models documentation, resist the urge to just find a name that looks familiar and copy it. Instead, look for these specific things:

The model ID column — the exact string you'll pass as model=. Copy this precisely; a nearly-correct model ID fails with an error rather than silently falling back to something close.

Aliases vs. dated snapshots. OpenAI generally publishes both a rolling alias (something like gpt-5.6-terra, which points at "whatever the current best terra-tier snapshot is") and specific dated snapshots (something like gpt-5.6-terra-2026-08-15, frozen at that exact version forever). This distinction matters for a real engineering decision:

  • Use the rolling alias during development, prototyping, and for most applications where you want to automatically benefit from quality and safety improvements as OpenAI updates the underlying snapshot.
  • Pin a specific dated snapshot for production systems where behavioral consistency matters more than automatically getting the newest version — for example, if your prompts were carefully tuned against one specific snapshot's behavior, and an automatic upgrade could shift outputs in ways your tests don't catch. Pinning trades "automatically getting better" for "guaranteed not to change out from under you."

Context window size, usually listed in tokens (for example, a model might support a 128,000 or 400,000 token context window). This caps how much conversation history, document text, or tool output you can send in a single request — relevant the moment you build anything in Unit 4 involving longer conversations, or Unit 7 involving large documents.

Modalities supported. Not every model accepts every kind of input — some support text only, others accept images (Unit 7), and capabilities like audio input/output or image generation are sometimes handled by entirely separate specialized models rather than a flag on a general-purpose one. Check this before assuming a model can handle whatever input type your feature needs.

Rate limits, usually documented per-tier based on your account's usage level rather than per-model — worth checking separately if you're planning a high-throughput application, since this affects how many requests per minute you can actually sustain, independent of per-token pricing.

A Practical Example: Choosing a Model for Three Different Tasks

Applying the process above to three concrete scenarios:

Classifying incoming support tickets into five fixed categories. This is a narrow, well-defined task with a small, checkable answer space — a strong candidate for the lightest tier. Build a 20-example evaluation set of tickets with known correct categories, test gpt-5.6-luna against it, and only move up a tier if accuracy falls short.

Debugging a gnarly multi-file concurrency bug from a large codebase. This is exactly the kind of multi-step reasoning task that benefits from a reasoning-capable, flagship-tier model — gpt-6-astra — where the higher per-token cost is worth paying because the task genuinely requires deeper reasoning, and getting it wrong costs more (in engineering time) than the price difference between tiers.

A customer-facing chatbot answering general product questions at high volume. This sits in the middle — probably too broad and unpredictable for the lightest tier to handle reliably, but not complex enough to justify flagship reasoning pricing at high volume. A mid-tier model like gpt-5.6-terra, validated against a representative evaluation set of real customer questions, is the natural starting point — with room to reconsider if evaluation reveals specific categories of questions it handles poorly.

Common Mistakes

Defaulting to the flagship model for everything "to be safe." This treats model selection as a cost-blind decision, and given the roughly 50x price spread across tiers shown above, it's often the single most expensive mistake in an OpenAI-powered application's budget.

Defaulting to the cheapest model for everything "to save money." The inverse mistake — without an evaluation set confirming the cheap model actually performs the task correctly, you're trading a knowable cost for an unknowable accuracy risk.

Hardcoding a specific dated snapshot everywhere out of caution, then never revisiting it. Pinning is a legitimate choice for stable production systems, but pinning and then forgetting means you never benefit from real improvements — and eventually, older snapshots do get formally deprecated and stop working, which is a worse surprise than a planned upgrade.

Comparing prices without accounting for context length. Estimating cost using only the short-context rate for a workload that regularly exceeds the context threshold will noticeably underestimate your actual bill.

Best Practices

Build a small, representative evaluation set for any task before you commit to a model tier — it's the only reliable way to know whether "cheaper" still means "accurate enough" for your specific use case. Use rolling aliases during development and reserve pinned dated snapshots for production systems where consistency matters more than automatic improvement. And revisit this decision periodically: because model names, tiers, and prices genuinely do change over time, treat "which model should this feature use" as a question worth re-asking every few months, not a decision you make once and never touch again.

0 Comments

Reviewed before they appear

No comments yet.

OpenAI SDK
Introduction to the OpenAI SDK Setting Up Python Creating an API Key Your First Call — client.responses.create() and response.output_text Understanding Billing, Credits, and What a Request Costs Why Responses Replaced Chat Completions Anatomy of a Request: model, input, and instructions Anatomy of a Response: The Typed output Array, Not Just Text Roles: User, Assistant, and Developer/System Choosing a Model, and Reading the Models Page Instead of Memorizing Names Instructions vs. Input Writing Prompts That Get Consistent Results Few-Shot Examples Reasoning Models and the reasoning Parameter Debugging a Prompt That Misbehaves Why Streaming Matters for User Experience stream=True and Iterating Over Events Handling the Event Types You Actually Care About Background Mode for Long-Running Jobs Project — Add Live Streaming to Your Chatbot The Problem With Parsing Free Text JSON Schema and Strict Mode Pydantic Models With the SDK's Parse Helpers Handling Refusals and Validation Failures Project — A Resume-to-JSON Extractor Working With input_image input_file, PDFs, and the Files API Image Generation Speech-to-Text and Text-to-Speech Project: A PDF Question-Answering Script What Function Calling Is Defining a Tool Schema The Full Loop Multiple Tools Errors, Timeouts, and Untrusted Arguments Project: A Weather Assistant Web Search File Search and Vector Stores Code Interpreter Remote MCP Servers and Connectors Project: A Research Assistant What an Embedding Is, Without the Maths Generating and Storing Embeddings Similarity Search From Scratch Hosted Vector Stores vs. Rolling Your Own A Small RAG App Over a Folder of Notes Agents vs. a Single API Call — When You Need One pip install openai Giving Agents Tools Handoffs and Multi-Agent Triage Guardrails and Approvals Tracing and Observing What Your Agent Did A Multi-Agent Support Desk Error Codes and What Each One Means Retries, Timeouts, and Backoff Rate Limits and Spend Limits Prompt Caching and Cost Optimisation The Batch API for Bulk Work Async Clients and Concurrency Moderation and Safety Best Practices Designing the App Backend With FastAPI Streaming to a Simple Frontend Deploying and a Cost/Safety Checklist Why Web Search Is Useful for Current Information Using the Web Search Tool with the Responses API Configuring Search Behavior for Application Use Cases Understanding Citations and Source Attribution Where to Go Next Building a Research Assistant with Web Search Combining Web Search with Structured Outputs Handling Conflicting or Low-Quality Web Sources Reducing Unsupported Claims with Grounded Generation Testing Freshness-Sensitive AI Answers Production Considerations for Web-Grounded Applications Understanding File Search and Retrieval-Augmented Generation Creating and Organizing Vector Stores Uploading Documents for Retrieval Connecting Vector Stores to Responses API Requests Designing Document Metadata and Filtering Strategies Building a PDF Question-Answering Application Improving Retrieval Quality With Better Document Preparation Handling Missing Evidence and Retrieval Failures Combining File Search With Web Search Building a Production Knowledge-Base Assistant What the Code Interpreter Tool Is Designed For Running Python-Based Analysis Through the OpenAI SDK Uploading Datasets for Analysis Analyzing CSV and Spreadsheet Data Generating Charts and Data Summaries Handling Generated Files and Downloadable Artifacts Building a Data-Analysis Assistant Combining Code Execution with Structured Outputs Validating Generated Calculations and Results Security and Sandbox Considerations for Code Execution Understanding Multimodal Input with the OpenAI SDK Sending Images to a Model Image Analysis from URLs and Uploaded Files Extracting Text and Information from Screenshots Building an Image-Question-Answering Application Combining Image Input with Structured Output Analyzing Multiple Images in One Request Handling Image Quality and Input Limitations Designing Multimodal Prompts for Reliable Results Building a Practical Vision-Powered Python Application Understanding Speech-to-Text and Text-to-Speech Workflows Transcribing Audio with the OpenAI SDK Working with Uploaded Audio Files Handling Timestamps and Transcription Metadata Building a Meeting Transcription Workflow Generating Spoken Responses from Text Handling Long Audio and Processing Failures Combining Audio with Text and Tool Calling Building an End-to-End Python Voice Application What Embeddings Are and When to Use Them Generating Embeddings With the OpenAI API Preparing Text for Embedding Comparing Vectors With Cosine Similarity Building a Simple Semantic Search Engine in Python Storing Embeddings in a Database Metadata Filtering for Semantic Search Chunking Strategies for Better Retrieval Evaluating Semantic Search Quality Building a Document Similarity Application When Batch Processing Makes Sense Designing Large-Volume AI Processing Pipelines Using Asynchronous Python with the OpenAI SDK Running Concurrent Requests Safely Controlling Concurrency and Avoiding Rate Limits Tracking Batch Job Progress Handling Partial Failures in Bulk Workloads Retrying Failed Items Without Duplicating Successful Work Designing Resumable AI Processing Jobs Building a Production Batch-Processing Pipeline Batch Processing Makes Sense Large-Scale AI Processing Pipelines Async Python with OpenAI SDK Safe Concurrent Requests Concurrency & Rate Limits Batch Progress Tracking Partial Failure Handling Safe Retry Handling Resumable AI Jobs Production Batch Pipeline System–User Data Separation Reusable App Instructions Prompt Templates & Variables Extraction & Classification Prompts Summarization & Transformation Prompts Explicit Output Requirements Prompt Version Management Prompt Testing & Evaluation Reusable Python Prompt Library API Key Security Secure API Key Storage Secure Secret Management Prompt Injection Prevention Trusted vs. Untrusted Content Tool Argument Validation Sensitive Data Handling Secure Logging AI Action Authorization Production AI Security Checklist Why AI Applications Need Evaluation Beyond Unit Tests Unit Testing OpenAI SDK Integration Code Mocking API Responses in Python Tests Testing Structured Outputs Against Schemas Testing Tool-Calling Workflows Building a Small Evaluation Dataset Measuring Accuracy, Consistency, and Failure Rates Regression Testing Prompts and Model Changes Human Evaluation Versus Automated Evaluation Creating a Repeatable Evaluation Pipeline AI Request Monitoring Token Cost Management Usage Metrics Design Reducing Model Calls Prompt & Context Optimization Model Selection & Optimization AI Caching Strategies Interactive Latency Optimization Usage Dashboards & Budget Alerts Performance & Cost Checklist Every API Call Starts Fresh Fixing API Statelessness Server-Side Conversation Memory Limits of Response Chaining What We're Building Conversation Memory Challenges Preparing an OpenAI SDK Application for Deployment Environment-Specific Configuration for Development and Production Deploying a Python AI Service with Docker Container Health Checks and Startup Configuration Managing Secrets in Cloud Deployments Background Workers for Long-Running AI Tasks Queues and Asynchronous Job Architectures Scaling AI Workloads Horizontally Monitoring Production Incidents and Failures Production Deployment Checklist for OpenAI SDK Applications Reusable OpenAI Service Classes AI Client Dependency Injection Typed AI Responses Python Configuration Management AI Request Decorators Centralized AI Error Handling Clean SDK Abstractions Reusable OpenAI Utilities Internal AI Python Libraries SDK Integration Maintenance Production AI Chatbot Document Q&A System Web Research Assistant Customer Support Agent AI Data Analysis Assistant Image Analysis App Meeting Transcription & Summary Semantic Document Search Multi-Tool AI Agent Production OpenAI SDK App Why "It Looked Fine When I Tested It" Isn't Enough Timing Note Status Note Pre-Decision Status Note Current Availability Note
Ask about this post
AI Ask about this post

Ask questions about Choosing a Model, and Reading the Models Page Instead of Memorizing Names and get answers drawn from it.

Signed-in readers only.