图像生成 API 文档

接口描述

https://artcreator.cn/generate_image 是一个 POST 请求接口，用于生成图像并返回图像的 URL。该接口接受 JSON 格式的请求数据，根据提供的参数生成图像，并进行相应的密钥验证和余额检查。如果图像生成成功且密钥正确、余额充足，将返回生成图像的 URL；否则，返回相应的错误信息。

请求方法

POST

请求参数

参数名称	类型	是否必填	描述
prompt	string	是	图像生成的提示词。
style_preset	string	是	图像的风格预设。
upscale	boolean	是	是否进行图像的 upscale 处理。
model	string	是	要使用的图像生成模型。
negative_prompt	string	是	图像生成的负面提示词。
steps	integer	是	图像生成的步数。
cfg_scale	integer	是	配置缩放参数。
seed	integer	是	随机种子，若为 -1 则随机生成。
sampler	string	是	采样器名称。
width	integer	是	生成图像的宽度。
height	integer	是	生成图像的高度。
my_key	string	是	用于身份验证的密钥。

响应

成功生成图像:

状态码：200

响应内容：

{
    "image_url": "生成图像的 URL"
}

密钥错误:

状态码：403

响应内容：

{
    "error": "密钥错误，无法继续"
}

余额不足:

状态码：422

响应内容：

{
    "error": "身份通过但余额不足，无法继续"
}

服务端结算异常:

状态码：501

响应内容：

{
    "error": "服务端结算异常,中止服务"
}

图像生成失败:

状态码：500

响应内容：

{
    "error": "图像生成失败"
}

注意事项

确保提供的参数符合要求，尤其是必填参数不能缺失。
密钥验证和余额检查是生成图像的前提条件，如果不满足将无法生成图像,注册登录后将自动生成密钥。
图像生成过程可能会受到多种因素影响，如网络问题、API 服务不稳定等，可能导致图像生成失败或响应延迟。