release: 3.4.0

[openai-sdks]

Automated Release PR

3.4.0 (2026-08-25)

Features

• api: Add obfuscation field to ChatCompletionChunk (#3690) (c7d8e1d)
• api: add project residency configuration and cost quantity units (#3726) (bc4f8ef)

Bug Fixes

• api: encode Realtime call offers and session configuration (#3736) (555ac48)
• apply consistent origin checks to WebSocket redirects (#3693) (1b324d0)
• azure: encode deployment names consistently (#3683) (689538d)
• azure: keep provider validation errors value-free (#3691) (72529c0)
• azure: resolve one authentication mode (#3689) (e3d0681)
• compute custom-code summaries from trusted workflow code (#3692) (2b5868d)
• create upload example fixtures in private directories (#3686) (f36e6f7)
• decode SSE incrementally without limiting event size (#3687) (2598d53)
• keep Python SDK diagnostics metadata-only (#3685) (600aa8d)
• Preserve Azure authentication boundaries across transports (#3684) (06ef57c)
• preserve the configured TLS hostname (#3694) (aa5fbc4)
• preserve WebSocket send queue byte accounting during flush (#3688) (96f966d)

Chores

• api: Clarify image background docs and preview support (#3703) (bedb9a7)
• api: document supported image generation models (#3695) (8edd9ae)
• api: move chat validation tests out of generated code (#3698) (9d3ba20)
• api: move webhook tests out of generated code (#3700) (04ecb3c)
• api: remove redundant generated formatting (#3696) (5ac1e03)
• api: remove redundant generated test edits (#3697) (351ef84)
• api: Update SDK generation metadata only (#3716) (e43b422)
• set a ceiling for Python SDK customization (#3714) (04d5d79)

Documentation

• api: restore generated ChatKit API index (#3705) (4534106)
• standardize Python SDK vulnerability disclosure policy (#3642) (1fc0a21)

Refactors

• api: isolate audio response format selection (#3701) (ece4324)
• api: isolate vector-store polling helpers (#3713) (a002ef3)
• api: move file processing polling into SDK-owned helpers (#3712) (5f20c51)
• api: share embedding response decoding (#3699) (50de9af)
• api: share webhook signature verification (#3704) (e14ac34)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 237/237 SDK tests passed in 12.756s for Python SDK PR #3682.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	395ms
tests/chat-completions-create.test.ts	✅ Passed	327ms
tests/chat-completions-stream.test.ts	✅ Passed	182ms
tests/files-content-binary.test.ts	✅ Passed	338ms
tests/files-create-multipart.test.ts	✅ Passed	209ms
tests/files-list-pagination.test.ts	✅ Passed	191ms
tests/initialize-config.test.ts	✅ Passed	276ms
tests/instance-isolation.test.ts	✅ Passed	283ms
tests/models-list.test.ts	✅ Passed	257ms
tests/responses-background-lifecycle.test.ts	✅ Passed	322ms
tests/responses-body-method-errors.test.ts	✅ Passed	420ms
tests/responses-cancel-timeout.test.ts	✅ Passed	272ms
tests/responses-cancel.test.ts	✅ Passed	333ms
tests/responses-compact-retries.test.ts	✅ Passed	374ms
tests/responses-compact.test.ts	✅ Passed	253ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	196ms
tests/responses-create-advanced.test.ts	✅ Passed	298ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.268s
tests/responses-create-errors.test.ts	✅ Passed	207ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	403ms
tests/responses-create-retries.test.ts	✅ Passed	347ms
tests/responses-create-stream-failures.test.ts	✅ Passed	182ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	228ms
tests/responses-create-stream-wire.test.ts	✅ Passed	3.601s
tests/responses-create-stream.test.ts	✅ Passed	343ms
tests/responses-create-terminal-states.test.ts	✅ Passed	331ms
tests/responses-create-timeout.test.ts	✅ Passed	295ms
tests/responses-create.test.ts	✅ Passed	357ms
tests/responses-delete.test.ts	✅ Passed	372ms
tests/responses-input-items-errors.test.ts	✅ Passed	605ms
tests/responses-input-items-list.test.ts	✅ Passed	300ms
tests/responses-input-items-options.test.ts	✅ Passed	307ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	284ms
tests/responses-input-tokens-count.test.ts	✅ Passed	301ms
tests/responses-malformed-inputs.test.ts	✅ Passed	2.79s
tests/responses-not-found-errors.test.ts	✅ Passed	345ms
tests/responses-parse.test.ts	✅ Passed	455ms
tests/responses-retrieve-retries.test.ts	✅ Passed	315ms
tests/responses-retrieve.test.ts	✅ Passed	280ms
tests/responses-stored-method-errors.test.ts	✅ Passed	839ms
tests/retry-behavior.test.ts	✅ Passed	3.24s
tests/sdk-error-shape.test.ts	✅ Passed	416ms

View OkTest run #32896244245

_{SDK merge (508f3bce7019) · head (a0bad4bcd7da) · base (555ac487f450) · OkTest (2b1bdfd25e98)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

34 mixed files remain; 0 existing customizations changed.

Compared 555ac487f450 → a0bad4bcd7da. Generated baselines verified.

34 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/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/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/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/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/tool.py
• src/openai/types/responses/tool_param.py
• src/openai/types/webhooks/init.py
• tests/api_resources/test_videos.py

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 32896317435 --repo openai/openai-python \
  --name castiron-custom-code-32896317435-1 --dir /tmp/castiron-custom-code-32896317435-1
git apply --stat /tmp/castiron-custom-code-32896317435-1/custom-code.patch
cat /tmp/castiron-custom-code-32896317435-1/custom-code.patch

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

git fetch --no-tags origin 555ac487f450f24928d859478ea2f41b58906206 a0bad4bcd7da56f1b699dba49a019e08926b4f6c
python3 scripts/castiron/custom_code_report.py report \
  --base 555ac487f450f24928d859478ea2f41b58906206 \
  --head a0bad4bcd7da56f1b699dba49a019e08926b4f6c --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-a0bad4bcd7da
cat /tmp/castiron-custom-code-a0bad4bcd7da/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