This pull request updates the azure-ai-openai SDK to align with the latest OpenAI Speech API enhancements.

[zuoxinwang]

Description

This pull request updates the azure-ai-openai SDK to align with the latest OpenAI Speech API enhancements. The following changes are included:

1. Extended SpeechVoice Class

Added five new predefined constants to support additional voice options:

• Ash
• Ballad
• Coral
• Sage
• Verse

These new voices reflect recent updates to OpenAI's supported voice set and provide more expressive output options.

2. Added instructions Parameter to SpeechGenerationOptions

Introduced an optional instructions field to the SpeechGenerationOptions class. This allows users to provide high-level behavioral guidance for speech synthesis, as defined by OpenAI's latest spec.

3. Test Enhancements

• Added unit tests covering new SpeechVoice constants.
• Added validation and functional tests for the new instructions parameter.
• All existing test suites pass, and new features are covered by regression tests.

All changes are backward-compatible. This update ensures the SDK remains consistent with upstream API specifications.

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

[github-actions]

Thank you for your contribution @zuoxinwang! We will review the pull request and get back to you soon.

[zuoxinwang]

@microsoft-github-policy-service agree

[zuoxinwang]

Hi @jpalvarezl, @brandom-msft

Could you please take a moment to review this PR when convenient?

This change introduces support for TTS voice customization via an instructions field, and adds predefined voice constants (SAGE, SHIMMER, VERSE) to improve usability.

Please let me know if there are any changes needed. Thank you!

[github-actions]

Hi @zuoxinwang. Thank you for your interest in helping to improve the Azure SDK experience and for your contribution. We've noticed that there hasn't been recent engagement on this pull request. If this is still an active work stream, please let us know by pushing some changes or leaving a comment. Otherwise, we'll close this out in 7 days.

[github-actions]

Hi @zuoxinwang. Thank you for your contribution. Since there hasn't been recent engagement, we're going to close this out. Feel free to respond with a comment containing /reopen if you'd like to continue working on these changes. Please be sure to use the command to reopen or remove the no-recent-activity label; otherwise, this is likely to be closed again with the next cleanup pass.