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.
Comportamento recomendado do cliente
- 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.
