文档导航
接口信息
请求方法
POST接口地址
https://api.lunwenj.com/api/v1/open/v1/proposal/generate计费方式
按字数计费:1.5元/千字
请求参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
title | string | 是 | 论文题目 | - |
research_background | string | 否 | 研究背景 | - |
word_count | integer | 是 | 目标字数 | 3000 |
research_objectives | string | 否 | 研究目标 | - |
requirements | string | 否 | 其他补充要求 | - |
template_path | string | 否 | 自定义模板路径,支持 uploads 相对路径或完整 URL | - |
代码示例
curl -X POST https://api.lunwenj.com/api/v1/open/v1/proposal/generate \
-H "Content-Type: application/json" \
-H "X-API-Key: ak_xxx.sk_xxx" \
-d '{
"title": "基于机器学习的股票价格预测研究",
"research_background": "随着金融市场数据规模不断增长,传统经验预测方法难以满足精细化投资决策需求。",
"research_objectives": "构建面向股票价格预测的机器学习模型并评估其预测效果。",
"requirements": "需要突出模型对比和实验设计。",
"template_path": "/uploads/proposal_templates/finance.docx",
"word_count": 5000
}'响应示例
成功响应
{
"code": 200,
"message": "ok",
"data": {
"request_id": "req_prop123456",
"content": "一、研究背景\n\n随着金融市场的不断发展,股票价格预测成为投资决策的重要依据...",
"content_structured": {
"topic": "基于机器学习的股票价格预测研究",
"chapters": []
},
"word_count": 5234,
"cost": 7.85,
"balance": 92.15,
"created_at": "2024-01-15T14:00:00Z"
}
}返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,成功固定返回 200。 |
message | string | 响应消息,成功时通常为 ok。 |
data | object | 接口返回的业务数据对象。 |
data.request_id | string | 本次生成请求的唯一标识。 |
data.content | string | 生成后的开题报告 Markdown 内容。 |
data.content_structured | object | 结构化开题报告数据,通常包含主题和章节信息。 |
data.word_count | integer | 返回内容的实际字数。 |
data.images | string[] | 文中图片下载链接列表;没有图片时可能为空。 |
data.cost | number | 本次调用实际消费金额,单位元。 |
data.balance | number | 调用完成后的账户剩余余额,单位元。 |
data.created_at | string(datetime) | 请求完成时间,UTC 时间字符串。 |
错误码
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数不合法 |
| 402 | 账户余额不足 |
| 403 | API Key 无效或已禁用 |
| 429 | 超出并发限制,请稍后重试 |
接口介绍
开题报告 API 可生成研究背景、研究目标、技术路线和进度安排等内容。
适用场景
适用于论文平台、教学系统和科研辅助工具接入。
接入流程
填写题目、研究背景、目标字数和模板参数后调用接口。