Deep Research

plamo-3.1-prime-deep-research は、質問について Web を繰り返し検索し、出典付きのレポートを生成するモデルです。 Responses API に background: true を指定すると、非同期ジョブとして実行されます。生成には数分から数十分かかります。 結果は完了から 24 時間保持されます。

サンプル

リクエスト

curl

$ curl \
    -H "Authorization: Bearer ${PLAMO_API_KEY}" \
    -H "Content-Type: application/json" \
    "https://api.platform.preferredai.jp/v1/responses" \
    -d @- << EOF
{
  "model": "plamo-3.1-prime-deep-research",
  "input": "国内の生成 AI 規制の動向を調べてください",
  "background": true,
  "store": true
}
EOF

レスポンス

作成直後

{
    "id": "resp_3f9a1c...",
    "object": "response",
    "created_at": 1791272415.0,
    "status": "queued",
    "background": true,
    "model": "plamo-3.1-prime-deep-research",
    "output": [],
    "usage": null,
    "tool_usage": null,
    "error": null,
    "tools": [{"type": "web_search"}],
    "max_tool_calls": 100,
    "incomplete_details": null
}

完了後

{
    "id": "resp_3f9a1c...",
    "object": "response",
    "status": "completed",
    "output": [
        {
            "type": "web_search_call",
            "id": "ws_...",
            "status": "completed",
            "action": {"type": "search", "query": "生成AI 規制 日本", "queries": ["生成AI 規制 日本"]}
        },
        {
            "type": "reasoning",
            "id": "rs_...",
            "summary": [{"type": "summary_text", "text": "..."}]
        },
        {
            "type": "message",
            "id": "msg_...",
            "role": "assistant",
            "status": "completed",
            "content": [
                {
                    "type": "output_text",
                    "text": "# 国内の生成 AI 規制の動向\n\n...",
                    "annotations": [
                        {"type": "url_citation", "start_index": 120, "end_index": 180, "url": "https://...", "title": "..."}
                    ]
                }
            ]
        }
    ],
    "usage": {"input_tokens": 182340, "output_tokens": 21530, "total_tokens": 203870},
    "tool_usage": {"web_search": {"num_requests": 18}}
}

注意事項

• 1 ジョブの実行時間の上限は約 25 分です。超えた場合は status: "failed"、error.code: "timeout" で終了します。
• 調査の一部の処理（章の見出しの生成など）が失敗した場合は、その処理を飛ばしてレポートを最後まで書き、status: "incomplete" で終了します。何が欠けたかは reasoning の summary に英語で記載されます。
• 料金は、レポートの生成にかかったトークン数と、tool_usage.web_search.num_requests の検索回数に応じてかかります。