Create a response

Create a response

Generates text, or JSON that follows a schema you pass, from a prompt, optionally using tools such as web search.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

brew install openai/tools/openai
openai --version

Run openai responses create.

Set $OPENAI_API_KEY in your environment first (get a key: https://platform.openai.com/api-keys).

API (official)

• Base URL: https://api.openai.com/v1
• Endpoint: POST /responses
• Auth: send the header Authorization: Bearer $OPENAI_API_KEY
• Get a key: https://platform.openai.com/api-keys
• Docs: https://developers.openai.com/api/reference/overview

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.