{ "openapi": "3.0.3", "info": { "title": "精品长文一键写作", "description": "本API是一款先进的自动化写作工具，专为自媒体作者、营销专家、产品说明编写者以及SEO优化师设计。它通过先进的算法，能够根据用户提供的单一主题句，快速联网搜索相关信息，进行合理联想及扩展，最终生成高质量的内容摘要、关键词、多层章节目录和正文内容。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/3206-5": { "x-pointCode": 5, "x-mode": "mapping", "x-read-timeout": 300, "x-connect-timeout": 300, "post": { "summary": "生成文案配图", "description": "根据已经生成的文章，生成相应的配图", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "img": { "type": "string", "description": "图片 目前只有一张" }, "remark": { "type": "string" }, "ret_code": { "type": "number" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "3206_5_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "task_id": { "type": "string", "description": "任务id，具有唯一性" } }, "required": [ "task_id" ] } } } } } }, "/3206-3": { "x-pointCode": 3, "x-mode": "mapping", "x-read-timeout": 60, "x-connect-timeout": 60, "post": { "summary": "查询文章详情", "description": "单篇文章的内容详情，可以返回Markdown格式", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "description": "文章标题" }, "task_id": { "type": "string", "description": "任务id" }, "topic": { "type": "string", "description": "写作要求" }, "content": { "type": "string", "description": "文章正文" }, "keywords": { "type": "array", "items": { "type": "object", "properties": { "keyword": { "type": "string", "description": "关键词" }, "is_ai": { "type": "boolean" } } }, "description": "关键词列表" }, "remark": { "type": "string", "description": "返回描述" }, "ret_code": { "type": "number", "description": "调用标识 0为成功 其它失败" }, "task_status": { "type": "string", "description": "文章状态：\npreparing 准备执行\nwriting 执行中\nsuccess 执行结束" }, "imgs": { "type": "array", "items": { "type": "string" }, "description": "生成配图列表" }, "outline": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "章节名称" }, "child_list": { "type": "array", "items": { "type": "string" }, "description": "子章节列表" } } }, "description": "文章章节列表" } } } } } } }, "operationId": "3206_3_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "task_id": { "type": "string", "description": "任务id，具有唯一性" }, "need_md": { "type": "string", "description": "返回Markdown格式的正文\n1、Markdown\n2、json" } }, "required": [ "task_id" ] } } } } } }, "/3206-2": { "x-pointCode": 2, "x-mode": "mapping", "x-read-timeout": 60, "x-connect-timeout": 60, "post": { "summary": "查询任务列表", "description": "提交任务的列表查询，近30天的任务", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "allNum": { "type": "number", "description": "总数" }, "contentlist": { "type": "array", "items": { "type": "object", "properties": { "remark": { "type": "string", "description": "文章成功与否描述" }, "topic": { "type": "string", "description": "文章要求" }, "task_id": { "type": "string", "description": "文章任务id" }, "title": { "type": "string", "description": "文章标题" }, "task_status": { "type": "string", "description": "文章状态：\npreparing 准备执行\nwriting 执行中\nsuccess 执行完成" }, "content_length": { "type": "number", "description": "文章长度" }, "ct": { "type": "string", "description": "提交时间" } } }, "description": "列表" }, "maxResult": { "type": "number", "description": "当前页最大数" }, "allPages": { "type": "number", "description": "总页数" }, "currentPage": { "type": "number", "description": "当前页数" }, "remark": { "type": "string", "description": "调用成功与否描述" }, "ret_code": { "type": "number", "description": "接口成功标识\n0、成功\n-1、失败" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "3206_2_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "page": { "type": "string", "description": "页码" } } } } } } } }, "/3206-1": { "x-pointCode": 1, "x-mode": "mapping", "x-read-timeout": 60, "x-connect-timeout": 60, "post": { "summary": "提交写作任务", "description": "根据您的要求，生成一篇完整的文章，包含摘要、大纲、总结等", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "task_id": { "type": "string", "description": "任务id" }, "topic": { "type": "string", "description": "写作要求" }, "remark": { "type": "string", "description": "接口调用描述" }, "ret_code": { "type": "number", "description": "接口是否成功\n0、成功\n-1、失败" }, "task_status": { "type": "string", "description": "文章状态：\npreparing 准备执行\nwriting 执行中\nsuccess 执行成功" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "3206_1_POST", "parameters": [], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "topic": { "type": "string", "description": "写作要求" }, "reference_list": { "type": "string", "description": "引用链接" }, "lang": { "type": "string", "description": "语言：\n1、zh 中文\n2、en 英文" }, "file": { "type": "string", "format": "binary", "description": "引用文件" } }, "required": [ "topic" ] } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/3206?tab=book" }, "x-apiCode": "3206", "x-is-own": true, "x-is-op": true }