Visão geral/OpenAPI/Capacidades

Capacidades

Descubra os produtos, parâmetros, templates e modelos disponíveis na conta.

Capacidades

Chame este ponto final antes de cada fluxo de criação:

GET /capabilities

As capacidades descrevem produtos, limites de arquivo, modelos de vídeo e vozes, e opções de modelo de imagem para a conta atual. Use-o para construir controles e validar pedidos em vez de codificar um catálogo de aço.

Secções de alto nível

campo Significado
Produtos Os produtos públicos: vídeo, imagem e aplicativo
Contas Um plano de conta seguro
Arquivos Tipos de arquivo suportados, tamanho e número
Vídeo Opções de Vídeo Explicativo
Imagem Imagem de modelo pacotes
APLICAÇÃO Opções de aplicativo

Vídeo explicativo

O vídeo inclui:

  • Duração - Presetos
  • A proporção de aspecto fixada em 16:9
  • Línguas e Vozes
  • O atual catálogo de cenário-templado
  • Estilos de expressão independentes
  • suporte_files, suporte_url_context e suporte_missões

Um modelo descreve um caso de uso e estrutura de início. Um estilo de expressão descreve como o vídeo parece e comunica. Envie o template_id e expression_style_id de forma independente.

Imagem com IA

Cada entrada em image.models é um pacote de modelo atômico. Os pacotes atuais são:

  • Título: Nano-banana 2
  • Azure_openai + gpt-imagem 2

Cada pacote anuncia seus próprios aspect_ratios, output_qualidades e qualidades. Nunca misture um fornecedor de uma entrada com um modelo ou relação de outra.

O output_qualidade é o tamanho da imagem entregue. Qualidade é uma GPT Image configuração nativa e é válida apenas para azure_openai + gpt-image-2.

Aplicação com IA

As listas de aplicativos suportam idiomas e bandeiras, como suporte_files. A AI App aceita arquivos carregados, mas atualmente não anuncia URL Context. Não diga que ele lê uma página web apenas porque o prompt contém um URL.

  • Leia as capacidades quando a tela de criação se abre.
  • Cache brevemente e suporte manual refrescante.
  • Refrigerar após alterações de conta ou plano.
  • Exibir apenas opções devolvidas para a conta atual.
  • Tratar as capacidades perdidas como inexistentes em vez de adivinhar.