文档导航
API 文档/开题报告 API

开题报告 API

根据论文题目生成完整的开题报告内容,包含研究背景、研究意义、研究内容、技术路线等。

接口信息

请求方法

POST

接口地址

https://api.lunwenj.com/api/v1/open/v1/proposal/generate

计费方式

按字数计费:1.5元/千字

请求参数

参数名类型必填说明默认值
titlestring论文题目-
research_backgroundstring研究背景-
word_countinteger目标字数3000
research_objectivesstring研究目标-
requirementsstring其他补充要求-
template_pathstring自定义模板路径,支持 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"
  }
}

返回参数

字段名类型说明
codeinteger业务状态码,成功固定返回 200。
messagestring响应消息,成功时通常为 ok。
dataobject接口返回的业务数据对象。
data.request_idstring本次生成请求的唯一标识。
data.contentstring生成后的开题报告 Markdown 内容。
data.content_structuredobject结构化开题报告数据,通常包含主题和章节信息。
data.word_countinteger返回内容的实际字数。
data.imagesstring[]文中图片下载链接列表;没有图片时可能为空。
data.costnumber本次调用实际消费金额,单位元。
data.balancenumber调用完成后的账户剩余余额,单位元。
data.created_atstring(datetime)请求完成时间,UTC 时间字符串。

错误码

错误码说明
400请求参数不合法
402账户余额不足
403API Key 无效或已禁用
429超出并发限制,请稍后重试

接口介绍

开题报告 API 可生成研究背景、研究目标、技术路线和进度安排等内容。

适用场景

适用于论文平台、教学系统和科研辅助工具接入。

接入流程

填写题目、研究背景、目标字数和模板参数后调用接口。