include.html を true にすると、タスクはエンジンが回答時に表示した画面へのリンクを返します。画面は単体で開けるHTMLページとして保存され、レポートに貼れます。
リクエスト
対応エンジン
それ以外のエンジンはこのフラグを
422 EVIDENCE_UNSUPPORTED で拒否します。GET /v1/capabilities は対応エンジンを evidence: true で示します。CHATGPT も、タスクに location がある、CN または HK を指定している、または continueFrom で会話を続けている場合は同じエラーで拒否します。ChatGPT はデバイス位置なしで答えた新しい会話にだけ画面を描きます。
レスポンス
タスクのresponse に html オブジェクトが加わります。例:
アクセスと保存期間
- URLはAPIキーなしで開けるため、リンクやレポートでそのまま使えます。URLを知っていれば誰でも
expiresAtまで開けます。 expiresAtを過ぎるとURLは404を返し、ページは削除されます。残す必要があるものはダウンロードしてください。- 1つのIPアドレスから1分あたり600ページまでダウンロードでき、それを超えると
429を受け取ります。
クレジット
CHATGPT、PERPLEXITY、META_AI では、HTMLページはエンジンの料金に加えて0.25クレジットかかります。送信時に確保され、html.status が ok の場合にのみ請求されます。GEMINI、GOOGLE、AIMODE では追加の費用はかかりません。
ページが失敗するとき
次の場合、タスクは回答とともに完了し、html は { "status": "failed", "error": "EVIDENCE_FAILED" } で返ります。
- エンジンの画面を取得できなかった、または画面が回答と一致しなかった。
- ページを保存できなかった。
GEMINIで、タスクにlocationがある、またはCN、DE、GB、IRを指定している。これらは常に失敗します。