# Generated by ShowAPI OpenAPI generator # source: market/3225 # generated-at: 2026-07-26T04:01:16.854Z openapi: 3.0.3 info: title: 易源漫画 description: 用你的形象创建漫画，记录你的生活。 保持角色一致性，生成高清质量的漫画绘本。 您可以输入一句话故事内容，或随手拍一张照片，AI根据此故事和图片进行联想创作，生成剧情连贯的漫画。 比如成语寓言漫画、课文连环画、生活漫画、工作漫画、创意故事漫画等等。(0元测试套餐可生成2本漫画) termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /3225-17: x-pointCode: 17 x-mode: mapping x-read-timeout: 10 x-connect-timeout: 10 post: summary: AI修改角色作图提示词 description: 比如原prompt是"a girl ".你可以设置修改要求："把女孩加上眼镜，衣服改为白色 "。之后AI会将修改后的prompt返回。如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number new_prompt: type: string description: AI调整后的提示词 description: 业务返回体 operationId: 3225_17_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id char_id: type: string description: 需要调整prompt词的角色id modify_info: type: string description: 对作图prompt词的修改要求。比如：把女孩加上帽子，手里拿着一个苹果。 out_user_id: type: string description: 外部用户id required: - book_id - char_id - modify_info /3225-16: x-pointCode: 16 x-mode: mapping x-read-timeout: 10 x-connect-timeout: 10 post: summary: AI修改分镜作图提示词 description: 比如原prompt是"a girl in school ".你可以设置修改要求："把女孩加上帽子，学校里有花园"。之后AI会将修改后的prompt返回。如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number new_prompt: type: string description: AI调整后的提示词 description: 业务返回体 operationId: 3225_16_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id panel_id: type: string description: 需要调整prompt词的分镜id modify_info: type: string description: 对作图prompt词的修改要求。比如：把女孩加上帽子，手里拿着一个苹果。 out_user_id: type: string description: 外部用户id required: - book_id - panel_id - modify_info /3225-15: x-pointCode: 15 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 删除漫画书本 description: 根据书本id删除一本漫画。高危操作，请确认。如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 0为成功，其他为失败。 remark: type: string description: 业务返回体 operationId: 3225_15_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 要删除的书本id out_user_id: type: string description: 外部用户id required: - book_id /3225-14: x-pointCode: 14 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 更新漫画书本 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string book: type: object properties: book_id: type: string description: 书本id。后面可以通过此值查询书本详情。 lut: type: string description: 最后更新时间 description: 业务返回体 operationId: 3225_14_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id title: type: string description: 书本标题 story: type: string minLength: 0 maxLength: 10000000 description: 漫画的故事。 panel_num: type: number description: 分镜数量，1到30之间。 enable_long_shot: type: string description: 是否启用远景镜头 。1为启用，0为不启用。默认0。 远景时，人物较小，景物大。 more_info: type: string description: |- 生成漫画的更多要求。比如一个故事，系统不能判断它的故事时间背景，有可能就会让人物穿现代装。那在这里可以加入 “ 这是中国古代的故事，要穿古装。 ” out_user_id: type: string description: 外部用户id required: - book_id /3225-13: x-pointCode: 13 x-mode: mapping x-read-timeout: 20 x-connect-timeout: 20 get: summary: 查询合成书本记录 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: page_obj: type: object properties: allNum: type: number allPages: type: number currentPage: type: number maxResult: type: number contentlist: type: array items: type: object properties: model: type: string quota: type: number width: type: number ct: type: string callback_url: type: string business: type: string seed: type: string remark: type: string book_id: type: string description: 书本id height: type: number main_character: type: string style_code: type: string summary: type: string status: type: string lut: type: string progress: type: number img_url: type: string panel_num: type: number remark: type: string ret_code: type: number description: 业务返回体 operationId: 3225_13_GET parameters: - name: book_id in: query description: 书本id required: true schema: type: string - name: out_user_id in: query description: 外部用户id required: false schema: type: string - name: page in: query description: 第几页。每页共20条 required: false schema: type: number /3225-12: x-pointCode: 12 x-mode: mapping x-read-timeout: 20 x-connect-timeout: 20 get: summary: 查看漫画生成日志 description: 查看单本漫画生成日志。如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: list: type: array items: type: object properties: info: type: string description: 日志内容 id: type: string ct: type: string ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_12_GET parameters: - name: book_id in: query description: 书本id required: true schema: type: string - name: out_user_id in: query description: 外部用户id required: false schema: type: string /3225-11: x-pointCode: 11 x-mode: mapping x-read-timeout: 30 x-connect-timeout: 30 post: summary: 修改角色信息 description: 修改角色的名称、描述、引用图、引用相似度、prompt词。注意修改完后，需要重绘才会有新效果。如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_11_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id char_id: type: string description: 角色id prompt: type: string description: 角色生图的提示词 char_name: type: string description: 角色名称 char_desc: type: string description: 角色描述 char_cref: type: string description: 角色引用的url图片地址 char_cref_base64: type: string minLength: 0 maxLength: 100000000 description: "角色引用的base64. 本字段值会覆盖char_cref值。 " char_similar_str: type: string description: 你传入的图与生成图之间的相似度。 取值为 low , middle , high 。 默认为low 。 越像会丧失更多的创作灵活性。 required: - book_id - char_id - prompt - char_name /3225-10: x-pointCode: 10 x-mode: mapping x-read-timeout: 10 x-connect-timeout: 10 post: summary: 修改分镜信息 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 0为成功，其他失败。 remark: type: string description: 业务返回体 operationId: 3225_10_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id panel_id: type: string description: 分镜id article: type: string description: 文案。必须传。就算不改，也要把老的传来。 prompt: type: string description: 作图提示词。不传，或传空串，则不做修改 dialogue_list: type: string description: 对话，遵循json列表规范。不传，或传空串，则不做修改 used_char_list: type: string description: 引用的角色列表。遵循json列表规范。不传，或传空串，则不做修改 out_user_id: type: string description: 外部用户id required: - book_id - panel_id - article /3225-9: x-pointCode: 9 x-mode: mapping x-read-timeout: 20 x-connect-timeout: 20 get: summary: 查询书本详情 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: book: type: object properties: img_url: type: string description: 封面图片 out_user_id: type: string description: 子用户id ct: type: string role_consistency: type: number description: 是否开启角色一致性。1为开，0为关。 sref: type: string description: 场景引用的数字编码。仅数字。 status: type: string description: 运行状态，有DOING, DONE, FAILED. base_info: type: string description: 故事发生的地区与时代信息，故事里的人物简介 remark: type: string progress: type: number description: 进度。 width: type: number height: type: number callback_url: type: string book_id: type: string description: 书本id title: type: string description: 书本标题 story: type: string description: 输入的故事 image_story: type: string description: 输入的插图解析后的故事。 more_info: type: string description: 写故事时的更多要求。 main_character: type: string description: 主角色的形象图片url .只有一个主角色。 summary: type: string description: 本故事的整体摘要 story_type: type: string description: 故事类型 image_story_url: type: string description: 输入的图片链接 enable_long_shot: type: number description: 是否启用远景。1为启用，0为关闭。启用远景后，人物会小一些。 style_code: type: string description: 作图风格，有comic,illustration等。用auto表示ai自动选择。 panel_list: type: array items: type: object properties: main_ind: type: number description: 在合成一本书时，选img_list中的哪一张作为本分镜主图。 img_list: type: array items: type: string description: 分镜的图片列表 used_char_list: type: array items: type: string description: 本分镜用到的角色列表。数字表示角色编号。 task_id: type: string description: 对应的作图任务，可用于日志记录。 article: type: string description: 文案 num: type: number description: 分镜号 dialogue_list: type: array items: type: string panel_id: type: string description: 分镜id prompt: type: string description: "本分镜的作图提示词prompt。可用于stable diffusion, flux. " panel_num: type: number description: 分镜数量 lut: type: string char_list: type: array items: type: object properties: char_cref: type: string description: 角色引用的图片url body_shape: type: string glasses: type: string age: type: string is_human: type: boolean hairstyle: type: string task_id: type: string era: type: string description: 故事发生的年代。 char_id: type: string description: 角色id clothing: type: object properties: {} char_name: type: string facial_features: type: object properties: {} main_ind: type: number img_list: type: array items: type: string description: 角色的图片列表 prompt: type: string description: "本角色的作图提示词。可用于stable diffusion, flux. " num: type: number description: 角色编号 gender: type: string char_similar: type: number height: type: string char_desc: type: string nationality: type: string main_char: type: boolean ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_9_GET parameters: - name: book_id in: query description: 书本id required: true schema: type: string - name: out_user_id in: query description: 外部用户id required: false schema: type: string /3225-8: x-pointCode: 8 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 合成一本书 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_8_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id out_user_id: type: string description: 外部用户id required: - book_id /3225-7: x-pointCode: 7 x-mode: mapping x-read-timeout: 120 x-connect-timeout: 120 post: summary: 重绘所有分镜 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_7_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id out_user_id: type: string description: 外部用户id required: - book_id /3225-6: x-pointCode: 6 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 重绘一个分镜 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_6_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id panel_id: type: string description: 分镜id out_user_id: type: string description: 外部用户id required: - book_id - panel_id /3225-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 重绘一个角色 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id char_id: type: string description: 角色id out_user_id: type: string description: 外部用户id required: - book_id - char_id /3225-4: x-pointCode: 4 x-mode: mapping x-read-timeout: 30 x-connect-timeout: 30 post: summary: 设置分镜主图 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_4_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id panel_id: type: string description: 分镜id main_ind: type: number description: 分镜主图序号，1到4 out_user_id: type: string description: 外部用户id required: - book_id - panel_id - main_ind /3225-3: x-pointCode: 3 x-mode: mapping x-read-timeout: 30 x-connect-timeout: 30 post: summary: 设置角色主图 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string description: 业务返回体 operationId: 3225_3_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: book_id: type: string description: 书本id char_id: type: string description: 角色id main_ind: type: number description: 角色主图序号，1到4 out_user_id: type: string description: 外部用户id required: - book_id - char_id - main_ind /3225-2: x-pointCode: 2 x-mode: mapping x-read-timeout: 20 x-connect-timeout: 20 get: summary: 查询书本分页 description: 如需UI界面使用，请到 https://www.yicaiai.com/ responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: page_obj: type: object properties: allNum: type: number allPages: type: number currentPage: type: number maxResult: type: number contentlist: type: array items: type: object properties: model: type: string quota: type: number width: type: number ct: type: string callback_url: type: string business: type: string seed: type: string remark: type: string book_id: type: string description: 书本id height: type: number main_character: type: string style_code: type: string summary: type: string status: type: string lut: type: string progress: type: number img_url: type: string panel_num: type: number remark: type: string ret_code: type: number description: 业务返回体 operationId: 3225_2_GET parameters: - name: page in: query description: 第几页。每页共20条 required: false schema: type: number - name: out_user_id in: query description: 外部用户id required: false schema: type: string /3225-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 创建漫画书本 description: 如需UI界面使用，请到 https://www.yicaiai.com/ ，赠送20元试用。查看支持的风格类型 https://www.showapi.com/apiGateway/view/3225?tab=3 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number remark: type: string book: type: object properties: book_id: type: string description: 书本id。后面可以通过此值查询书本详情。 ct: type: string description: 创建时间 status: type: string description: 书本状态 description: 业务返回体 operationId: 3225_1_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: story: type: string minLength: 0 maxLength: 10000000 description: 漫画故事描述。 image_story_url: type: string description: 一张故事内容参考图的url地址。由系统分析图片内容，根据里面的人物、景像，结合story字段（它们是互补关系），AI会联想创造一篇高质量有吸引力的故事，此故事用来作分镜漫画的基础。story和 image_story_url至少要输入一个。 image_story_base64: type: string minLength: 0 maxLength: 100000000 description: image_story_url的另一种输入形式。image_story_url是url，而本字段是base64图片。 panel_num: type: number description: 分镜数量，4到20之间。 style_code: type: string description: 漫画类型。Auto指ai自行判断选择。可以选的有 Antique_Illustration ，Comic，Gongbi_Painting，Cartoon_Minimalist等。 main_character: type: string description: 图片的url地址。如果不为空，则漫画中创建的主人公将以此图片的人物为外貌原型。 main_character_64: type: string minLength: 0 maxLength: 10000000 description: main_character字段的另一种输入形式，base64图片。 enable_long_shot: type: string description: 是否启用远景镜头 。1为启用，0为不启用。默认0。 远景时，人物较小，景物大。 more_info: type: string description: |- 生成漫画的更多要求。比如一个故事，系统不能判断它的故事时间背景，有可能就会让人物穿现代装。那在这里可以加入 “ 这是中国古代的故事，要穿古装。 ” no_char: type: number description: 为1则作图时不生成人物角色。对于诗歌风景类分镜，建议使用1参数。 默认为0，按需生成人物。 out_user_id: type: string description: 外部用户id required: - panel_num 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/3225?tab=book x-apiCode: "3225" x-is-own: false x-is-op: false