文件问答 · 文件问答
目录路径:文件问答 / 文件问答 · 文件问答
文档 slug:file-qa-chat
文件问答
POST /api/v1/apps/file_qa/chat
对一个或多个公网文档进行问答、摘要和信息提取。客户端只能提交 URL,不能上传文件、Base64 或本地路径。
参数
| 参数 | 类型 | 必填 | 说明 | |
|---|---|---|---|---|
file_urls | string[] | 是 | 1-8 个公网 HTTP/HTTPS 文档地址,支持 PDF、DOC、DOCX、TXT、MD 等格式。 | |
question | string | 是 | 针对文件内容的问题,最长 20,000 字符。 | |
mode | string | 否 | sync | 传 async 或 task 时返回 task_id,通过任务查询接口获取结果。 |
stream | boolean | 否 | 是否返回 SSE,默认 false;仅同步模式生效。 | |
callback_url | string | 否 | 异步模式的完成/失败回调地址。 | |
metadata | object | 否 | 业务关联字段,仅平台记录。 |
请求示例
{
"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}
}
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 平台响应码,1 表示请求成功。 |
data.result | object | 文件问答结果。 |
data.result.answer | string | 模型生成的回答正文。 |
data.result.usage | object | 上游模型用量统计。 |
data.result.usage.input_tokens | integer | 输入 Token 数量。 |
data.result.usage.output_tokens | integer | 输出 Token 数量。 |
data.result.usage.total_tokens | integer | 输入与输出 Token 总数。 |
data.usage | object | 平台计费统计。 |
data.usage.points_cost | number | 本次请求预估/结算点数。 |
data.usage.actual_points | number | 本次请求实际扣除点数。 |
流式响应
同步模式将 stream 设为 true 后,响应类型为 text/event-stream。不要同时传 mode=async;异步模式返回 JSON 任务,不返回 SSE。调用方必须等待 completed 确认成功。
| 事件 | 字段 | 说明 |
|---|---|---|
started | status | 流式响应开始,值为 running。 |
content | delta | 增量回答文本。 |
completed | result、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。