在内容创作和文案撰写领域,能够快速生成高质量的文章是一个重要的需求。**万维易源提供的“精品长文写作一键生成”API为开发者和内容创作者提供了一个高效、便捷的工具,可以通过简单的接口调用生成包含摘要、大纲、总结等部分的完整文章。**本文将详细介绍如何使用该API,以及其核心功能和调用方法。
一、API概述
1. 接入点说明(以“提交写作任务”为例)
- 功能:根据您的要求,生成一篇完整的文章,包含摘要、大纲、总结等。
- 用途:适用于需要快速生成高质量文章的场景,如内容创作、文案撰写、学术研究等。
2. 接口地址
https://route.showapi.com/3206-1?appKey={your_appKey}
请将 {your_appKey}
替换为你在万维易源平台申请的个人 appKey
。
二、请求参数
以下是提交写作任务所需的请求参数:
参数名称 | 类型 | 示例值 | 必须 | 描述 |
---|---|---|---|---|
topic | String | (写作要求) | 是 | 写作要求,描述您希望生成的文章主题和内容。 |
reference_list | String | ["https://www.showapi.com/apiGateway/view/872"] | 否 | 引用链接,提供相关参考链接,帮助生成更准确的内容。 |
lang | String | zh | 否 | 语言:zh 中文en 英文默认为中文。 |
file | File | (引用文件) | 否 | 引用文件,提供相关参考文件,帮助生成更准确的内容。 |
三、返回参数
以下是接口返回的参数及其描述:
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
task_id | String | 034537 | 任务ID,用于查询任务状态和获取生成的文章。 |
topic | String | (写作要求) | 写作要求,与请求中的 topic 相同。 |
remark | String | 提交成功 | 接口调用描述,表示任务提交的结果。 |
ret_code | Number | 0 | 接口是否成功:0 成功-1 失败 |
task_status | String | (文章状态) | 文章状态:preparing 、writing 、success |
四、调用示例
以下是一个使用 curl
命令调用该接口的示例:
curl -X POST 'https://route.showapi.com/3206-1?appKey={your_appKey}' \
-H 'content-type:multipart/form-data' \
-F 'topic=' \
-F 'lang=zh' \
-F 'reference_list=["https://www.showapi.com/apiGateway/view/872"]' \
-F 'file=@{your_file_path}'
请将 {your_appKey}
替换为你在万维易源平台申请的 appKey
,并将 {your_file_path}
替换为你的引用文件路径。
五、返回示例
以下是接口返回的JSON示例:
{
"showapi_res_id": "",
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_body": {
"task_id": "034537",
"task_status":"",
"topic": "",
"remark": "提交成功",
"ret_code": 0
}
}
六、获取 appKey
要获取 appKey
,请访问万维易源的控制台页面:
查看 appKey
七、总结
万维易源的“提交写作任务”API为开发者和内容创作者提供了一个高效、便捷的工具,可以通过简单的接口调用生成包含摘要、大纲、总结等部分的完整文章。通过该API,可以快速生成高质量的文章,适用于内容创作、文案撰写、学术研究等多种场景。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助,请随时访问万维易源的官方文档或联系技术支持。