Especificação da API

Envie um primeiro pedido, selecione um modelo no catálogo e conserve um identificador do pedido para diagnóstico.

Envie uma chave de API num cabeçalho Bearer e mantenha as credenciais de produção separadas das de desenvolvimento.

Use URLs base diferentes para clientes de estilo OpenAI e Messages: visam uma especificação, mas compõem os caminhos de forma diferente.

Configure um cliente com uma chave, um modelo e um URL base adequado ao respetivo protocolo; mantenha o segredo no ambiente.

Respostas práticas e breves sobre chaves, URLs base, modelos, custos e diagnóstico de integrações.

Construa a seleção de modelos com dados do catálogo, e não com uma lista fixa na aplicação.

Separe chaves, proprietários, orçamentos e rastreios de utilização entre aplicações e espaços de trabalho.

Considere os limites da chave, da organização, do modelo e do encaminhamento como parte do fluxo do utilizador.

Associe os metadados da resposta e os seus próprios registos de pedidos a ações reais dos utilizadores.

Minimize os dados transmitidos, separe do conteúdo o identificador do utilizador final e controle a retenção no seu produto.

Crie conversas de vários turnos no formato messages habitual e selecione um modelo para cada pedido.

Use o formato Messages para conversas com uma instrução de sistema de nível superior e um limite de saída explícito.

Use um objeto de entrada quando a sua aplicação beneficiar de tratar itens de saída e ações num único modelo de dados.

Receba tokens e incrementos estruturados por SSE sem esperar pela resposta completa.

Descreva funções com esquema JSON, execute a chamada na aplicação e devolva o resultado à conversa.

Peça um objeto JSON ou um esquema JSON quando a resposta se destinar a software e não a uma pessoa.

Defina o esforço de raciocínio por pedido apenas para modelos que declarem essa capacidade.

Expresse os requisitos de execução nas preferências do fornecedor e conserve o resultado efetivo para observabilidade.

Separe o contexto recorrente, para o cliente poder usar cache compatível quando o modelo escolhido a suportar.

Recupere fontes recentes através de uma função `web_search` executada pelo cliente e mantenha as ligações separadas do texto gerado.

Carregue um ficheiro através de uma operação própria, conserve o respetivo ID e passe uma referência num pedido compatível posterior.

Crie imagens através de uma única rota e selecione parâmetros entre as capacidades do modelo escolhido.

Inicie o vídeo como tarefa assíncrona, conserve o respetivo ID e mantenha a criação separada da leitura do resultado.

Use operações separadas para síntese de voz, transcrição e entrada de áudio num modelo.

Transforme texto ou entradas compatíveis em vetores para pesquisa, agrupamento e recomendações.

Reordene um pequeno conjunto de candidatos em função de uma consulta para melhorar a precisão da recuperação final.

Processe operações independentes em grupos controlados quando o fluxo de trabalho permitir entrega assíncrona.

Ligue um cliente de IA a ferramentas, recursos e prompts permitidos através de um URL de ligação emitido nas definições da conta.

Estruture o tratamento com base no estado HTTP, num corpo de erro estruturado e no ID do pedido, e não no texto da mensagem.