# Generated by ShowAPI OpenAPI generator
# source: market/3206
# generated-at: 2026-06-26T01:56:39.080Z
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: |-
                      文章状态：
                      preparing 准备执行
                      writing 执行中
                      success 执行结束
                  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格式的正文
                    1、Markdown
                    2、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: |-
                                    文章状态：
                                    preparing 准备执行
                                    writing 执行中
                                    success 执行完成
                                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: |-
                              接口成功标识
                              0、成功
                              -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: |-
                              接口是否成功
                              0、成功
                              -1、失败
                          task_status:
                            type: string
                            description: |-
                              文章状态：
                              preparing 准备执行
                              writing 执行中
                              success 执行成功
                        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: |-
                    语言：
                    1、zh  中文
                    2、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
