release: 4.70.0

[openai-sdks]

Automated Release PR

4.70.0 (2026-09-28)

Features

• add typed Translation WebSocket connection and safe finish (#1094) (e9f070f)
• api: add access programs and credential metadata (#1088) (c197342)
• live: add managed primary WebSocket connections (#1095) (56a2c4b)
• live: add typed WebSocket connections for stored session forks (#1096) (16f53ca)
• live: attach typed observers to eligible signaling sessions (#1097) (aeae12d)
• live: group typed transcript events into stable speaker turns (#1092) (dd9c9a3)
• realtime: add optional managed GA WebSocket connections (#1093) (80530c6)
• responses: add opt-in incremental accumulator snapshots (#1091) (c993f76)

Bug Fixes

• api: correct file download response description (#1090) (79c1a80)
• api: preserve plaintext and rich audio response models (#1083) (59d019d)

Chores

• api: clarify documented API error responses (#1089) (e929b50)
• api: document batch error responses (#1082) (840bb12)
• api: document fine-tuning and model errors (#1087) (2bfb718)
• api: document stored chat completion errors (#1086) (20d1235)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 17.034s for Java SDK PR #1084.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	217ms
tests/chat-completions-create.test.ts	✅ Passed	627ms
tests/chat-completions-stream.test.ts	✅ Passed	798ms
tests/files-content-binary.test.ts	✅ Passed	281ms
tests/files-create-multipart.test.ts	✅ Passed	472ms
tests/files-list-pagination.test.ts	✅ Passed	246ms
tests/initialize-config.test.ts	✅ Passed	137ms
tests/instance-isolation.test.ts	✅ Passed	235ms
tests/models-list.test.ts	✅ Passed	380ms
tests/responses-background-lifecycle.test.ts	✅ Passed	228ms
tests/responses-body-method-errors.test.ts	✅ Passed	574ms
tests/responses-cancel-timeout.test.ts	✅ Passed	250ms
tests/responses-cancel.test.ts	✅ Passed	206ms
tests/responses-compact-retries.test.ts	✅ Passed	557ms
tests/responses-compact.test.ts	✅ Passed	223ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	734ms
tests/responses-create-advanced.test.ts	✅ Passed	1.408s
tests/responses-create-disconnect.test.ts	✅ Passed	1.144s
tests/responses-create-errors.test.ts	✅ Passed	356ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	214ms
tests/responses-create-retries.test.ts	✅ Passed	259ms
tests/responses-create-stream-failures.test.ts	✅ Passed	239ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	234ms
tests/responses-create-stream-wire.test.ts	✅ Passed	6.403s
tests/responses-create-stream.test.ts	✅ Passed	204ms
tests/responses-create-terminal-states.test.ts	✅ Passed	486ms
tests/responses-create-timeout.test.ts	✅ Passed	273ms
tests/responses-create.test.ts	✅ Passed	293ms
tests/responses-delete.test.ts	✅ Passed	222ms
tests/responses-input-items-errors.test.ts	✅ Passed	287ms
tests/responses-input-items-list.test.ts	✅ Passed	319ms
tests/responses-input-items-options.test.ts	✅ Passed	476ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	364ms
tests/responses-input-tokens-count.test.ts	✅ Passed	309ms
tests/responses-malformed-inputs.test.ts	✅ Passed	5.209s
tests/responses-not-found-errors.test.ts	✅ Passed	391ms
tests/responses-parse.test.ts	✅ Passed	741ms
tests/responses-retrieve-retries.test.ts	✅ Passed	903ms
tests/responses-retrieve.test.ts	✅ Passed	289ms
tests/responses-stored-method-errors.test.ts	✅ Passed	1.012s
tests/retry-behavior.test.ts	✅ Passed	3.33s
tests/sdk-error-shape.test.ts	✅ Passed	405ms

View OkTest run #36390266559

_{SDK merge (1841658faa34) · head (df67315bb27b) · base (aeae12de892a) · OkTest (8728ddef7fc7)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

93 mixed files remain; 0 existing customizations changed.

Compared aeae12de892a → df67315bb27b. Generated baselines verified.

93 existing customizations unchanged

• openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuth.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthCreateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthRotateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.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/Response.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/ResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseTextConfig.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesServerEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/WebhookEndpointWithSecret.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/ImageServiceAsyncImpl.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/SkillServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/VideoServiceAsyncImpl.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/audio/TranslationServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/beta/agents/SessionServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/beta/agents/SessionServiceAsyncImpl.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/async/skills/VersionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt

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

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

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

[openai-sdks]

🤖 Created releases:

• v4.70.0

🌻