Resumo

Use o recurso de Resumo para condensar textos, imagens e PDFs em resumos curtos, opcionalmente guiados por instruções sobre formato, foco, idioma ou comprimento. Ele se adapta a relatórios, artigos, contratos e documentos digitalizados que precisam de uma visão geral rápida antes da revisão, pesquisa ou de uma etapa posterior do fluxo de trabalho.

Um resumo reafirma o documento com novas palavras, sem adicionar informações ou comentários. Para obter campos específicos no formato JSON, use Extração. Para fazer perguntas abertas sobre mídia ou descrever conteúdo visual, use Descrições de Mídia.

Antes de chamar este endpoint, crie uma chave de API e certifique-se de que a conta tenha um saldo positivo.

Endpoint #

Comportamento da solicitação #

Imagens e arquivos aceitam dados URL base64 ou URLs HTTP(S) públicos. Os formatos suportados são JPEG, PNG, TIFF e PDF, incluindo PDFs de várias páginas. A AIVAX baixa URLs remotos antes do processamento, dentro do limite de tamanho de arquivo em Preços e limites; o recurso deve ser acessível sem login. Outros tipos de conteúdo, como áudio ou vídeo, retornam 400 Bad Request. O erro não identifica qual documento foi rejeitado, portanto, verifique o tipo de conteúdo de cada documento na solicitação.

{
  "instructions": "Responda em três tópicos, em inglês.",
  "documents": [
    {
      "type": "file",
      "file": {
        "filename": "bitcoin.pdf",
        "file_data": "https://bitcoin.org/bitcoin.pdf"
      }
    }
  ]
}

Leia a resposta #

data contém uma string de resumo por documento, na mesma ordem que documents. Os documentos são resumidos independentemente e em paralelo; para obter um único resumo de vários documentos, envie-os como um único documento de texto ou resuma os resumos individuais em uma segunda solicitação.

{
  "message": null,
  "data": [
    "- Propõe um sistema de dinheiro eletrônico ponto a ponto que funciona sem uma terceira parte confiável.\n- Previne o gasto duplo com uma cadeia de prova de trabalho de transações carimbadas no tempo.\n- Permanece seguro enquanto nós honestos controlam a maior parte do poder de computação."
  ]
}

Se qualquer documento falhar, a solicitação retorna um erro em vez de resultados parciais. Documentos que foram concluídos antes da falha ainda são cobrados e contam para sua cota, portanto, tente novamente apenas após corrigir o documento com falha. Os resumos são gerados pelo modelo e podem omitir ou declarar incorretamente detalhes; verifique informações importantes contra o documento original.

Preços e limites #

O Resumo é cobrado pelos tokens de entrada de cada documento. Tokens de saída não são cobrados.

O Resumo e a Extração compartilham os mesmos limites de documentos. Arquivos remotos são baixados até 5 MB cada. O número de documentos processados por minuto e por dia depende do plano; consulte Limites de processamento de dados.

A cota conta cada item no array documents da solicitação, não cada solicitação HTTP. Uma solicitação que excederia qualquer janela ativa retorna 429 Too Many Requests.

A referência de API embutida contém os detalhes mantidos pelo servidor de solicitação, resposta, autenticação e erro: