Skip to content

Guides and concepts for the OpenAI API

Endpoints, parameters, and responses

Build apps to extend ChatGPT

Build commerce flows in ChatGPT

Demo apps to get inspired

Learnings and experiences from developers

Notebook examples for building with OpenAI models

Docs, videos, and demo apps for building with OpenAI

Programs, meetups, and support for builders

Search the API docs

Search docs

Suggested

Primary navigation

Search docs

Suggested

Get started

Overview
Quickstart
Models
Pricing
Libraries
Latest: GPT-5.4
Prompt guidance

Core concepts

Text generation
Code generation
Images and vision
Audio and speech
Structured output
Function calling
Responses API

Agents

Overview
Build agents
Deploy in your product
Optimize
- Agent evals
- Trace grading
Voice agents

Tools

Using tools
Web search
MCP and Connectors
Skills
Shell
Computer use
File search and retrieval
- File search
- Retrieval
Tool search
More tools

Run and scale

Conversation state
Background mode
Streaming
WebSocket mode
Webhooks
File inputs
Context management
Prompting
Reasoning
- Reasoning models
- Reasoning best practices

Evaluation

Getting started
Working with evals
Prompt optimizer
External models
Best practices

Realtime API

Overview
Connect
Usage

Model optimization

Optimization cycle
Fine-tuning
Graders

Specialized models

Image generation
Video generation
Text to speech
Speech to text
Deep research
Embeddings
Moderation

Going live

Production best practices
Latency optimization
Cost optimization
Accuracy optimization
Safety

Legacy APIs

Assistants API

Resources

Terms and policies
Changelog
Your data
Permissions
Rate limits
Deprecations
MCP for deep research
Developer mode
ChatGPT Actions

Getting Started

Overview
Quickstart
Explore
Pricing
Community
Concepts

Using Codex

App
IDE Extension
CLI
Web
Integrations
Codex Security

Configuration

Config File
Speed
Rules
Hooks
AGENTS.md
MCP
Plugins
Skills
Subagents

Administration

Authentication
Agent approvals & security
Enterprise
Windows

Automation

Non-interactive Mode
Codex SDK
App Server
MCP Server
GitHub Action

Learn

Best practices
Videos
Blog
Cookbooks
Building AI Teams

Releases

Changelog
Feature Maturity
Open Source

Home
Quickstart

Core Concepts

MCP Apps in ChatGPT
MCP Server
UX principles
UI guidelines

Plan

Research use cases
Define tools
Design components

Build

Set up your server
Build your ChatGPT UI
Authenticate users
Manage state
Monetize your app
Examples

Deploy

Deploy your app
Connect from ChatGPT
Test your integration
Submit your app

Guides

Optimize Metadata
Security & Privacy
Troubleshooting

Resources

Changelog
App submission guidelines
Reference

Home

Guides

Get started
Best practices

File Upload

Overview
Products

API

Overview
Feeds
Products
Promotions

Home

All posts

Recent

Designing delightful frontends with GPT-5.4
From prompts to products: One year of Responses
Using skills to accelerate OSS maintenance
Building frontend UIs with Codex and Figma
Run long horizon tasks with Codex

Topics

General
API
Apps SDK
Audio
Codex

Home

Topics

Agents
Evals
Multimodal
Text
Guardrails
Optimization
ChatGPT
Codex
gpt-oss

Contribute

Cookbook on GitHub

Home
Docs MCP

Categories

Demo apps
Videos

Topics

Agents
Audio & Voice
Computer use
Codex
Evals
gpt-oss
Fine-tuning
Image generation
Scaling
Tools
Video generation

Community

Programs

Codex Ambassadors
Codex for Students
Codex for Open Source

Events

Meetups
Hackathon Support

Forum
Discord

API API Reference Codex ChatGPT Resources

API Reference
API Reference
Responses API
Webhooks
- Events
Platform APIs
- Audio
- Videos
- Images
- Embeddings
  - Create an embedding
- Evals
- Fine Tuning
  - Jobs
    Create a job
    Retrieve a job
    List jobs
    List Events
    Cancel a job
    Pause
    Resume
    Checkpoints
    List checkpoints
  - Checkpoints
    Permissions
    Create a permission
    Retrieve a permission
    Delete a permission
    List permissions
  - Alpha
    Graders
    Run
    Validate
- Batches
- Files
- Uploads
- Models
- Moderations
  - Create a moderation
Vector Stores
- Vector Stores
- Files
- File Batches
ChatKit
- Sessions
  - Create a session
  - Cancel a session
- Threads
Containers
- Containers
- Files
Skills
- Skills
Realtime
- Client Secrets
  - Create a client secret
- Calls
- Client events
- Server events
Administration
- Overview
- Organization
  - Audit Logs
    Get Costs
    List audit logs
    Admin API Keys
    Create an admin API key
    Retrieve an admin API key
    Delete an admin API key
    List admin API keys
    Usage
    Get Audio Speeches
    Get Audio Transcriptions
    Get Code Interpreter Sessions
    Get Completions
    Get Embeddings
    Get Images
    Get Moderations
    Get Vector Stores
  - Invites
    Create an invite
    Retrieve an invite
    Delete an invite
    List invites
  - Users
    Retrieve an user
    Update an user
    Delete an user
    List users
    Roles
    Create a role
    Delete a role
    List roles
  - Groups
    Create a group
    Update a group
    Delete a group
    List groups
    Users
    Create an user
    Delete an user
    List users
    Roles
    Create a role
    Delete a role
    List roles
  - Roles
    Create a role
    Update a role
    Delete a role
    List roles
  - Certificates
    Create a certificate
    Retrieve a certificate
    Update a certificate
    Delete a certificate
    List certificates
    Activate
    Deactivate
  - Projects
    Create a project
    Retrieve a project
    Update a project
    List projects
    Archive
    Users
    Create an user
    Retrieve an user
    Update an user
    Delete an user
    List users
    Service Accounts
    Create a service account
    Retrieve a service account
    Delete a service account
    List service accounts
    API Keys
    Retrieve an API key
    Delete an API key
    List API keys
    Rate Limits
    Update Rate Limit
    List Rate Limits
    Groups
    Create a group
    Delete a group
    List groups
    Certificates
    List certificates
    Activate
    Deactivate
- Projects
  - Roles
    Create a role
    Update a role
    Delete a role
    List roles
  - Groups
    Roles
    Create a role
    Delete a role
    List roles
  - Users
    Roles
    Create a role
    Delete a role
    List roles
Chat Completions
- Chat Completions
Legacy
- Realtime Beta
  - Overview
  - Sessions
    Create a session
  - Transcription Sessions
    Create a transcription session
- Assistants
- Completions
  - Create a completion
- Completions

Input Tokens

Get input token counts

POST/responses/input_tokens