Saltar para o conteúdo principal
Defina include.html como true e a tarefa retorna um link para a tela que o mecanismo mostrou com a resposta, salva como uma página HTML autossuficiente que você pode colocar em um relatório.

Requisição

Mecanismos suportados

Os outros mecanismos recusam a flag com 422 EVIDENCE_UNSUPPORTED. GET /v1/capabilities marca os mecanismos suportados com evidence: true. O CHATGPT recusa com o mesmo erro quando a tarefa tem uma location, pede CN ou HK, ou continua uma conversa com continueFrom: o ChatGPT só desenha a tela de uma conversa nova respondida sem localização do dispositivo.

Resposta

O response da tarefa ganha um objeto html. Por exemplo:

Acesso e retenção

  • A URL não exige chave de API, então funciona em um link ou em um relatório. Qualquer pessoa com a URL pode abri-la até expiresAt.
  • Depois de expiresAt, a URL responde 404 e a página é apagada. Baixe o que precisar guardar.
  • Um mesmo endereço IP pode baixar até 600 páginas por minuto; acima disso, recebe 429.

Créditos

No CHATGPT, no PERPLEXITY e no META_AI, a página custa 0,25 crédito além do preço do mecanismo. Esses créditos são reservados no envio e cobrados só quando html.status é ok. No GEMINI, no GOOGLE e no AIMODE, a página não custa nada a mais.

Quando a página falha

A tarefa termina mesmo assim com a resposta, e html chega como { "status": "failed", "error": "EVIDENCE_FAILED" }, quando:
  • a tela do mecanismo não pôde ser obtida ou não correspondia à resposta;
  • a página não pôde ser armazenada;
  • no GEMINI, a tarefa tem uma location ou pede CN, DE, GB ou IR. Esses casos sempre falham.
Reenvie a tarefa para tentar de novo.

Erros

Relacionados