文件问答 · 文件问答

目录路径:文件问答 / 文件问答 · 文件问答
文档 slug:file-qa-chat


文件问答

POST /api/v1/apps/file_qa/chat

对一个或多个公网文档进行问答、摘要和信息提取。客户端只能提交 URL,不能上传文件、Base64 或本地路径。

参数

参数类型必填说明
file_urlsstring[]是1-8 个公网 HTTP/HTTPS 文档地址,支持 PDF、DOC、DOCX、TXT、MD 等格式。
questionstring是针对文件内容的问题,最长 20,000 字符。
modestring否sync传 async 或 task 时返回 task_id,通过任务查询接口获取结果。
streamboolean否是否返回 SSE,默认 false;仅同步模式生效。
callback_urlstring否异步模式的完成/失败回调地址。
metadataobject否业务关联字段,仅平台记录。

请求示例

{
  "file_urls": ["https://example.com/document.docx"],
  "question": "请总结核心内容,并列出主要人物",
  "stream": false
}

成功响应

{
  "code": 1,
  "data": {
    "result": {"answer": "文档主要介绍……", "usage": {"input_tokens": 1524, "output_tokens": 968, "total_tokens": 2492}},
    "usage": {"points_cost": 16.5464, "actual_points": 16.5464}
  }
}

响应字段

字段类型说明
codeinteger平台响应码,1 表示请求成功。
data.resultobject文件问答结果。
data.result.answerstring模型生成的回答正文。
data.result.usageobject上游模型用量统计。
data.result.usage.input_tokensinteger输入 Token 数量。
data.result.usage.output_tokensinteger输出 Token 数量。
data.result.usage.total_tokensinteger输入与输出 Token 总数。
data.usageobject平台计费统计。
data.usage.points_costnumber本次请求预估/结算点数。
data.usage.actual_pointsnumber本次请求实际扣除点数。

流式响应

同步模式将 stream 设为 true 后,响应类型为 text/event-stream。不要同时传 mode=async;异步模式返回 JSON 任务,不返回 SSE。调用方必须等待 completed 确认成功。

事件字段说明
startedstatus流式响应开始,值为 running。
contentdelta增量回答文本。
completedresult、usage完整结果与最终计费统计。

示例事件:

event: started
data: {"status":"running"}

event: content
data: {"delta":"文档的核心内容是……"}

event: completed
data: {"status":"completed","result":{"answer":"……"},"usage":{"points_cost":16.5,"actual_points":16.5}}

异步获取结果

提交时传 mode=async(或 mode=task),接口返回任务信息:

{
  "code": 1,
  "data": {"task_id": "202609180001", "status": "pending", "app": "file_qa", "api": "chat"}
}

使用同一个 API Key 轮询:

GET /api/v1/tasks/202609180001
Authorization: Bearer <YOUR_API_KEY>

当 status 为 completed 时,从 result.answer 读取答案;pending/processing 继续等待,failed 读取 error。如果提交时传了 callback_url,任务完成或失败时平台会 POST 通知该地址,仍建议以任务查询结果为最终准确信息。

计费

输入 2,600 点/百万 Token,输出 13,000 点/百万 Token,无缓存输入价格。

总点数 = input_tokens × 2600 / 1000000 + output_tokens × 13000 / 1000000

价格查询:GET /api/v1/pricing?type=app_api&app_code=file_qa&api_code=chat。

同类文章