release: 3.15.0

[openai-sdks]

Automated Release PR

3.15.0 (2026-09-18)

Features

• api: add agent session model settings (#3882) (4b15817)
• api: add audio-mini model choices (#3886) (a6eeb3f)
• api: add compaction progress events (#3866) (98e1d24)
• api: add managed Responses WebSocket sessions (#3887) (3b865af)
• api: add prompt-cache prewarming (#3888) (8f7cdb8)

Bug Fixes

• preserve chat stream moderation results (#3864) (b77076d)

Chores

• api: clarify incoming SIP call ID usage (#3885) (f0457ab)
• api: update image request examples (#3889) (bb79676)

Documentation

• realtime: remove nonexistent type imports (#3869) (2971aaf)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 11.731s for Python SDK PR #3870.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	155ms
tests/chat-completions-create.test.ts	✅ Passed	262ms
tests/chat-completions-stream.test.ts	✅ Passed	235ms
tests/files-content-binary.test.ts	✅ Passed	212ms
tests/files-create-multipart.test.ts	✅ Passed	224ms
tests/files-list-pagination.test.ts	✅ Passed	151ms
tests/initialize-config.test.ts	✅ Passed	182ms
tests/instance-isolation.test.ts	✅ Passed	181ms
tests/models-list.test.ts	✅ Passed	262ms
tests/responses-background-lifecycle.test.ts	✅ Passed	198ms
tests/responses-body-method-errors.test.ts	✅ Passed	305ms
tests/responses-cancel-timeout.test.ts	✅ Passed	188ms
tests/responses-cancel.test.ts	✅ Passed	244ms
tests/responses-compact-retries.test.ts	✅ Passed	339ms
tests/responses-compact.test.ts	✅ Passed	288ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	121ms
tests/responses-create-advanced.test.ts	✅ Passed	213ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.184s
tests/responses-create-errors.test.ts	✅ Passed	239ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	218ms
tests/responses-create-retries.test.ts	✅ Passed	550ms
tests/responses-create-stream-failures.test.ts	✅ Passed	693ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	217ms
tests/responses-create-stream-wire.test.ts	✅ Passed	3.945s
tests/responses-create-stream.test.ts	✅ Passed	90ms
tests/responses-create-terminal-states.test.ts	✅ Passed	252ms
tests/responses-create-timeout.test.ts	✅ Passed	203ms
tests/responses-create.test.ts	✅ Passed	230ms
tests/responses-delete.test.ts	✅ Passed	206ms
tests/responses-input-items-errors.test.ts	✅ Passed	397ms
tests/responses-input-items-list.test.ts	✅ Passed	306ms
tests/responses-input-items-options.test.ts	✅ Passed	445ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	241ms
tests/responses-input-tokens-count.test.ts	✅ Passed	281ms
tests/responses-malformed-inputs.test.ts	✅ Passed	2.962s
tests/responses-not-found-errors.test.ts	✅ Passed	211ms
tests/responses-parse.test.ts	✅ Passed	443ms
tests/responses-retrieve-retries.test.ts	✅ Passed	236ms
tests/responses-retrieve.test.ts	✅ Passed	282ms
tests/responses-stored-method-errors.test.ts	✅ Passed	570ms
tests/retry-behavior.test.ts	✅ Passed	3.093s
tests/sdk-error-shape.test.ts	✅ Passed	286ms

View OkTest run #35291119364

_{SDK merge (b2e5ca0e12f3) · head (ee8ce980a55b) · base (b7116e67d72c) · OkTest (cdb90acd46e5)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

46 mixed files remain; 0 existing customizations changed.

Compared b7116e67d72c → ee8ce980a55b. Generated baselines verified.

46 existing customizations unchanged

• api.md
• scripts/castiron/README.md
• scripts/castiron/custom_code_report.py
• scripts/castiron/test_custom_code_report.py
• src/openai/init.py
• src/openai/_client.py
• src/openai/resources/audio/transcriptions.py
• src/openai/resources/audio/translations.py
• src/openai/resources/beta/agents/sessions/sessions.py
• src/openai/resources/beta/beta.py
• src/openai/resources/beta/responses/responses.py
• src/openai/resources/beta/threads/runs/runs.py
• src/openai/resources/beta/threads/threads.py
• src/openai/resources/chat/completions/completions.py
• src/openai/resources/embeddings.py
• src/openai/resources/files.py
• src/openai/resources/live/forks.py
• src/openai/resources/live/live.py
• src/openai/resources/live/sideband.py
• src/openai/resources/realtime/api.md
• src/openai/resources/realtime/realtime.py
• src/openai/resources/responses/responses.py
• src/openai/resources/uploads/uploads.py
• src/openai/resources/vector_stores/file_batches.py
• src/openai/resources/vector_stores/files.py
• src/openai/resources/videos.py
• src/openai/resources/webhooks/init.py
• src/openai/resources/webhooks/webhooks.py
• src/openai/types/beta/agent_session_message.py
• src/openai/types/chat/init.py
• src/openai/types/chat/chat_completion_message_tool_call.py
• src/openai/types/fine_tuning/fine_tuning_job_integration.py
• src/openai/types/realtime/conversation_item_input_audio_transcription_delta_event.py
• src/openai/types/realtime/realtime_error_event.py
• src/openai/types/responses/init.py
• src/openai/types/responses/response.py
• src/openai/types/responses/response_function_web_search.py
• src/openai/types/responses/response_function_web_search_param.py
• src/openai/types/responses/responses_client_event.py
• src/openai/types/responses/responses_client_event_param.py

6 more in the full report.

A changed generated baseline means this report cannot reliably identify which handwritten lines changed.

Inspect the custom-code diff

Download the exact patch produced by this run (requires repository access):

gh run download 35291160929 --repo openai/openai-python \
  --name castiron-custom-code-35291160929-1 --dir /tmp/castiron-custom-code-35291160929-1
git apply --stat /tmp/castiron-custom-code-35291160929-1/custom-code.patch
cat /tmp/castiron-custom-code-35291160929-1/custom-code.patch

Or reproduce it from an SDK checkout containing the vendored reporter:

git fetch --no-tags origin b7116e67d72cafde4c3da4226abc6e96dadbfb14 ee8ce980a55b365040163b863e9d8f471ea3d28c
python3 scripts/castiron/custom_code_report.py report \
  --base b7116e67d72cafde4c3da4226abc6e96dadbfb14 \
  --head ee8ce980a55b365040163b863e9d8f471ea3d28c --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-ee8ce980a55b
cat /tmp/castiron-custom-code-ee8ce980a55b/custom-code.patch

This is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR.

Full report and patch

[jbeckwith-oai]

Reviewed exact release head ee8ce98. The 3.15.0 version agrees across the release manifest, package metadata, runtime version, and lockfile. The changelog range and release entries match the landed conventional commits since v3.14.1; the omitted commit is test-only. The diff is limited to expected release metadata, the diff check is clean, and exact-head CI is green.

[openai-sdks]

🤖 Created releases:

• v3.15.0

🌻