(../../../favicon.png) (https://cdn.openai.com) (https://cdn.openai.com/common/fonts/openai-sans/v2/OpenAISans-Regular.woff2) (decisions.html) Decisions | OpenAI API  (https://developers.openai.com/sitemap-index.xml) (Decisions | OpenAI API) (https://developers.openai.com/rss.xml) (../../../_astro/PageLayout.7sIpo98E.css) (../../../_astro/CodexPromptLanguageToggle.C85_1cG4.css) (../../../_astro/Header._BJyEeHo.css) (../../../_astro/Alert.EYqHMrNA.css) (../../../_astro/Button.C8rOtfxO.css) (../../../_astro/SegmentedControl.DN9Jh44Z.css)  For the complete documentation index, see (https://developers.openai.com/llms.txt) llms.txt . Markdown versions of documentation pages are available by appending .md to the page URL.  (https://developers.openai.com/) (OpenAI Developers)   ChatGPT   Start searching    (https://platform.openai.com/login) API Dashboard       (https://chatgpt.com/) Try ChatGPT                    (https://developers.openai.com/) Home   (https://developers.openai.com/api/docs) API    (https://developers.openai.com/api/docs) Overview  Get started with the OpenAI API    (https://developers.openai.com/api/docs/models) Models  Explore models and compare capabilities    (https://developers.openai.com/api/docs/guides/agents) Agents  Build persistent agents on hosted infrastructure    (https://developers.openai.com/api/docs/guides/tools) Tools  Connect models to tools and data    (https://developers.openai.com/api/docs/guides/audio) Audio & voice  Build speech and realtime voice experiences    (https://developers.openai.com/api/docs/guides/production-best-practices) Production  Deploy and scale your API integrations    (https://developers.openai.com/api/reference/overview) API reference  Explore endpoints, parameters, and responses        (https://developers.openai.com/chatgpt) ChatGPT    (https://developers.openai.com/siwc) Sign in with ChatGPT  Apps powered by your user's ChatGPT plan    (https://developers.openai.com/plugins) Plugins  Extend ChatGPT and Codex    (https://developers.openai.com/workspace-agents) Workspace Agents  Trigger published ChatGPT workspace agents    (https://developers.openai.com/commerce) Commerce  Build commerce flows in ChatGPT    (https://developers.openai.com/ads) Ads  Publish and measure ads in ChatGPT    (https://learn.chatgpt.com/docs) ChatGPT + Codex user docs    Guides and product docs for ChatGPT and Codex    (https://learn.chatgpt.com/use-cases) Use cases    Example workflows and tasks teams can take on with ChatGPT or Codex        (https://developers.openai.com/codex) Docs   (https://developers.openai.com/codex/use-cases) Use cases   (https://developers.openai.com/training) Training   (https://developers.openai.com/codex/resources) Resources   (https://developers.openai.com/learn) Resources    (https://developers.openai.com/showcase) Showcase  Demo apps to get inspired    (https://developers.openai.com/blog) Blog  Learnings and experiences from developers    (https://developers.openai.com/cookbook) Cookbook  Notebook examples for building with OpenAI models    (https://developers.openai.com/learn) Learn  Docs, videos, and demo apps for building with OpenAI    (https://developers.openai.com/community) Community  Programs, meetups, and support for builders           (https://developers.openai.com/api/docs) Overview    (https://developers.openai.com/api/docs/models) Models   (https://developers.openai.com/api/docs/guides/agents) Agents   (https://developers.openai.com/api/docs/guides/tools) Tools   (https://developers.openai.com/api/docs/guides/audio) Audio & voice   (https://developers.openai.com/api/docs/guides/production-best-practices) Production   (https://developers.openai.com/api/reference/overview) API reference      Search the API docs     Search docs (Start searching) ()   Suggested responses create reasoning_effort realtime prompt caching            Primary navigation  API  ChatGPT  Docs  Use cases  Training  Resources  Resources           Search docs (Start searching) ()   Suggested responses create reasoning_effort realtime prompt caching         Overview  Models  Agents  Tools  Audio & voice  Production  API reference   (mobile-nav-tab-1-variant-0) Overview (mobile-nav-tab-1-variant-1) Models (mobile-nav-tab-1-variant-2) Agents (mobile-nav-tab-1-variant-3) Tools (mobile-nav-tab-1-variant-4) Audio & voice (mobile-nav-tab-1-variant-5) Production (mobile-nav-tab-1-variant-6) API reference  Docs Overview          (https://developers.openai.com/api/docs) Home     Get started  (https://developers.openai.com/api/docs/quickstart) Quickstart   (https://developers.openai.com/api/docs/guides/latest-model) Using GPT-6   (https://developers.openai.com/api/docs/concepts) Key concepts     Core concepts  (https://developers.openai.com/api/docs/guides/migrate-to-responses) Responses API   (decisions.html) Decisions API   (https://developers.openai.com/api/docs/guides/conversation-state) Conversation state   (https://developers.openai.com/api/docs/guides/background) Background mode   (https://developers.openai.com/api/docs/guides/streaming-responses) Streaming   (https://developers.openai.com/api/docs/guides/websocket-mode) WebSocket mode   (https://developers.openai.com/api/docs/guides/steering) Mid-turn steering   (https://developers.openai.com/api/docs/guides/responses-multi-agent) Multi-agent   (https://developers.openai.com/api/docs/guides/webhooks) Webhooks   (https://developers.openai.com/api/docs/guides/file-inputs) File inputs   (https://developers.openai.com/api/docs/guides/compaction) Compaction   (https://developers.openai.com/api/docs/guides/token-counting) Counting tokens     SDKs and CLI  (https://developers.openai.com/api/docs/libraries) OpenAI SDK   (https://developers.openai.com/api/docs/libraries/openai-cli) OpenAI CLI     Resources  (https://developers.openai.com/api/docs/changelog) Changelog   (https://developers.openai.com/api/docs/deprecations) Deprecations   (https://developers.openai.com/api/docs/supported-countries) Supported countries   (https://developers.openai.com/api/docs/bots) OpenAI Crawlers   (https://openai.com/policies) Terms and policies       Legacy APIs  Agent Builder    (https://developers.openai.com/api/docs/guides/agent-builder) Overview   (https://developers.openai.com/api/docs/guides/agent-builder/migrate-from-agent-builder) Migration guide   (https://developers.openai.com/api/docs/guides/node-reference) Node reference   (https://developers.openai.com/api/docs/guides/agent-builder-safety) Safety in building agents      Evals    (https://developers.openai.com/api/docs/guides/evaluation-getting-started) Getting started   (https://developers.openai.com/api/docs/guides/evals) Working with evals   (https://developers.openai.com/api/docs/guides/prompt-optimizer) Prompt optimizer   (https://developers.openai.com/api/docs/guides/external-models) External models   (https://developers.openai.com/api/docs/guides/evaluation-best-practices) Best practices   (https://developers.openai.com/api/docs/guides/graders) Graders      Fine-tuning    (https://developers.openai.com/api/docs/guides/model-optimization) Optimization cycle   (https://developers.openai.com/api/docs/guides/supervised-fine-tuning) Supervised fine-tuning   (https://developers.openai.com/api/docs/guides/vision-fine-tuning) Vision fine-tuning   (https://developers.openai.com/api/docs/guides/direct-preference-optimization) Direct preference optimization   (https://developers.openai.com/api/docs/guides/reinforcement-fine-tuning) Reinforcement fine-tuning   (https://developers.openai.com/api/docs/guides/rft-use-cases) RFT use cases   (https://developers.openai.com/api/docs/guides/fine-tuning-best-practices) Best practices      Assistants API    (https://developers.openai.com/api/docs/assistants/migration) Migration guide         (https://developers.openai.com/api/docs/models) Model catalog     Choose a model  (https://developers.openai.com/api/docs/pricing) Pricing   (https://developers.openai.com/api/docs/guides/model-selection) Model selection     Text and code  (https://developers.openai.com/api/docs/guides/text) Text generation   (https://developers.openai.com/api/docs/guides/code-generation) Code generation   (https://developers.openai.com/api/docs/guides/structured-outputs) Structured output     Prompting  (https://developers.openai.com/api/docs/guides/prompting) Overview   (https://developers.openai.com/api/docs/guides/prompt-engineering) Prompt engineering   (https://developers.openai.com/api/docs/guides/citation-formatting) Citation formatting   (https://developers.openai.com/api/docs/guides/prompting/migrate-from-prompt-object) Migration guide   (https://developers.openai.com/api/docs/guides/prompt-generation) Prompt generation   (https://developers.openai.com/api/docs/guides/frontend-prompt) Frontend prompting     Reasoning  (https://developers.openai.com/api/docs/guides/reasoning) Reasoning models   (https://developers.openai.com/api/docs/guides/reasoning-best-practices) Reasoning best practices     Images  (https://developers.openai.com/api/docs/guides/images-vision) Images and vision     (https://developers.openai.com/api/docs/guides/image-cost-calculator) Image input cost calculator      (https://developers.openai.com/api/docs/guides/image-generation) Image generation     (https://developers.openai.com/api/docs/guides/image-generation) Overview   (https://developers.openai.com/api/docs/guides/image-prompting) Image prompting        Realtime and audio  (https://developers.openai.com/api/docs/guides/audio) Audio and speech   (https://developers.openai.com/api/docs/guides/realtime) Getting started   (https://developers.openai.com/api/docs/guides/voice-agents) Voice agents     Specialized models  (https://developers.openai.com/api/docs/guides/deep-research) Deep research   (https://developers.openai.com/api/docs/guides/embeddings) Embeddings   (https://developers.openai.com/api/docs/guides/moderation) Moderation      (https://developers.openai.com/api/docs/guides/agents) Overview     Agents API  (https://developers.openai.com/api/docs/guides/agents-api/overview) Overview   (https://developers.openai.com/api/docs/guides/agents-api/quickstart) Quickstart   (https://developers.openai.com/api/docs/guides/agents-api/architecture) Architecture   (https://developers.openai.com/api/docs/guides/agents-api/configuration) Configuring Agents   Sessions    (https://developers.openai.com/api/docs/guides/agents-api/sessions) Run and continue sessions   (https://developers.openai.com/api/docs/guides/agents-api/sessions/events) Events and items   (https://developers.openai.com/api/docs/guides/agents-api/sessions/manage) Manage sessions   (https://developers.openai.com/api/docs/guides/agents-api/sessions/webhooks) Webhooks      Environments and sandboxes    (https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) OpenAI-hosted sandboxes   (https://developers.openai.com/api/docs/guides/agents-api/environments/self-hosted) Self-hosted sandboxes   (https://developers.openai.com/api/docs/guides/agents-api/environments/lifecycle) Sandbox lifecycle   (https://developers.openai.com/api/docs/guides/agents-api/environments/security) Sandbox security   (https://developers.openai.com/api/docs/guides/agents-api/environments/files) Files and artifacts      Tools and integrations    (https://developers.openai.com/api/docs/guides/agents-api/tools/web-search) Web search   (https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) Computer use   (https://developers.openai.com/api/docs/guides/agents-api/tools/functions) Functions   (https://developers.openai.com/api/docs/guides/agents-api/tools/mcp) MCP connections   (https://developers.openai.com/api/docs/guides/agents-api/tools/plugins) Plugins   (https://developers.openai.com/api/docs/guides/agents-api/tools/vaults) Vaults      (https://developers.openai.com/api/docs/guides/agents-api/multi-agent) Multi-agent   (https://developers.openai.com/api/docs/guides/agents-api/observability) Observability and usage   (https://developers.openai.com/api/docs/guides/agents-api/tracing) Tracing   (https://developers.openai.com/api/docs/guides/agents-api/errors) Errors and recovery   (https://developers.openai.com/api/reference/resources/beta/subresources/agents) API reference   (https://developers.openai.com/api/docs/guides/agents-api/bedrock-managed-agents) Bedrock Managed Agents     Agents SDK  (https://developers.openai.com/api/docs/guides/agents/sdk) Overview   (https://developers.openai.com/api/docs/guides/agents/quickstart) Quickstart   (https://developers.openai.com/api/docs/guides/agents/define-agents) Agent definitions   (https://developers.openai.com/api/docs/guides/agents/models) Models and providers   (https://developers.openai.com/api/docs/guides/agents/running-agents) Running agents   (https://developers.openai.com/api/docs/guides/agents/sandboxes) Sandbox agents   (https://developers.openai.com/api/docs/guides/agents/orchestration) Orchestration   (https://developers.openai.com/api/docs/guides/agents/guardrails-approvals) Guardrails   (https://developers.openai.com/api/docs/guides/agents/results) Results and state   (https://developers.openai.com/api/docs/guides/agents/integrations-observability) Integrations and observability   (https://developers.openai.com/api/docs/guides/agent-evals) Evaluate agent workflows     ChatKit  (https://developers.openai.com/api/docs/guides/chatkit) Overview   (https://developers.openai.com/api/docs/guides/chatkit-themes) Customize   (https://developers.openai.com/api/docs/guides/chatkit-widgets) Widgets   (https://developers.openai.com/api/docs/guides/chatkit-actions) Actions   (https://developers.openai.com/api/docs/guides/custom-chatkit) Advanced integrations      (https://developers.openai.com/api/docs/guides/tools) Overview   (https://developers.openai.com/api/docs/guides/function-calling) Function calling     Search and retrieval  (https://developers.openai.com/api/docs/guides/tools-web-search) Web search   (https://developers.openai.com/api/docs/guides/tools-file-search) File search   (https://developers.openai.com/api/docs/guides/retrieval) Retrieval     Connect tools and data  (https://developers.openai.com/api/docs/guides/tools-connectors-mcp) MCP servers   (https://developers.openai.com/api/docs/guides/secure-mcp-tunnels) Secure MCP Tunnel     Build tool workflows  (https://developers.openai.com/api/docs/guides/tools-skills) Skills   (https://developers.openai.com/api/docs/guides/tools-tool-search) Tool search   (https://developers.openai.com/api/docs/guides/tools-programmatic-tool-calling) Programmatic tool calling   (https://developers.openai.com/api/docs/guides/async-tool-calling) Async tool calling     Computer and code  (https://developers.openai.com/api/docs/guides/tools-shell) Shell   (https://developers.openai.com/api/docs/guides/tools-computer-use) Computer use   (https://developers.openai.com/api/docs/guides/tools-apply-patch) Apply Patch   (https://developers.openai.com/api/docs/guides/tools-local-shell) Local shell   (https://developers.openai.com/api/docs/guides/tools-code-interpreter) Code interpreter     Media  (https://developers.openai.com/api/docs/guides/tools-image-generation) Image generation      (https://developers.openai.com/api/docs/guides/audio) Overview     GPT-Live  (https://developers.openai.com/api/docs/guides/live) Getting started   (https://developers.openai.com/api/docs/guides/live-prompting) Prompting   (https://developers.openai.com/api/docs/guides/live-conversations) Managing sessions   (https://developers.openai.com/api/docs/guides/live-delegation) Delegation and tools   (https://developers.openai.com/api/docs/guides/live-migration) Migrate to GPT-Live   (https://developers.openai.com/api/docs/guides/live-partner-integrations) Partner integrations     Realtime API  (https://developers.openai.com/api/docs/guides/realtime) Getting started   (https://developers.openai.com/api/docs/guides/voice-prompting) Prompting   (https://developers.openai.com/api/docs/guides/realtime-conversations) Managing conversations   (https://developers.openai.com/api/docs/guides/realtime-vad) Voice activity detection   (https://developers.openai.com/api/docs/guides/realtime-mcp) Tools and MCP     Build with voice  (https://developers.openai.com/api/docs/guides/voice-agents) Voice agents   (https://developers.openai.com/api/docs/guides/decisions-voice) Connect voice to Decisions   (https://developers.openai.com/api/docs/guides/custom-voices) Custom voices   (https://developers.openai.com/api/docs/guides/voice-latency-cost) Cost optimization     Connections  (https://developers.openai.com/api/docs/guides/voice-webrtc) WebRTC   (https://developers.openai.com/api/docs/guides/realtime-webrtc-warp) WebRTC with WARP   (https://developers.openai.com/api/docs/guides/voice-websockets) WebSockets   (https://developers.openai.com/api/docs/guides/voice-sip) Telephony and SIP   (https://developers.openai.com/api/docs/guides/voice-server-controls) Server-side controls     Audio processing  (https://developers.openai.com/api/docs/guides/speech-to-text) File transcription   (https://developers.openai.com/api/docs/guides/realtime-transcription) Live transcription   (https://developers.openai.com/api/docs/guides/realtime-translation) Live translation   (https://developers.openai.com/api/docs/guides/text-to-speech) Text to speech   (https://developers.openai.com/api/docs/guides/audio-chat-completions) Audio in Chat Completions      Go live  (https://developers.openai.com/api/docs/guides/production-best-practices) Production best practices   (https://developers.openai.com/api/docs/guides/deployment-checklist) Deployment checklist     Performance and quality  (https://developers.openai.com/api/docs/guides/fast-mode) Fast mode   (https://developers.openai.com/api/docs/guides/ultrafast-mode) Ultrafast mode   (https://developers.openai.com/api/docs/guides/latency-optimization) Latency optimization   (https://developers.openai.com/api/docs/guides/predicted-outputs) Predicted Outputs   (https://developers.openai.com/api/docs/guides/optimizing-llm-accuracy) Accuracy optimization     Cost and throughput  (https://developers.openai.com/api/docs/guides/cost-optimization) Cost optimization   (https://developers.openai.com/api/docs/guides/prompt-caching) Prompt caching     (https://developers.openai.com/api/docs/guides/prompt-caching/diagnostics) Prompt cache diagnostics      (https://developers.openai.com/api/docs/guides/batch) Batch   (https://developers.openai.com/api/docs/guides/flex-processing) Flex processing     Safety and governance  (https://developers.openai.com/api/docs/guides/safety-best-practices) Safety best practices   (https://developers.openai.com/api/docs/guides/red-teaming) Red teaming   (https://developers.openai.com/api/docs/guides/daybreak) Daybreak   Safety checks    (https://developers.openai.com/api/docs/guides/safety-checks) Safety classifiers   (https://developers.openai.com/api/docs/guides/safety-checks/cybersecurity) Cybersecurity checks   (https://developers.openai.com/api/docs/guides/safety-checks/misalignment-monitoring) Misalignment monitoring      (https://developers.openai.com/api/docs/guides/safety-enforcement) Enforcement notifications   (https://developers.openai.com/api/docs/guides/safety-checks/under-18-api-guidance) Under-18 guidance   (https://developers.openai.com/api/docs/guides/csam-guidance) CSAM guidance   (https://developers.openai.com/api/docs/guides/content-provenance) Content provenance   (https://developers.openai.com/api/docs/guides/your-data) Your data   (https://developers.openai.com/api/docs/guides/private-safety-processing) Private Safety Processing   (https://developers.openai.com/api/docs/guides/rbac) Permissions     Infrastructure and access  (https://developers.openai.com/api/docs/guides/terraform) Terraform provider     (https://developers.openai.com/api/docs/guides/terraform) Overview   (https://developers.openai.com/api/docs/guides/terraform/projects-and-access) Projects and access   (https://developers.openai.com/api/docs/guides/terraform/service-accounts) Service accounts   (https://developers.openai.com/api/docs/guides/terraform/rate-limits-and-spend) Rate limits and spend   (https://developers.openai.com/api/docs/guides/terraform/project-controls) Model, tool, and data controls   (https://developers.openai.com/api/docs/guides/terraform/import-and-reconcile) Import and reconciliation      (https://developers.openai.com/api/docs/guides/private-link) Private Link   (https://developers.openai.com/api/docs/guides/ip-allowlist) IP allowlist   (https://developers.openai.com/api/docs/guides/organization-blocking) Organization blocking   (https://developers.openai.com/api/docs/guides/mutual-tls) Mutual TLS   (https://developers.openai.com/api/docs/guides/workload-identity-federation) Workload identity federation     (https://developers.openai.com/api/docs/guides/workload-identity-federation/federation-rules) Federation rules   (https://developers.openai.com/api/docs/guides/workload-identity-federation/x509) X.509 certificates   (https://developers.openai.com/api/docs/guides/workload-identity-federation/kubernetes) Kubernetes   (https://developers.openai.com/api/docs/guides/workload-identity-federation/aws) AWS   (https://developers.openai.com/api/docs/guides/workload-identity-federation/microsoft-azure) Microsoft Azure   (https://developers.openai.com/api/docs/guides/workload-identity-federation/google-cloud) Google Cloud   (https://developers.openai.com/api/docs/guides/workload-identity-federation/oracle-cloud) Oracle Cloud Infrastructure   (https://developers.openai.com/api/docs/guides/workload-identity-federation/github-actions) GitHub Actions   (https://developers.openai.com/api/docs/guides/workload-identity-federation/spiffe) SPIFFE      (https://developers.openai.com/api/docs/guides/ip-addresses) IP egress ranges   (https://developers.openai.com/api/docs/guides/amazon-bedrock) Amazon Bedrock     Operations  (https://developers.openai.com/api/docs/guides/rate-limits) Rate limits   (https://developers.openai.com/api/docs/guides/spend-limits) Spend limits   (https://developers.openai.com/api/docs/guides/admin-apis) Admin APIs   (https://developers.openai.com/api/docs/guides/error-codes) Error codes        (https://developers.openai.com/chatgpt) Overview  Sign in with ChatGPT  Plugins  Workspace Agents  Commerce  Ads  (https://learn.chatgpt.com/docs) ChatGPT + Codex user docs    (https://learn.chatgpt.com/use-cases) Use cases     (mobile-nav-tab-2-variant-0) Overview (mobile-nav-tab-2-variant-1) Sign in with ChatGPT (mobile-nav-tab-2-variant-2) Plugins (mobile-nav-tab-2-variant-3) Workspace Agents (mobile-nav-tab-2-variant-4) Commerce (mobile-nav-tab-2-variant-5) Ads (mobile-nav-tab-2-variant-6) ChatGPT + Codex user docs (mobile-nav-tab-2-variant-7) Use cases  Docs Overview           (https://developers.openai.com/siwc) Home   (https://developers.openai.com/siwc/quickstart) Quickstart   (https://developers.openai.com/siwc/request-client-id) Request a client ID     Identity  (https://developers.openai.com/siwc/website) On your website   (https://developers.openai.com/siwc/chatgpt-plugin) In your ChatGPT plugin     ChatGPT plan usage  (https://developers.openai.com/siwc/token-sharing-open-source) Overview   (https://developers.openai.com/siwc/ui-ux-guidelines) UI/UX guidelines   (https://developers.openai.com/siwc/token-sharing-open-source/sign-in) Registration and sign-in   (https://developers.openai.com/siwc/token-sharing-open-source/profiles-and-sessions) Accounts and sessions   (https://developers.openai.com/siwc/token-sharing-open-source/models-and-inference) Models and inference   (https://developers.openai.com/siwc/token-sharing-open-source/codex-app-server) Codex app-server   (https://developers.openai.com/siwc/token-sharing-open-source/self-hosted-vms) Self-hosted VMs   (https://developers.openai.com/siwc/token-sharing-open-source/token-reference) Token reference   (https://developers.openai.com/siwc/token-sharing-open-source/errors-and-recovery) Errors and recovery   (https://developers.openai.com/siwc/token-sharing-open-source/preview-limitations) Preview limitations      (https://developers.openai.com/plugins) Home   (https://developers.openai.com/plugins/quickstart) Quickstart     Core concepts  (https://developers.openai.com/plugins/concepts/plugins) Plugin architecture   (https://developers.openai.com/plugins/concepts/skills) Skills   (https://developers.openai.com/plugins/concepts/mcp-server) MCP server     Plan  (https://developers.openai.com/plugins/plan/use-case) Brainstorm use cases   (https://developers.openai.com/plugins/plan/tools) Define tools     Build  (https://developers.openai.com/plugins/build/mcp-server) Build an MCP server   (https://developers.openai.com/plugins/build/chatgpt-ui) Add UI to your MCP server (optional)   (https://developers.openai.com/plugins/build/mcp-events) Add events to your MCP server (optional)   (https://developers.openai.com/plugins/build/extensions) Extensions   (https://developers.openai.com/plugins/build/auth) Authenticate users   (https://developers.openai.com/plugins/build/skills) Build skills   (https://developers.openai.com/plugins/build/plugins) Package your plugin   (https://developers.openai.com/plugins/build/examples) Examples     Test and publish  (https://developers.openai.com/plugins/deploy/connect-chatgpt) Connect and test your plugin   (https://developers.openai.com/plugins/deploy/submission) Submit and publish   (https://developers.openai.com/plugins/deploy/submission-errors) Submission error reference     Conversion specs  (https://developers.openai.com/plugins/guides/restaurant-reservation-conversion-spec) Restaurant reservation spec   (https://developers.openai.com/plugins/guides/local-services-request-quote-conversion-spec) Get Quote spec   (https://developers.openai.com/plugins/guides/product-checkout-conversion-spec) Product checkout spec     Guides  (https://developers.openai.com/plugins/concepts/ui-guidelines) UI guidelines   (https://developers.openai.com/plugins/guides/optimize-metadata) Optimize Metadata   (https://developers.openai.com/plugins/guides/submit-claude-plugin) Submit a Claude Code plugin   (https://developers.openai.com/plugins/guides/security-privacy) Security & Privacy   (https://developers.openai.com/plugins/deploy/troubleshooting) Troubleshooting     Resources  (https://developers.openai.com/plugins/changelog) Changelog   (https://developers.openai.com/plugins/plugin-guidelines) Plugin guidelines   (https://developers.openai.com/plugins/deploy/app-review) MCP server review requirements   (https://developers.openai.com/plugins/reference) Plugin UI reference   (https://developers.openai.com/plugins/build/monetization) Checkout API reference      (https://developers.openai.com/workspace-agents) Home     Get started  (https://developers.openai.com/workspace-agents/trigger-runs) Trigger workspace agent runs   (https://developers.openai.com/workspace-agents/authentication) Authenticate with Workspace Agent access tokens      (https://developers.openai.com/commerce) Home     Guides  (https://developers.openai.com/commerce/guides/get-started) Get started   (https://developers.openai.com/commerce/guides/best-practices) Best practices     File Upload  (https://developers.openai.com/commerce/specs/file-upload/overview) Overview   (https://developers.openai.com/commerce/specs/file-upload/products) Products     API  (https://developers.openai.com/commerce/specs/api/overview) Overview   (https://developers.openai.com/commerce/specs/api/feeds) Feeds   (https://developers.openai.com/commerce/specs/api/products) Products   (https://developers.openai.com/commerce/specs/api/promotions) Promotions      (https://developers.openai.com/ads) Ads Overview     Measurement  (https://developers.openai.com/ads/measurement-pixel) Measurement Pixel   (https://developers.openai.com/ads/multiple-pixels) Multiple Pixels (Advanced)   (https://developers.openai.com/ads/image-tag) Image Tag   (https://developers.openai.com/ads/conversions-api) Conversions API   (https://developers.openai.com/ads/supported-events) Supported Events     Advertiser API  (https://developers.openai.com/ads/api-overview) Overview   (https://developers.openai.com/ads/api-partner-setup) API Partner Setup   (https://developers.openai.com/ads/campaign-management) Campaign Management   (https://developers.openai.com/ads/bidding-and-budgets) Bidding & Budgets   (https://developers.openai.com/ads/campaign-targeting) Targeting   (https://developers.openai.com/ads/product-feeds) Product Feeds   (https://developers.openai.com/ads/hotel-feeds) Hotel Feeds (limited beta)   (https://developers.openai.com/ads/conversion-tracking) Conversion Tracking   (https://developers.openai.com/ads/reporting) Reporting   (https://developers.openai.com/ads/troubleshooting) Troubleshooting   (https://developers.openai.com/ads/account-management) Account Management     API Reference  (https://developers.openai.com/ads/api-reference/authentication) Authentication   (https://developers.openai.com/ads/api-reference/ad-account) Ad Account   (https://developers.openai.com/ads/api-reference/audit-logs) Audit Logs   (https://developers.openai.com/ads/api-reference/campaigns) Campaigns   (https://developers.openai.com/ads/api-reference/ad-groups) Ad Groups   (https://developers.openai.com/ads/api-reference/ads) Ads   (https://developers.openai.com/ads/api-reference/insights) Insights   (https://developers.openai.com/ads/api-reference/files) Files   (https://developers.openai.com/ads/api-reference/conversion-setup) Conversion Setup         Overview  Features  Configuration  Developers  Security  Administration  Use Cases  Resources   (mobile-nav-tab-3-variant-0) Overview (mobile-nav-tab-3-variant-1) Features (mobile-nav-tab-3-variant-2) Configuration (mobile-nav-tab-3-variant-3) Developers (mobile-nav-tab-3-variant-4) Security (mobile-nav-tab-3-variant-5) Administration (mobile-nav-tab-3-variant-6) Use Cases (mobile-nav-tab-3-variant-7) Resources  Docs Overview          (https://developers.openai.com/codex) Home     Get started  (https://developers.openai.com/codex/quickstart) Quickstart   (https://developers.openai.com/codex/use-chatgpt) Use ChatGPT   (https://developers.openai.com/codex/get-started-with-work) Get started with Work   (https://developers.openai.com/codex/dots) Meet dots   (https://developers.openai.com/codex/import) Import from another agent     Foundations  (https://developers.openai.com/codex/prompting) Prompting   (https://developers.openai.com/codex/model-selection) Model selection   (https://developers.openai.com/codex/personalize) Personalize ChatGPT   (https://developers.openai.com/codex/skills-and-plugins) Skills & Plugins   (https://developers.openai.com/codex/permission-modes) Permissions     Explore  (https://developers.openai.com/codex/whats-new) What's new   (https://developers.openai.com/codex/models) Models   (https://developers.openai.com/codex/pricing) Pricing   (https://developers.openai.com/codex/glossary) Glossary     Available on  (https://developers.openai.com/codex/app) ChatGPT desktop app   (https://developers.openai.com/codex/mobile) ChatGPT mobile app   (https://developers.openai.com/codex/web) ChatGPT on the web   (https://developers.openai.com/codex/cli) Codex CLI   (https://developers.openai.com/codex/ide) Codex IDE extension   (https://developers.openai.com/codex/cloud) Codex Cloud     Releases  (https://developers.openai.com/codex/changelog) Changelog   (https://developers.openai.com/codex/feature-maturity) Feature Maturity   (https://developers.openai.com/codex/open-source) Open Source      (https://developers.openai.com/codex/features) Overview     Workflows  (https://developers.openai.com/codex/projects) Projects and chats   (https://developers.openai.com/codex/sites) Sites   (https://developers.openai.com/codex/build-plugins) Build plugins   (https://developers.openai.com/codex/visualizations) Visualizations   (https://developers.openai.com/codex/automations) Scheduled tasks   (https://developers.openai.com/codex/long-running-work) Long-running work   (https://developers.openai.com/codex/notifications) Notifications   (https://developers.openai.com/codex/pets) Pets   (https://developers.openai.com/codex/features/codex-micro) Codex Micro     Capabilities  (https://developers.openai.com/codex/browser) Browser   (https://developers.openai.com/codex/computer-use) Computer use   (https://developers.openai.com/codex/features/voice) Voice   (https://developers.openai.com/codex/plugins) Plugins   (https://developers.openai.com/codex/sign-in-with-chatgpt) Sign in with ChatGPT   (https://developers.openai.com/codex/web-search) Web search   (https://developers.openai.com/codex/image-generation) Image generation   (https://developers.openai.com/codex/image-inputs) Image inputs   (https://developers.openai.com/codex/appshots) Appshots   (https://developers.openai.com/codex/chrome-extension) Browser extension   (https://developers.openai.com/codex/artifacts-viewer) Work with files     dots  (https://developers.openai.com/codex/dots) Meet dots   (https://developers.openai.com/codex/dots/getting-started) Getting started   (https://developers.openai.com/codex/dots/channels) Messaging   (https://developers.openai.com/codex/dots/tasks-and-memory) Tasks and memory   (https://developers.openai.com/codex/dots/computers-and-apps) Computers and apps   (https://developers.openai.com/codex/dots/controls) Controls     ChatGPT Space  (https://developers.openai.com/codex/space) Overview   (https://developers.openai.com/codex/space/getting-started) Getting started   (https://developers.openai.com/codex/space/pages) Pages   (https://developers.openai.com/codex/space/agents) Work with agents   (https://developers.openai.com/codex/space/collaboration) Collaboration     Reference  (https://developers.openai.com/codex/reference/commands) Commands   (https://developers.openai.com/codex/reference/slash-commands) Slash commands   (https://developers.openai.com/codex/reference/settings) Settings   (https://developers.openai.com/codex/reference/troubleshooting) Troubleshooting      (https://developers.openai.com/codex/configuration) Overview     Customization  (https://developers.openai.com/codex/customization/overview) Overview   (https://developers.openai.com/codex/customization/memories) Memories   (https://developers.openai.com/codex/customization/computer-history) Computer History     Config file  (https://developers.openai.com/codex/config-file/config-basic) Config Basics   (https://developers.openai.com/codex/config-file/config-advanced) Advanced Config   (https://developers.openai.com/codex/config-file/config-reference) Config Reference   (https://developers.openai.com/codex/config-file/environment-variables) Environment Variables   (https://developers.openai.com/codex/config-file/config-sample) Sample Config     Agent configuration  (https://developers.openai.com/codex/agent-configuration/agents-md) AGENTS.md   (https://developers.openai.com/codex/agent-configuration/subagents) Subagents   (https://developers.openai.com/codex/agent-configuration/speed) Speed   (https://developers.openai.com/codex/agent-configuration/rules) Rules     Extend ChatGPT and Codex  (https://developers.openai.com/codex/extend/record-and-replay) Record & Replay   (https://developers.openai.com/codex/extend/mcp) MCP     Linux  (https://developers.openai.com/codex/linux/linux-app) Desktop app     Windows  (https://developers.openai.com/codex/windows/windows-app) Desktop app   (https://developers.openai.com/codex/windows/windows-sandbox) Windows sandbox   (https://developers.openai.com/codex/windows/wsl) WSL      (https://developers.openai.com/codex/developers) Overview     Development workflows  (https://developers.openai.com/codex/code-review) Code review   (https://developers.openai.com/codex/integrated-terminal) Integrated terminal     Extend and automate  (https://developers.openai.com/codex/build-skills) Build skills   (https://developers.openai.com/codex/webmcp) Site tools (WebMCP)   (https://developers.openai.com/codex/annotations-extensibility) Annotations Extensibility   (https://developers.openai.com/codex/hooks) Hooks     Environments  (https://developers.openai.com/codex/environments/modes) Modes   (https://developers.openai.com/codex/environments/local-environment) Local environments   (https://developers.openai.com/codex/environments/git-worktrees) Git worktrees     Codex Cloud  (https://developers.openai.com/codex/environments/cloud-environments) Cloud environments     Build with Codex  (https://developers.openai.com/codex/codex-sdk) Codex SDK   (https://developers.openai.com/codex/app-server) App Server   (https://developers.openai.com/codex/github-action) GitHub Action   (https://developers.openai.com/codex/non-interactive-mode) Non-interactive mode     Third-party integrations  (https://developers.openai.com/codex/third-party/github) GitHub   (https://developers.openai.com/codex/third-party/gitlab) GitLab (Beta)   (https://developers.openai.com/codex/third-party/slack) Slack   (https://developers.openai.com/codex/third-party/linear) Linear     Reference  (https://developers.openai.com/codex/cli-customization) CLI customization   (https://developers.openai.com/codex/developer-commands) Developer commands   (https://developers.openai.com/codex/developer-settings) Developer settings      (https://developers.openai.com/codex/security-administration) Overview     Permissions  (https://developers.openai.com/codex/permissions) Profiles   (https://developers.openai.com/codex/sandboxing) Sandboxing   (https://developers.openai.com/codex/sandboxing/auto-review) Auto-review   (https://developers.openai.com/codex/agent-approvals-security) Agent approvals & security     Codex Security  (https://developers.openai.com/codex/security) Overview   Codex Security plugin    (https://developers.openai.com/codex/security/plugin) Quickstart   (https://developers.openai.com/codex/security/plugin/scans) Run a security scan   (https://developers.openai.com/codex/security/plugin/deep-scans) Run a deep scan   (https://developers.openai.com/codex/security/plugin/code-changes) Review code changes   (https://developers.openai.com/codex/security/plugin/workbench) Use the Security workbench   (https://developers.openai.com/codex/security/plugin/triage-backlog) Triage a backlog   (https://developers.openai.com/codex/security/plugin/fix-findings) Fix findings   (https://developers.openai.com/codex/security/plugin/security-hardening) Propose security hardening   (https://developers.openai.com/codex/security/plugin/vulnerability-reports) Write vulnerability reports   (https://developers.openai.com/codex/security/plugin/export-findings) Export and track findings   (https://developers.openai.com/codex/security/plugin/changelog) Changelog      Codex Security CLI    (https://developers.openai.com/codex/security/cli) Quickstart   (https://developers.openai.com/codex/security/cli/bulk-scans) Run bulk scans   (https://developers.openai.com/codex/security/cli/ci) Run scans in CI   (https://developers.openai.com/codex/security/cli/ci/gitlab) GitLab CI/CD   (https://developers.openai.com/codex/security/cli/reference) Reference   (https://developers.openai.com/codex/security/cli/faq) FAQ      (https://developers.openai.com/codex/security/sdk) TypeScript SDK   Codex Security Cloud    (https://developers.openai.com/codex/security/setup) Setup   (https://developers.openai.com/codex/security/security-review) Security Review   (https://developers.openai.com/codex/security/threat-model) Improving the threat model   (https://developers.openai.com/codex/security/faq) FAQ        Cyber safety  (https://developers.openai.com/codex/cyber-safety) Models & Trusted Access   (https://developers.openai.com/codex/cyber-safety/recommended-configuration) Recommended configuration      (https://developers.openai.com/codex/administration) Overview     Getting started  (https://developers.openai.com/codex/enterprise/admin-setup) Admin rollout guide   (https://developers.openai.com/codex/enterprise/admin-plugin) Admin plugin     Feature setup    (https://developers.openai.com/codex/dots/controls#for-workspace-admins) Dots   (https://developers.openai.com/codex/space/collaboration#for-workspace-admins) Space   (https://developers.openai.com/codex/enterprise/teams#for-workspace-admins) Teams and Team Tasks   (https://developers.openai.com/codex/enterprise/chatgpt-slack-and-teams) ChatGPT in Slack and Teams   (https://developers.openai.com/codex/enterprise/shared-connections) Workspace connections   (https://developers.openai.com/codex/enterprise/cloud-local-access) Local computer access for Work Cloud and dots   (https://developers.openai.com/codex/enterprise/sites) Sites        Identity and access  (https://developers.openai.com/codex/auth) Authentication overview   (https://developers.openai.com/codex/enterprise/groups-and-provisioning) Groups and provisioning   (https://developers.openai.com/codex/enterprise/user-lifecycle) User lifecycle management   (https://developers.openai.com/codex/enterprise/roles-and-workspace-permissions) Roles and workspace permissions   (https://developers.openai.com/codex/enterprise/access-tokens) Personal access tokens   (https://developers.openai.com/codex/enterprise/service-accounts) Service accounts     Deployment and configuration  (https://developers.openai.com/codex/enterprise/windows-deployment) Windows app deployment   (https://developers.openai.com/codex/enterprise/manage-app-updates) Manage app updates   (https://developers.openai.com/codex/enterprise/managed-configuration) Managed configuration   (https://developers.openai.com/codex/remote-connections) Remote connections   (https://developers.openai.com/codex/enterprise/workspace-model-availability) Workspace model availability   (https://developers.openai.com/codex/amazon-bedrock) Amazon Bedrock   (https://developers.openai.com/codex/enterprise/govcloud-configuration) Bedrock GovCloud configuration   (https://developers.openai.com/codex/enterprise/connect-to-a-gateway) Connect to a gateway   (https://developers.openai.com/codex/enterprise/roll-out-a-gateway) Deploy Codex through a gateway   (https://developers.openai.com/codex/enterprise/gateway-compatibility) Gateway compatibility   (https://developers.openai.com/codex/enterprise/bedrock-through-litellm) Bedrock through LiteLLM     ChatGPT Work  (https://developers.openai.com/codex/enterprise/chatgpt-work-overview) Overview   (https://developers.openai.com/codex/enterprise/chatgpt-work-cloud-security) Cloud security   (https://developers.openai.com/codex/enterprise/chatgpt-work-local-security) Local security   (https://developers.openai.com/codex/enterprise/chatgpt-work-usage-and-cost) Usage and cost   (https://developers.openai.com/codex/enterprise/work-admin-faq) Admin FAQ     Collaboration and sharing  (https://developers.openai.com/codex/enterprise/gpts-and-sharing) GPTs and sharing     Plugins and connections  (https://developers.openai.com/codex/enterprise/apps-and-connectors) Plugin controls   (https://developers.openai.com/codex/enterprise/plugin-management) Plugin management   (https://developers.openai.com/codex/enterprise/skills) Skill controls   (https://developers.openai.com/codex/migrate-custom-gpts) Migrate custom GPTs to plugins     Usage and analytics  (https://developers.openai.com/codex/enterprise/workspace-analytics) Workspace analytics   (https://developers.openai.com/codex/enterprise/usage-insights) Usage Insights   (https://developers.openai.com/codex/enterprise/analytics-api) Analytics API     Security and compliance  (https://developers.openai.com/codex/enterprise/governance) Governance   (https://developers.openai.com/codex/enterprise/agent-security) Agent security   (https://developers.openai.com/codex/enterprise/prisma-airs) Prisma AIRS   (https://developers.openai.com/codex/hipaa-configuration) HIPAA configuration   (https://developers.openai.com/codex/enterprise/compliance-api) Compliance API and audit events      (https://developers.openai.com/codex/use-cases) Explore use cases   (https://developers.openai.com/codex/use-cases/collections) Collections      (https://developers.openai.com/codex/resources) Home   (https://developers.openai.com/codex/videos) Videos   (https://developers.openai.com/showcase) Showcase     (https://openai.com/academy/) OpenAI Academy     (https://academy.openai.com/home/events) Online trainings       Community  (https://developers.openai.com/community/codex-ambassadors) Codex Ambassadors     (https://developers.openai.com/community/students) Codex for Students     (https://developers.openai.com/community/codex-for-oss) Codex for Open Source     (https://luma.com/codex-community?utm_source=oaidevs) Events       Blog  (https://openai.com/news/) Company blog     (https://developers.openai.com/blog) Developer blog         (https://developers.openai.com/codex/use-cases) Explore use cases   (https://developers.openai.com/codex/use-cases/collections) Collections       (https://developers.openai.com/codex/resources) Home   (https://developers.openai.com/codex/videos) Videos   (https://developers.openai.com/showcase) Showcase     (https://openai.com/academy/) OpenAI Academy     (https://academy.openai.com/home/events) Online trainings       Community  (https://developers.openai.com/community/codex-ambassadors) Codex Ambassadors     (https://developers.openai.com/community/students) Codex for Students     (https://developers.openai.com/community/codex-for-oss) Codex for Open Source     (https://luma.com/codex-community?utm_source=oaidevs) Events       Blog  (https://openai.com/news/) Company blog     (https://developers.openai.com/blog) Developer blog         (https://developers.openai.com/showcase) Showcase  Blog  Cookbook  Learn  Community   (mobile-nav-tab-7-variant-1) Showcase (mobile-nav-tab-7-variant-2) Blog (mobile-nav-tab-7-variant-3) Cookbook (mobile-nav-tab-7-variant-4) Learn (mobile-nav-tab-7-variant-5) Community  Docs Select...            (https://developers.openai.com/blog) All posts     Recent  (https://developers.openai.com/blog/bringing-my-led-display-to-life) Bringing my LED display to life with GPT-Live-1 and Codex   (https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra) Rethinking skills and prompts for GPT-6 Astra   (https://developers.openai.com/blog/architectural-visualization-with-astra) Architectural visualization with Astra   (https://developers.openai.com/blog/how-to-build-games-with-astra) Building games with Astra   (https://developers.openai.com/blog/rosalind-workbench) Meet Rosalind Workbench: Empowering every scientist to be their own research team     Topics  (https://developers.openai.com/blog/topic/general) General   (https://developers.openai.com/blog/topic/api) API   (https://developers.openai.com/blog/topic/apps-sdk) Apps SDK   (https://developers.openai.com/blog/topic/audio) Audio   (https://developers.openai.com/blog/topic/codex) Codex   (https://developers.openai.com/blog/topic/life-sciences) Life sciences      (https://developers.openai.com/cookbook) Home     Topics  (https://developers.openai.com/cookbook/topic/sign-in-with-chatgpt) Sign-in with ChatGPT   (https://developers.openai.com/cookbook/topic/agents) Agents   (https://developers.openai.com/cookbook/topic/evals) Evals   (https://developers.openai.com/cookbook/topic/multimodal) Multimodal   (https://developers.openai.com/cookbook/topic/text) Text   (https://developers.openai.com/cookbook/topic/guardrails) Guardrails   (https://developers.openai.com/cookbook/topic/optimization) Optimization   (https://developers.openai.com/cookbook/topic/chatgpt) ChatGPT   (https://developers.openai.com/cookbook/topic/codex) Codex   (https://developers.openai.com/cookbook/topic/gpt-oss) gpt-oss     Contribute  (https://github.com/openai/openai-cookbook) Cookbook on GitHub        (https://developers.openai.com/learn) Home   (https://developers.openai.com/learn/developers-codex-plugin) OpenAI Developers plugin   (https://developers.openai.com/learn/docs-mcp) Docs MCP     Categories  (https://developers.openai.com/learn/code) Demo apps   (https://developers.openai.com/learn/videos) Videos     Topics  (https://developers.openai.com/learn/agents) Agents   (https://developers.openai.com/learn/audio) Audio & Voice   (https://developers.openai.com/learn/cua) Computer Use   (https://developers.openai.com/learn/codex) Codex   (https://developers.openai.com/learn/evals) Evals   (https://developers.openai.com/learn/gpt-oss) gpt-oss   (https://developers.openai.com/learn/fine-tuning) Fine-tuning   (https://developers.openai.com/learn/imagegen) Image generation   (https://developers.openai.com/learn/scaling) Scaling   (https://developers.openai.com/learn/tools) Tools   (https://developers.openai.com/learn/videogen) Video generation      (https://developers.openai.com/community) Community     Programs  (https://developers.openai.com/community/codex-ambassadors) Codex Ambassadors   (https://developers.openai.com/community/students) Codex for Students   (https://developers.openai.com/community/codex-for-oss) Codex for Open Source   (https://openai.com/business/why-openai/startups/) OpenAI for Startups       Spaces  (https://luma.com/codex-community?utm_source=oaidevs) Events     (https://community.openai.com/) Developer Forum     (https://discord.com/invite/openai) Discord     (https://www.reddit.com/r/OpenAI/) Reddit     (https://x.com/OpenAIDevs) X          (https://platform.openai.com/login) API Dashboard       (https://chatgpt.com/) Try ChatGPT            (https://developers.openai.com/api/docs) Home      Get started (https://developers.openai.com/api/docs/quickstart) Quickstart    (https://developers.openai.com/api/docs/guides/latest-model) Using GPT-6    (https://developers.openai.com/api/docs/concepts) Key concepts      Core concepts (https://developers.openai.com/api/docs/guides/migrate-to-responses) Responses API    (decisions.html) Decisions API    (https://developers.openai.com/api/docs/guides/conversation-state) Conversation state    (https://developers.openai.com/api/docs/guides/background) Background mode    (https://developers.openai.com/api/docs/guides/streaming-responses) Streaming    (https://developers.openai.com/api/docs/guides/websocket-mode) WebSocket mode    (https://developers.openai.com/api/docs/guides/steering) Mid-turn steering    (https://developers.openai.com/api/docs/guides/responses-multi-agent) Multi-agent    (https://developers.openai.com/api/docs/guides/webhooks) Webhooks    (https://developers.openai.com/api/docs/guides/file-inputs) File inputs    (https://developers.openai.com/api/docs/guides/compaction) Compaction    (https://developers.openai.com/api/docs/guides/token-counting) Counting tokens      SDKs and CLI (https://developers.openai.com/api/docs/libraries) OpenAI SDK    (https://developers.openai.com/api/docs/libraries/openai-cli) OpenAI CLI      Resources (https://developers.openai.com/api/docs/changelog) Changelog    (https://developers.openai.com/api/docs/deprecations) Deprecations    (https://developers.openai.com/api/docs/supported-countries) Supported countries    (https://developers.openai.com/api/docs/bots) OpenAI Crawlers    (https://openai.com/policies) Terms and policies        Legacy APIs Agent Builder    (https://developers.openai.com/api/docs/guides/agent-builder) Overview    (https://developers.openai.com/api/docs/guides/agent-builder/migrate-from-agent-builder) Migration guide    (https://developers.openai.com/api/docs/guides/node-reference) Node reference    (https://developers.openai.com/api/docs/guides/agent-builder-safety) Safety in building agents       Evals    (https://developers.openai.com/api/docs/guides/evaluation-getting-started) Getting started    (https://developers.openai.com/api/docs/guides/evals) Working with evals    (https://developers.openai.com/api/docs/guides/prompt-optimizer) Prompt optimizer    (https://developers.openai.com/api/docs/guides/external-models) External models    (https://developers.openai.com/api/docs/guides/evaluation-best-practices) Best practices    (https://developers.openai.com/api/docs/guides/graders) Graders       Fine-tuning    (https://developers.openai.com/api/docs/guides/model-optimization) Optimization cycle    (https://developers.openai.com/api/docs/guides/supervised-fine-tuning) Supervised fine-tuning    (https://developers.openai.com/api/docs/guides/vision-fine-tuning) Vision fine-tuning    (https://developers.openai.com/api/docs/guides/direct-preference-optimization) Direct preference optimization    (https://developers.openai.com/api/docs/guides/reinforcement-fine-tuning) Reinforcement fine-tuning    (https://developers.openai.com/api/docs/guides/rft-use-cases) RFT use cases    (https://developers.openai.com/api/docs/guides/fine-tuning-best-practices) Best practices       Assistants API    (https://developers.openai.com/api/docs/assistants/migration) Migration guide                       Copy Page    Decisions  Turn text and images into decisions your application can use, 10x faster than the Responses API.       Copy Page       The Decisions API evaluates text, images, or both and returns typed answers about 10x faster than the Responses API. Get the probability that a condition is true, a choice from a fixed set, or a score against a rubric. Use those answers to classify content, route requests, and prioritize work in your application. Try the Decisions API in the (https://platform.openai.com/decisions) Playground to experiment with questions and inputs before writing code.     The Decisions API is in public beta, and we expect to GA in the coming weeks. gpt-6-luna is the only model currently available. Use the dedicated POST   /v1/decisions endpoint.      How decisions work (Copy link to How decisions work)     A request has three parts: Field Purpose   model  The model that evaluates the request. Currently, only gpt-6-luna is supported.  input  Shared evidence for the questions: a text string or user messages containing text and images.  questions  What to evaluate, including each question’s type, instructions, and any allowed choices or score levels.     The response contains an answers array. Give each question a unique name to identify its answer; the API echoes that name in the response. Choose a question type (Copy link to Choose a question type)     Type Use it to Main result   predicate  Check a condition, such as visible damage or passage relevance. probability : an estimate from 0 to 1 that the condition is true.  choice  Select one option, such as a department or content category. choice : one of your supplied values.  score  Rate an input against ordered levels, such as issue severity. score : the probability-weighted average of the level indices.     Both choice and score return probabilities over discrete options. Use choice for categories without an order, such as departments. Use score for ordered levels, such as severity; it takes the probability-weighted average of their numeric indices to produce a score that can fall between levels. Use Decisions when your application needs one of these answer types. Use (https://developers.openai.com/api/docs/guides/structured-outputs) Structured Outputs with the Responses API when you need to generate an object that follows your own JSON schema, such as extracted fields or a written explanation, or (https://developers.openai.com/api/docs/guides/function-calling) function calling when you need a model to request a tool call with arguments. Check an image for visible damage (Copy link to Check an image for visible damage)     Use a predicate question to check a product photo for visible damage. This request combines the image with instructions to look for a crack, tear, or dent. Dent  Cancellation  Answer relevance   Does this item have a dent?  (A smooth sage-green travel cup)   (A blue camping mug with a pronounced dent)    (A steel storage tin with a small shallow dimple)   (A dented silver aluminum can)   (An undamaged yellow metal bottle)    probability 1.00    “  Please cancel my subscription before the next renewal. Can I switch to annual billing and keep my current plan? I don’t need this anymore. How do I stop future charges?   probability 1.00   Question Can I return an item after 30 days? Answer Returns are accepted within 30 days of delivery. After that, items aren’t eligible for a refund. Start a return from the Orders page in your account. Standard shipping takes three to five business days.   probability 0.90       (Explore predicate examples)    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22  IMAGE_BASE64 = "$( base64 < product.png  | tr -d '\r\n')"   curl https://api.openai.com/v1/decisions \  -H "Authorization: Bearer  $OPENAI_API_KEY " \  -H "Content-Type: application/json" \  --data-binary @- << JSON  {  "model": "gpt-6-luna",  "input": [{  "role": "user",  "content": [  {"type": "input_text", "text": "Inspect the product in this photo."},  {"type": "input_image", "image_url": "data:image/png;base64, $IMAGE_BASE64 "}  ]  }],  "questions": [{  "type": "predicate",  "name": "visible_damage",  "instructions": "Does the product have visible damage, such as a crack, tear, or dent? Ignore shadows and damage to the packaging."  }]  }  JSON    An illustrative response excerpt: 1 2 3 4 5 6 7 8 9  {  "answers" : [  {  "type" :  "predicate" ,  "name" :  "visible_damage" ,  "probability" :  0.92  }  ]  }    The probability is the model’s estimate that the condition is true. Use it to flag photos for review based on a threshold you choose. Images must be inline base64 data URLs. Hosted HTTP or HTTPS image URLs and file_id inputs aren’t supported by this endpoint. Combine input_text and input_image parts in a user message to evaluate images together with instructions or other context. Select from fixed options (Copy link to Select from fixed options)     A choice question selects one value from the options you provide. Use distinct values and descriptions that explain when each option applies. Driving  Team routing  Document type   Which lane should the car choose?    1 2 3         Lane 1   0.03  Lane 2   0.94  Lane 3   0.03     “  I was charged twice for this month. Can you refund the extra payment? Every CSV export fails with an error, even after I refresh the page. I lost my phone and can’t get past two-step verification.   Billing   1.00  Technical support   0.00  Account access   0.00     NORTHLINE STUDIO № 1042  Invoice  Billed to Cedar & Co.  Design services $1,200.00  Amount due $1,200.00  Payment due October 21  NORTHLINE STUDIO № 6853  Payment received  Thank you for your purchase.  Design services $1,200.00  Total paid $1,200.00  Visa ending in 4242 · Approved  NORTHLINE STUDIO 01 / 03  Services agreement  Between Northline Studio and Cedar & Co.  The provider agrees to deliver design services for a term of twelve months. Provider signature Client signature    Invoice   1.00  Receipt   0.00  Contract   0.00         (Explore choice examples)    This request routes a customer complaint: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18  curl https://api.openai.com/v1/decisions \  -H "Authorization: Bearer  $OPENAI_API_KEY " \  -H "Content-Type: application/json" \  -d '{  "model": "gpt-6-luna",  "input": "I was charged twice for my order.",  "questions": [{  "type": "choice",  "name": "department",  "instructions": "Which department should handle this complaint?",  "choices": [  {"value": "billing", "description": "Payments, invoices, and refunds."},  {"value": "technical", "description": "Problems using the product."},  {"value": "shipping", "description": "Delivery and tracking."},  {"value": "other", "description": "Requests outside these categories."}  ]  }]  }'    An illustrative response excerpt: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16  {  "answers" : [  {  "type" :  "choice" ,  "name" :  "department" ,  "choice" :  "billing" ,  "probabilities" : [  {  "value" :  "billing" ,  "probability" :  0.95 },  {  "value" :  "technical" ,  "probability" :  0.02 },  {  "value" :  "shipping" ,  "probability" :  0.01 },  {  "value" :  "other" ,  "probability" :  0.02 }  ],  "confidence" :  0.93  }  ]  }    The answer’s choice field contains a supplied value, here "billing" . It also includes a probabilities array for the options and a confidence field. See (decisions.html#interpret-the-answers) Interpret the answers for guidance on setting thresholds. Include a fallback option such as "other" when your categories don’t cover every possible input. Your application can send that result to a general review queue. Score against a rubric (Copy link to Score against a rubric)     A score question evaluates an input against ordered levels . Define the criteria for each level and arrange them from lowest to highest. Package  Urgent request   How damaged is this package?      0.00 / 2       0 · None 1 · Minor 2 · Major   No damage   1.00  Minor damage   0.00  Major damage   0.00     “  Could you add a dark mode? It would be helpful when I work at night. CSV exports keep failing for one teammate. The rest of our team can still export. Checkout is failing for every customer. We haven’t processed an order in 20 minutes.   0.00 / 2       0 · Low 1 · Medium 2 · High   Low   1.00  Medium   0.00  High   0.00         (Explore score examples)    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17  curl https://api.openai.com/v1/decisions \  -H "Authorization: Bearer  $OPENAI_API_KEY " \  -H "Content-Type: application/json" \  -d '{  "model": "gpt-6-luna",  "input": "Export fails in Safari but works in Chrome.",  "questions": [{  "type": "score",  "name": "severity",  "instructions": "How severe is this issue?",  "levels": [  {"label": "Cosmetic", "description": "Appearance only; no lost functionality."},  {"label": "Workaround available", "description": "A task fails, but another way works."},  {"label": "Fully blocked", "description": "A task fails with no workaround."}  ]  }]  }'    An illustrative response excerpt: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15  {  "answers" : [  {  "type" :  "score" ,  "name" :  "severity" ,  "score" :  1.1 ,  "probabilities" : [  {  "value" :  0 ,  "label" :  "Cosmetic" ,  "probability" :  0.1 },  {  "value" :  1 ,  "label" :  "Workaround available" ,  "probability" :  0.7 },  {  "value" :  2 ,  "label" :  "Fully blocked" ,  "probability" :  0.2 }  ],  "confidence" :  0.55  }  ]  }    Level indices start at 0. Here, 0 means cosmetic, 1 means a workaround is available, and 2 means fully blocked. The returned score is a probability-weighted average, so it can fall between levels. In this example, probabilities of 0.1, 0.7, and 0.2 produce a score of 1.1. The answer also includes confidence and the per-level probabilities . The score summarizes the distribution across levels. Use choice to select a single category. Ask multiple questions (Copy link to Ask multiple questions)     Put independent questions in the same questions array to evaluate shared input. For a product photo, you could check for damage and classify the product category in one request. Each question can use a different type. For decisions that depend on an earlier answer, send separate requests. For example, check for damage first, then use the result to decide whether to request a repair category. Write questions around observable criteria. Separate different concerns into different questions, give choices distinct meanings, and define score levels so that adjacent levels have distinct criteria. Interpret the answers (Copy link to Interpret the answers)     Predicates return the estimated probability that a condition is true. Choice and score answers return a probability distribution and a separate confidence field. Use labeled examples from your application to set thresholds for routing, filtering, or review. Choose thresholds based on the cost of false positives and false negatives. Pricing and availability (Copy link to Pricing and availability)     With gpt-6-luna , input costs $0.10 per 1M tokens . You pay only for input tokens: there are no cache-read, cache-write, or output-token charges. Regional processing premiums and long-context input pricing multipliers apply. These rates apply to /v1/decisions ; other requests using gpt-6-luna follow the applicable (https://developers.openai.com/api/docs/pricing) model and processing-tier pricing . The Decisions API supports Zero Data Retention (ZDR) and HIPAA use for eligible customers. Data residency and regional processing are supported in the United States and Europe (EEA + Switzerland). See (https://developers.openai.com/api/docs/guides/your-data) data controls for eligibility requirements, required agreements, and limitations. Add voice control (Copy link to Add voice control)     Use (https://developers.openai.com/api/docs/guides/decisions-voice) client delegation with the Live API to choose actions from voice requests and report their results to the user.     (https://developers.openai.com/api/docs/guides/migrate-to-responses)   Previous  Responses API    (https://developers.openai.com/api/docs/guides/conversation-state) Next  Conversation state               Ask AI  Docs agent  (Start a new chat)         Loading docs agent...