Repository navigation
docs: clarify image transparency and Realtime audio delta behavior - #918
Merged
Merged
Conversation
Castiron-Internal-PR: openai/openai-java-internal#39 Castiron-Source-SHA: 37b2a4c67995c79e6d3dd56876352e9eb9ec75e9 Castiron-Public-Base-SHA: ca9c11d
Contributor
Castiron custom code✅ No new custom-code files detected. 61 mixed files remain; 0 existing customizations changed. Compared 61 existing customizations unchanged
21 more in the full report. A changed generated baseline means this report cannot reliably identify which handwritten lines changed. Inspect the custom-code diffDownload the exact patch produced by this run (requires repository access): gh run download 32429412339 --repo openai/openai-java \
--name castiron-custom-code-32429412339-1 --dir /tmp/castiron-custom-code-32429412339-1
git apply --stat /tmp/castiron-custom-code-32429412339-1/custom-code.patch
cat /tmp/castiron-custom-code-32429412339-1/custom-code.patchOr reproduce it from an SDK checkout containing the vendored reporter: git fetch --no-tags origin ca9c11dd90be5b10b67797a0af6e575ce776bb6a ddfcc6c1deff03bb6866fcfc3248e00ffc849bcc
python3 scripts/castiron/custom_code_report.py report \
--base ca9c11dd90be5b10b67797a0af6e575ce776bb6a \
--head ddfcc6c1deff03bb6866fcfc3248e00ffc849bcc --fetch --require-head-hash --public \
--out /tmp/castiron-custom-code-ddfcc6c1deff
cat /tmp/castiron-custom-code-ddfcc6c1deff/custom-code.patchThis is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR. |
apcha-oai
marked this pull request as ready for review
August 20, 2026 23:37
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Contributor
jbeckwith-oai
requested changes
Aug 20, 2026
jbeckwith-oai
left a comment
jbeckwith-oai
left a comment
Contributor
There was a problem hiding this comment.
The updated description removes the existing parameter-level restriction that background is supported only for GPT Image models. It now limits only transparent backgrounds, incorrectly implying dall-e-2 / dall-e-3 accept background: "opaque" or "auto". Restore the explicit GPT-Image-only restriction in the canonical OpenAPI description while retaining the new transparency preview and PNG/WebP guidance, then regenerate.
| /** | ||
| * Allows to set transparency for the background of the generated image(s). This parameter is | ||
| * only supported for GPT image models that support transparent backgrounds. Must be one of | ||
| * Allows to set transparency for the background of the generated image(s). Must be one of |
Contributor
There was a problem hiding this comment.
The updated description removes the existing parameter-level restriction that background is supported only for GPT Image models. It now limits only transparent backgrounds, incorrectly implying dall-e-2 / dall-e-3 accept background: "opaque" or "auto". Restore the explicit GPT-Image-only restriction in the canonical OpenAPI description while retaining the new transparency preview and PNG/WebP guidance, then regenerate.
Merged
wskr00
pushed a commit
to wskr00/openai-java
that referenced
this pull request
Aug 31, 2026
Automated Release PR --- ## [4.53.0](openai/openai-java@v4.52.0...v4.53.0) (2026-08-26) ### Features * **api:** Add obfuscation to ChatCompletionChunk ([openai#902](openai#902)) ([9b1379b](openai@9b1379b)) * **api:** add project residency and usage quantity unit support ([openai#933](openai#933)) ([3c63360](openai@3c63360)) * **api:** support backend-mediated Realtime WebRTC calls ([openai#937](openai#937)) ([e1b15f6](openai@e1b15f6)) * **auth:** add fixed-alias X.509 transport capability ([openai#934](openai#934)) ([2303825](openai@2303825)) * support named data-residency endpoints ([openai#880](openai#880)) ([cf942a4](openai@cf942a4)) ### Bug Fixes * **api:** preserve stream IDs for factory-created response errors ([openai#926](openai#926)) ([7f9f186](openai@7f9f186)) * **ci:** isolate trusted Gradle caches from pull requests ([openai#898](openai#898)) ([22d09f2](openai@22d09f2)) * prevent concurrent JSON deserialization failures ([openai#875](openai#875)) ([e0afe55](openai@e0afe55)) * upgrade Dokka's build-only jsoup dependency ([openai#895](openai#895)) ([81134d7](openai@81134d7)) * upgrade WireMock's test-only Apache HttpComponents dependencies ([openai#897](openai#897)) ([4736f7c](openai@4736f7c)) ### Chores * **api:** document supported image generation models ([openai#915](openai#915)) ([1b0ad3d](openai@1b0ad3d)) * configure Java SDK Dependabot updates ([openai#872](openai#872)) ([f043e8e](openai@f043e8e)) * set a 2,000-line custom-code budget ([openai#924](openai#924)) ([a5228db](openai@a5228db)) * update example Netty BOM to 4.1.137.Final ([openai#901](openai#901)) ([d451dbf](openai@d451dbf)) ### Documentation * clarify image transparency and Realtime audio delta behavior ([openai#918](openai#918)) ([085ea7d](openai@085ea7d)) * strengthen Java SDK security guidance ([openai#871](openai#871)) ([bbbe643](openai@bbbe643)) ### Refactors * isolate webhook signature verification ([openai#921](openai#921)) ([715a304](openai@715a304)) * remove equivalent generated-source edits ([openai#919](openai#919)) ([a2f4dde](openai@a2f4dde)) ### Build System * **deps:** bump actions/checkout from 6.0.2 to 7.0.1 ([openai#917](openai#917)) ([de3e2f6](openai@de3e2f6)) * **deps:** bump actions/github-script from 7.1.0 to 9.0.0 ([openai#931](openai#931)) ([63fb3e0](openai@63fb3e0)) * **deps:** bump actions/setup-java from 5.2.0 to 5.7.0 ([openai#911](openai#911)) ([dad38ae](openai@dad38ae)) * **deps:** bump graalvm/setup-graalvm from 03e8abf916fd0e281b2efe7b2da3378bb0a1d085 to 5298d94fb55a4f185c602eeac5de1b553882abe2 ([openai#908](openai#908)) ([4311982](openai@4311982)) * **deps:** bump org.jetbrains.dokka in / ([openai#906](openai#906)) ([ca9c11d](openai@ca9c11d)) * **deps:** bump org.junit.jupiter:junit-jupiter in / ([openai#912](openai#912)) ([36480c7](openai@36480c7)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). Co-authored-by: openai-sdks[bot] <284451331+openai-sdks[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates Java SDK documentation to note that transparent backgrounds are in preview for gpt-image-2 and gpt-image-2-2026-04-21, with png or webp required for transparent output. Also clarifies that Realtime translation audio deltas contain variable-length PCM16 chunks that clients should decode and queue in full. No API signatures or runtime behavior change.