release: 4.53.0

[openai-sdks]

Automated Release PR

4.53.0 (2026-08-23)

Features

• api: Add obfuscation to ChatCompletionChunk (#902) (9b1379b)
• support named data-residency endpoints (#880) (cf942a4)

Bug Fixes

• api: preserve stream IDs for factory-created response errors (#926) (7f9f186)
• ci: isolate trusted Gradle caches from pull requests (#898) (22d09f2)
• prevent concurrent JSON deserialization failures (#875) (e0afe55)
• upgrade Dokka's build-only jsoup dependency (#895) (81134d7)
• upgrade WireMock's test-only Apache HttpComponents dependencies (#897) (4736f7c)

Chores

• api: document supported image generation models (#915) (1b0ad3d)
• configure Java SDK Dependabot updates (#872) (f043e8e)
• set a 2,000-line custom-code budget (#924) (a5228db)
• update example Netty BOM to 4.1.137.Final (#901) (d451dbf)

Documentation

• clarify image transparency and Realtime audio delta behavior (#918) (085ea7d)
• strengthen Java SDK security guidance (#871) (bbbe643)

Refactors

• isolate webhook signature verification (#921) (715a304)
• remove equivalent generated-source edits (#919) (a2f4dde)

Build System

• deps: bump actions/checkout from 6.0.2 to 7.0.1 (#917) (de3e2f6)
• deps: bump actions/setup-java from 5.2.0 to 5.7.0 (#911) (dad38ae)
• deps: bump graalvm/setup-graalvm from 03e8abf916fd0e281b2efe7b2da3378bb0a1d085 to 5298d94fb55a4f185c602eeac5de1b553882abe2 (#908) (4311982)
• deps: bump org.jetbrains.dokka in / (#906) (ca9c11d)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 237/237 SDK tests passed in 16.741s for Java SDK PR #881.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	237ms
tests/chat-completions-create.test.ts	✅ Passed	908ms
tests/chat-completions-stream.test.ts	✅ Passed	334ms
tests/files-content-binary.test.ts	✅ Passed	435ms
tests/files-create-multipart.test.ts	✅ Passed	318ms
tests/files-list-pagination.test.ts	✅ Passed	358ms
tests/initialize-config.test.ts	✅ Passed	201ms
tests/instance-isolation.test.ts	✅ Passed	217ms
tests/models-list.test.ts	✅ Passed	302ms
tests/responses-background-lifecycle.test.ts	✅ Passed	270ms
tests/responses-body-method-errors.test.ts	✅ Passed	439ms
tests/responses-cancel-timeout.test.ts	✅ Passed	231ms
tests/responses-cancel.test.ts	✅ Passed	304ms
tests/responses-compact-retries.test.ts	✅ Passed	575ms
tests/responses-compact.test.ts	✅ Passed	254ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	858ms
tests/responses-create-advanced.test.ts	✅ Passed	1.554s
tests/responses-create-disconnect.test.ts	✅ Passed	1.089s
tests/responses-create-errors.test.ts	✅ Passed	350ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	406ms
tests/responses-create-retries.test.ts	✅ Passed	294ms
tests/responses-create-stream-failures.test.ts	✅ Passed	194ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	210ms
tests/responses-create-stream-wire.test.ts	✅ Passed	6.153s
tests/responses-create-stream.test.ts	✅ Passed	114ms
tests/responses-create-terminal-states.test.ts	✅ Passed	354ms
tests/responses-create-timeout.test.ts	✅ Passed	238ms
tests/responses-create.test.ts	✅ Passed	863ms
tests/responses-delete.test.ts	✅ Passed	229ms
tests/responses-input-items-errors.test.ts	✅ Passed	306ms
tests/responses-input-items-list.test.ts	✅ Passed	275ms
tests/responses-input-items-options.test.ts	✅ Passed	233ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	272ms
tests/responses-input-tokens-count.test.ts	✅ Passed	311ms
tests/responses-malformed-inputs.test.ts	✅ Passed	5.013s
tests/responses-not-found-errors.test.ts	✅ Passed	411ms
tests/responses-parse.test.ts	✅ Passed	576ms
tests/responses-retrieve-retries.test.ts	✅ Passed	309ms
tests/responses-retrieve.test.ts	✅ Passed	337ms
tests/responses-stored-method-errors.test.ts	✅ Passed	980ms
tests/retry-behavior.test.ts	✅ Passed	3.726s
tests/sdk-error-shape.test.ts	✅ Passed	437ms

View OkTest run #32619654420

_{SDK merge (a3de6ce7af4a) · head (b2a45d411e82) · base (5f499c32eb43) · OkTest (2b1bdfd25e98)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

53 mixed files remain; 0 existing customizations changed.

Compared 5f499c32eb43 → b2a45d411e82. Generated baselines verified.

53 existing customizations unchanged

• openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionMessageFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionToolMessageParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/Embedding.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/EmbeddingCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionWebSearch.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseTextConfig.kt
• openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/audio/TranscriptionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/finetuning/checkpoints/PermissionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseServiceImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/WebhookService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/WebhookServiceImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/audio/TranscriptionServiceImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/chat/ChatCompletionService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/finetuning/checkpoints/PermissionServiceImpl.kt
• openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt
• openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/CompletionServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/ImageServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/WebhookServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/audio/TranscriptionServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt
• openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt

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

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

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