AI绘画实战：如何快速上手创建绘画API，生成艺术作品

在数字艺术和创意设计领域，AI绘画技术正变得越来越流行。**万维易源提供的“创建绘画”API为艺术家、设计师和开发者提供了一个强大的工具，可以通过简单的接口调用生成高质量的绘画作品。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。

一、API概述

1. 接入点说明

万维易源的“创建绘画”API支持通过简单的接口调用生成高质量的绘画作品。用户可以通过设置创作提示词、图片尺寸、创作步骤等参数，实现个性化的绘画创作。该API特别适用于生成艺术作品、设计草图、插画等。

2. 接口地址

https://route.showapi.com/3041-1?appKey={your_appKey}

请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。

二、请求参数

以下是提交绘画创作任务所需的请求参数：

参数名称	类型	示例值	必须	描述
ext_app_params	Object	{ "app_type":"qr_code", "ext_params":{"type":"sea","url":"https://www.showapi.com"} }	否	对单独应用的扩展参数。例如二维码、房间设计、图片风格化等。
prompt	String	明月出天山，苍茫云海间	是	创作提示词，建议使用英文，不超过250个词。
negetive_prompt	String	（反向提示词）	否	反向提示词，不填则使用默认值。
call_back	String	（回调地址）	否	任务完成时的回调地址，任务完成时会通过这个HTTP地址推送结果，回调方式为POST，payload格式为JSON。
batch_size	Number	1	否	每个任务创作图片数量，支持1~4，默认为1。数字越大，调用时扣费越贵，任务花费时间也越久。
scale	Number	3.5	否	提示词的scale，范围在1~20之间，默认为3.5。
seed	Number	-1	否	随机种子数，范围在-1~4294967290之间，默认为-1。
width	Number	768	否	创作图片的宽度，必须是8的倍数，最小512，最大1024，默认为768。
height	Number	768	否	创作图片的高度，必须是8的倍数，最小512，最大1024，默认为768。
steps	Number	5	否	创作步骤数，最小5，最大50，默认为5。

三、返回参数

以下是接口返回的参数及其描述：

参数名称	类型	示例值	描述
showapi_fee_num	Number	1	表示扣费的数量，1表示扣费一次，2则表示扣减2个图的调用量。
result_list	String[]	[]	结果数组。
scale	Number	8	创作绘画强度。
cause	String	（失败原因）	任务创作失败的原因。
status	String	waiting	任务状态，有waiting、fail、finish三个状态。
scheduler	String	K_EULER	使用的采样算法代码（不可修改）。
remark	String	（失败原因）	任务提交失败的原因。
seed	Number	-1	随机种子数。
width	Number	512	图片宽度。
task_id	String	sk202308152ztQbbihuHFYHlHPSthrK	该任务的task_id。
batch_size	Number	1	创作图片数量。
steps	Number	25	创作步数。
negetive_prompt	String	（反向提示词）	反向提示词（不可修改）。
lora_scale	String	0.9	lora模型强度。
ret_code	Number	0	0表示任务提交成功，-1表示任务提交失败。
height	Number	768	图片高度。
call_back	String	（回调地址）	您设置的任务回调地址。
prompt	String	((beautiful face)), extremely delicate facial,(best quality),(extremely detailed cg 8k wallpaper), masterpiecel,asian,an extremely delicate and beautiful, extremely detailed,intricate,solo,ear ring,tender shining,amazing scene lighting,medium hair,wet hair(collared shirt),standing,(upper body),arms behind back,light smile,necklace,greenhouse	您的创作提示词。

四、调用示例

以下是一个使用 curl 命令调用该接口的示例：

curl 'https://route.showapi.com/3041-1?appKey=your_appKey' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'seed=-1' \
  -d 'width=768' \
  -d 'height=768' \
  -d 'steps=5' \
  -d 'negetive_prompt=' \
  -d 'batch_size=1' \
  -d 'call_back=' \
  -d 'ext_app_params=%7B%20%20%22app_type%22%3A%22qr_code%22%2C%20%20%22ext_params%22%3A%7B%22type%22%3A%22sea%22%2C%22url%22%3A%22https%3A%2F%2Fwww.showapi.com%22%7D%20%7D' \
  -d 'scale=3.5' \
  -d 'prompt=%E6%98%8E%E6%9C%88%E5%87%BA%E5%A4%A9%E5%B1%B1%EF%BC%8C%E8%8B%8D%E8%8C%AB%E4%BA%91%E6%B5%B7%E9%97%B4'

请将 your_appKey 替换为你在万维易源平台申请的 appKey。

五、返回示例

以下是接口返回的JSON示例：

{
  "showapi_res_error": "",
  "showapi_fee_num": 1,
  "showapi_res_code": 0,
  "showapi_res_id": "64dad8de0de376f261fc27d6",
  "showapi_res_body": {
    "result_list": [],
    "scale": 8,
    "cause": "",
    "status": "waiting",
    "scheduler": "K_EULER",
    "remark": "",
    "seed": -1,
    "width": 512,
    "task_id": "sk202308152ztQbbihuHFYHlHPSthrK",
    "batch_size": 1,
    "steps": 25,
    "negetive_prompt": "",
    "lora_scale": "0.9",
    "ret_code": 0,
    "height": 768,
    "call_back": "",
    "prompt": "((beautiful face)), extremely delicate facial,(best quality),(extremely detailed cg 8k wallpaper), masterpiecel,asian,an extremely delicate and beautiful, extremely detailed,intricate,solo,ear ring,tender shining,amazing scene lighting,medium hair,wet hair(collared shirt),standing,(upper body),arms behind back,light smile,necklace,greenhouse"
  }
}

六、获取 appKey

要获取 appKey，请访问万维易源的控制台页面：
查看 appKey

七、总结

万维易源的“创建绘画”API为艺术家、设计师和开发者提供了一个高效、便捷的工具，能够快速生成高质量的绘画作品。通过简单的接口调用和参数设置，用户可以轻松实现个性化的绘画创作，无论是个人创作还是商业应用，都能从中受益。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。