New code samples for Responses API on Azure OpenAI

[guygregory]

Introduction

To help developers get started with all the new features we've recently announced for Responses API this week, I've included some updates to my Python code samples:

https://aka.ms/ResponsesAPI/

These updates are aligned to the features outlined in this article: Introducing New Tools and Features in the Responses API in Azure AI Foundry

Features and Screenshots

🆕 MCP Remote Server
🆕 Background async requests
🆕 Image generation with gpt-image-1
🆕 Support for the new v1 API Preview

Technical Details

• Responses API
• Model Context Protocol
• Azure OpenAI
• Gradio

Challenges and Solutions

Important note: API Evolution

Starting in May 2025, you can now opt in to our next generation of v1 Azure OpenAI APIs which add support for:

• Ongoing access to the latest features with no need to update api-version each month.
• OpenAI client support with minimal code changes to swap between OpenAI and Azure OpenAI when using key-based authentication.

Code samples have been provided for both the v1 API Preview, and also the older API versions. The v1 API Preview samples have a v1.py suffix to distinguish them.

If you want the latest features, I would recommend using the v1 API Preview, with the api-version set to preview. If you need a stable, GA version, and don't need the latest features, then you can use the older API. At time of writing, the latest GA API release is 2024-10-21.

More information: Azure OpenAI in Azure AI Foundry Models API lifecycle