fix(api): clarify audio upload metadata requirements

[jbeckwith-oai]

Summary

Regenerates the Python SDK from the latest OpenAPI input for the audio upload documentation change.

• Clarifies that transcription and translation uploads must include enough metadata for the file format to be identified.
• Recommends an extension-bearing filename and an appropriate content type.
• Updates generated resource docstrings, request parameter docs, the transformed OpenAPI document, and Castiron provenance.

This is documentation-only; runtime behavior and exported type shapes are unchanged.

Source

• Originating API change: openai/openai#1270941
• OpenAPI input: openai/openai-openapi@577fa922

Validation

• Rebased directly onto the current public main
• Every changed file matches the Castiron-generated candidate
• git diff --check
• ./scripts/lint
• Thermo-nuclear code-quality review

[HAYDEN-OAI]

Reviewed the generated audio upload metadata documentation against the approved source change. No substantive issues found.

[openai-sdks]

OkTest Summary

✅ 237/237 SDK tests passed in 12.435s for Python SDK PR #3596.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	184ms
tests/chat-completions-create.test.ts	✅ Passed	256ms
tests/chat-completions-stream.test.ts	✅ Passed	147ms
tests/files-content-binary.test.ts	✅ Passed	290ms
tests/files-create-multipart.test.ts	✅ Passed	260ms
tests/files-list-pagination.test.ts	✅ Passed	164ms
tests/initialize-config.test.ts	✅ Passed	218ms
tests/instance-isolation.test.ts	✅ Passed	208ms
tests/models-list.test.ts	✅ Passed	263ms
tests/responses-background-lifecycle.test.ts	✅ Passed	252ms
tests/responses-body-method-errors.test.ts	✅ Passed	367ms
tests/responses-cancel-timeout.test.ts	✅ Passed	247ms
tests/responses-cancel.test.ts	✅ Passed	267ms
tests/responses-compact-retries.test.ts	✅ Passed	353ms
tests/responses-compact.test.ts	✅ Passed	330ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	313ms
tests/responses-create-advanced.test.ts	✅ Passed	264ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.315s
tests/responses-create-errors.test.ts	✅ Passed	232ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	282ms
tests/responses-create-retries.test.ts	✅ Passed	356ms
tests/responses-create-stream-failures.test.ts	✅ Passed	152ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	226ms
tests/responses-create-stream-wire.test.ts	✅ Passed	3.915s
tests/responses-create-stream.test.ts	✅ Passed	116ms
tests/responses-create-terminal-states.test.ts	✅ Passed	323ms
tests/responses-create-timeout.test.ts	✅ Passed	249ms
tests/responses-create.test.ts	✅ Passed	412ms
tests/responses-delete.test.ts	✅ Passed	267ms
tests/responses-input-items-errors.test.ts	✅ Passed	364ms
tests/responses-input-items-list.test.ts	✅ Passed	318ms
tests/responses-input-items-options.test.ts	✅ Passed	302ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	252ms
tests/responses-input-tokens-count.test.ts	✅ Passed	309ms
tests/responses-malformed-inputs.test.ts	✅ Passed	3.059s
tests/responses-not-found-errors.test.ts	✅ Passed	313ms
tests/responses-parse.test.ts	✅ Passed	428ms
tests/responses-retrieve-retries.test.ts	✅ Passed	355ms
tests/responses-retrieve.test.ts	✅ Passed	282ms
tests/responses-stored-method-errors.test.ts	✅ Passed	765ms
tests/retry-behavior.test.ts	✅ Passed	3.33s
tests/sdk-error-shape.test.ts	✅ Passed	426ms

View OkTest run #31515048290

_{SDK merge (da8ead5eac4e) · head (bb496168455e) · base (06527878b875) · OkTest (91635c6a2723)}