Partilhar via

Ciclo de vida de visualização da API do Azure OpenAI

  • Artigo

Este artigo é para ajudá-lo a entender o ciclo de vida do suporte para as visualizações da API do Azure OpenAI. As novas APIs de visualização visam uma cadência de lançamento mensal. Sempre que possível, recomendamos o uso das versões mais recentes do GA, ou da API de visualização.

Nota

Novos objetos de resposta da API podem ser adicionados à resposta da API sem alterações de versão. Recomendamos que você analise apenas os objetos de resposta necessários.

Versões mais recentes da API de pré-visualização

Versão mais recente da API OpenAI do Azure:

Esta versão contém suporte para os recursos mais recentes do Azure OpenAI, incluindo:

Alterações entre 2025-01-01-preview e 2024-12_01_preview

Alterações entre 2024-12-01-preview e 2024-10-01-preview

  • store metadata e parâmetros adicionados para suporte a finalizações armazenadas.
  • reasoning_effortadicionado para os modelos de raciocínio mais recentes.
  • user_security_context adicionado para integração com o Microsoft Defender for Cloud.

Alterações entre 2024-09-01-preview e 2024-08-01-preview

  • max_completion_tokens adicionado ao suporte o1-preview e o1-mini modelos. max_tokens Não funciona com os modelos da série O1.
  • parallel_tool_calls adicionado.
  • completion_tokens_details & reasoning_tokens adicionado.
  • stream_options & include_usage adicionado.

Alterações entre a especificação da API 2024-07-01-preview e 2024-08-01-preview

  • Suporte a saídas estruturadas.
  • API de upload de arquivo grande adicionada.
  • Sobre as alterações de dados:
    • Integração com Mongo DB.
    • role_information parâmetro removido.
    • rerank_score adicionado ao objeto de citação.
    • Fonte de dados AML removida.
    • Melhorias na integração da vetorização do AI Search.

Alterações entre a especificação da API 2024-5-01-preview e 2024-07-01-preview

Alterações entre a especificação da API 2024-04-01-preview e 2024-05-01-preview

Alterações entre a especificação da API 2024-03-01-preview e 2024-04-01-preview

Versão mais recente da API do GA

A versão 2024-10-21 da API OpenAI do Azure é atualmente a versão mais recente da API GA. Esta versão da API é a substituição da versão anterior 2024-06-01 da API do GA.

Atualizando versões da API

Recomendamos primeiro testar a atualização para novas versões de API para confirmar que não há impacto para seu aplicativo a partir da atualização da API antes de fazer a alteração globalmente em seu ambiente.

Se você estiver usando as bibliotecas de cliente OpenAI Python ou JavaScript, ou a API REST, precisará atualizar seu código diretamente para a versão mais recente da API de visualização.

Se você estiver usando um dos SDKs do Azure OpenAI para C#, Go ou Java, precisará atualizar para a versão mais recente do SDK. Cada versão do SDK é codificada para funcionar com versões específicas da API do Azure OpenAI.

Próximos passos