本文档描述了如何使用代码来实现与 Web 上相同的结果。 之后文档将只给出相对地址 API,您需要将其拼凑到主域名: https://api.aitubo.ai.
例如,如果要创建作业,您需要调用 https://api.aitubo.ai/api/job/create
该文档分为两部分,第一部分是示例,第二部分是特定 API。
本节描述了如何创建作业和获取作业。 我们的用于创建作业的 API 提供了三个核心功能: Text2Image, Image2Image, and ControlNet(ControlNet 是一个神经网络结构,通过添加额外条件来控制扩散模型)。
无论您使用哪三个功能,首先您都必须获取我们支持的模型列表,然后在创建作业时,您需要传入 id 模型信息的字段
curl --request GET \
--url 'https://api.aitubo.ai/api/model/list?type=platform' \
--header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848'
结果是这样的:
{
"code": 0,
"data": {
"domain": "https://file.aitubo.ai/",
"total": 10,
"models": [
{
"id": "6426f9c60ca4651b98b91a6d",
"name": "ConceptCanvas",
"username": "Aitubo",
"desc": "A model that creates concept scenes with a European thick paint or CG style.",
"cover": "assets/model/6426f9c60ca4651b98b91a6d/cover.jpg",
"isFavourite": false,
"controlNet": false
},
{
"id": "642b977d2f2842537c09fe41",
"name": "DreamShaper",
"username": "Aitubo",
"desc": "A model that can generate multiple styles of scenes, characters, and game assets.",
"cover": "assets/model/642b977d2f2842537c09fe41/cover.jpg",
"isFavourite": false,
"controlNet": true
},
...
]
}
}
curl --request POST \
--url https://api.aitubo.ai/api/job/create \
--header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
--header 'content-type: application/json' \
--data '{
"prompt": "A cat sleeps on the plane",
"modelId": "642b977d2f2842537c09fe41"
}
然后,您将获得这样的响应:
{
"code": 0,
"data": {
"consumedCredit": 40,
"credit": 120,
"id": "64351e4d567bcd86773dc841"
}
}
您可以通过轮询来检查任务创建的状态。 每张照片大约需要 2 秒钟才能完成,因此请控制您的查询频率。 最后,您将得到这样的结果:
{
"code": 0,
"data": {
"id": "64351e4d567bcd86773dc841",
"args": {
"prompt": "A cat sleeps on the plane",
"negativePrompt": "lowres, bad anatomy, cropped, worst quality, low quality",
"strength": 0.8,
"width": 512,
"height": 512,
"count": 4,
"steps": 30,
"modelId": "642b977d2f2842537c09fe41"
},
"result": {
"info": "Warning: some images may contain NSFW content",
"data": {
"images": [
"images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf00080001g.png",
"images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf000800020.png",
"images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf00080002g.png",
"images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf000800030.png"
],
"artIds": [
"64351e56567bcd86773dc842",
"64351e56567bcd86773dc843",
"64351e56567bcd86773dc844",
"64351e56567bcd86773dc845"
],
"domain": "https://file.aitubo.ai/"
}
},
"status": 2,
"createAt": "2023-04-11T08:46:05.55Z"
}
}
要使用 Image2Image,您可以调用我们的 上传图片 API 获取图片的 OSS 相对地址,或者您可以提供带有绝对地址的图片。
curl --request POST \
--url https://api.aitubo.ai/api/job/create \
--header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
--header 'content-type: application/json' \
--data '{
"imagePath": "images/tmp/cgqi1jntuq4000800040.png",
"modelId": "642b977d2f2842537c09fe41",
"prompt": "scene",
"guidanceScale": 0.7
}'
您可以像 Text2Image 一样通过轮询来检查任务创建的状态。
在使用 ControlNet 功能之前,您必须首先调用 /job/model/list API 来获取相应的 ControlNet 类别:
{
"code": 0,
"data": {
"domain": "https://file.aitubo.ai/",
"models": [
{
"id": "canny",
"name": "canny",
"icon": "assets/template/control_canny.jpg"
},
{
"id": "scribble",
"name": "scribble",
"icon": "assets/template/control_scribble.jpg"
},
...
}
}
然后调用 /job/create API:
curl --request POST \
--url https://api.aitubo.ai/api/job/create \
--header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
--header 'content-type: application/json' \
--data '{ "imagePath": "https://ichef.bbci.co.uk/news/976/cpsprodpb/17638/production/_124800859_gettyimages-817514614.jpg.webp",
"controlModel": "canny",
"prompt": "a little dog"
}'
您也可以传递 modelId 字段(确保该模型支持 ControlNet):
curl --request POST \
--url https://api.aitubo.ai/api/job/create \
--header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
--header 'content-type: application/json' \
--data '{
"imagePath": "https://ichef.bbci.co.uk/news/976/cpsprodpb/17638/production/_124800859_gettyimages-817514614.jpg.webp",
"controlModel": "canny",
"prompt": "a little dog",
"modelId": "642b977d2f2842537c09fe41"
}'
路径: /api/job/upload-image
方法: POST
标头
名称 | 值 | 必需 | 示例 |
---|---|---|---|
Content-Type | multipart/form-data | 是 | |
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
正文
名称 | 值 | 必需 |
---|---|---|
image | 文件 | 是 |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | integer | 是 | code=0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 否 | |||
├─path | string | 否 | 阿里云 OSS 的图片路径 |
路径: /api/job/create
方法: POST
标头
名称 | 值 | 必需 | 示例 |
---|---|---|---|
Content-Type | application/json | 是 | |
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
正文
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
imagePath | string | 否 | 上传图片的路径(url/oss 均可) | ||
maskImage | string | 否 | AI 编辑器应该传递此字段 | ||
modelId | string | 否 | 如果 controlModel 为 null,则应填写此字段 | ||
prompt | string | 是 | 提示 | ||
negativePrompt | string | 否 | 负面提示 | ||
controlModel | string | 否 | canny / scribble / openpose / mlsd / hed / seg / depth / normal | ||
controlStrength | number | 否 | 1 | [0, 2] | |
controlFilter | string | 否 | control 图像的预处理器,例如:openpose / openpose_full / openpose_hand / openpose_face / openpose_faceonly | ||
strength | number | 否 | 0.8 | [0.1, 1] | |
width | integer | 否 | 512 | ||
height | integer | 否 | 512 | ||
steps | integer | 否 | 30 | 10 <= value <= 50 | |
guidanceScale | integer | 否 | 7.5 | 0 < value <= 20 | |
count | integer | 否 | 4 | 生成的图片数量 |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功;1000 -> 积分不足 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─id | string | 是 | 作业 ID | ||
├─credit | integer | 是 | 用户的总积分 | ||
├─consumedCredit | integer | 是 | 作业消耗的积分 |
路径: /api/job/get
方法: GET
查询
名称 | 必需 | 示例 | 注意 |
---|---|---|---|
id | 是 | 642ba091592245d79a645b39 | 作业 ID |
名称 | Type | 必需 | Default | 注意 | Others |
---|---|---|---|---|---|
code | integer | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─id | string | 是 | 作业 ID | ||
├─createAt | string | 是 | 作业的创建时间 | ||
├─status | integer | 是 | 作业的状态。 0 -> 未准备好; 1 -> 处理中; 2 -> 成功; 3 -> 失败 | ||
├─result | object | 否 | |||
├─├─info | string | 否 | |||
├─├─data | object | 否 | |||
├─├─├─images | string [] | 否 | 图像的最终相对路径(需要与域字段连接) | item Type:string | |
├─├─├─artIds | string [] | 否 | 图片对应的 artID | item Type:string | |
├─├─├─domain | string | 否 | oss url,您需要连接图片的相对路径 | ||
├─args | object | 否 | |||
├─├─prompt | string | 否 | |||
├─├─negativePrompt | string | 否 | |||
├─├─model | string | 否 | |||
├─├─strength | integer | 否 | |||
├─├─width | integer | 否 | |||
├─├─height | integer | 否 |
路径: /api/job/models
方法: GET
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | integer | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├domain | string | 是 | 图片 oss 域名,需要连接下面的图标字段 | ||
├models | object [] | 是 | item Type:object | ||
id | string | 是 | 模型 ID,创建作业时 controlModel 参数值为此 ID | ||
name | string | 是 | 英文名称 | ||
cname | string | 是 | 中文名称 | ||
icon | string | 是 | 示例图片。 oss 相对路径,您需要连接域 |
路径: /api/job/list
方法: GET
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
Query
名称 | 必需 | 示例 | 注意 |
---|---|---|---|
pageIndex | 是 | 从 1 开始 | |
pageSize | 是 |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | integer | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─jobs | object [] | 是 | 作业数组 | item Type:object | |
├─├─id | string | 是 | 作业 ID | ||
├─├─createdAt | string | 是 | |||
├─├─args | object | 是 | |||
├─├─├─prompt | string | 是 | |||
├─├─├─negativePrompt | string | 是 | |||
├─├─├─strength | integer | 是 | |||
├─├─├─width | integer | 是 | |||
├─├─├─height | integer | 是 | |||
├─├─├─count | integer | 是 | |||
├─├─├─steps | integer | 是 | |||
├─├─arts | object [] | 是 | 生成的图像数组 | item Type:object | |
├─├─├─id | string | 是 | 生成的图像的 ID | ||
├─├─├─images | object [] | 是 | 多样化图片数组 | item Type:object | |
├─├─├─├─spec | string | 是 | 变体类型。 o -> 原始; 2x/3x/4x -> 2/3/4 比例图像 | ||
├─├─├─├─path | string | 是 | 图片路径。 要连接的域 | ||
├─├─├─├─size | integer | 是 | 图片大小。 单位:字节 | ||
├─domain | string | 是 | oss 图片域 |
路径: /api/model/list
方法: GET
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
查询
名称 | 必需 | 示例 | 注意 |
---|---|---|---|
pageIndex | 是 | 从 1 开始 | |
pageSize | 是 | ||
type | 否 | platform/community |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | integer | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─domain | string | 是 | oss 域 | ||
├─total | integer | 是 | 分页过滤的模型总数 | ||
├─models | object [] | 是 | item Type:object | ||
├─├─id | string | 是 | 模型 ID | ||
├─├─name | string | 是 | 模型名称 | ||
├─├─username | string | 是 | model’s author name | ||
├─├─desc | string | 是 | 模型描述 | ||
├─├─cover | string | 是 | 模型封面 | ||
├─├─isFavourite | boolean | 是 | 用户是否收藏该模型 | ||
├─├─controlNet | boolean | 是 | 模型是否支持 ControlNet |
路径: /api/job/upscale
方法: POST
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
正文
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
model | string | 否 | 放大模型名称 | ||
RealESRGAN _x4plus / RealESRGAN_x4plus_anime_6B | |||||
imagePath | string | 是 | 图片路径。 要连接的域 | ||
upscaleFactor | integer | 是 | 2 <= factor <= 4 | ||
beauty | boolean | 否 | 是否启用面部增强 | ||
artId | string | 是 | 需要一个超级点图片 artID |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功;1000 -> 积分不足 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─id | string | 否 | 放大作业 ID | ||
├─credit | integer | 是 | 用户的总积分 | ||
├─consumedCredit | integer | 是 | 作业消耗的积分 |
路径: /api/art/segment
方法: POST
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
正文
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
image | string | 是 | 图片路径。 绝对/相对路径 |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─image | string | 是 | 分割后图片的 URL |
路径: /api/user/profile
方法: GET
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─name | string | 是 | |||
string | 是 | ||||
├─avatar | string | 是 | |||
├─phone | string | 是 | |||
├─credit | integer | 是 | 用户的总积分 | ||
├─displayNSFW | boolean | 是 | |||
├─discord | boolean | 是 |
路径: api/transform/list
方法: GET
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─domain | string | 是 | 图片 oss 域名,需要连接下面的图标字段 | ||
├─tags | string[] | 是 | 模板标签 | ||
├─transform | object | 是 | |||
├─├─tag | object[] | 是 | |||
├─├─├─id | string | 是 | |||
├─├─├─name | string | 是 | |||
├─├─├─image | string | 是 | 原始图像 | ||
├─├─├─art | string | 是 | 结果图像 | ||
├─├─├─cost | number | 是 | 积分消耗 | ||
├─├─├─pro | boolean | 是 | 是专业版 | ||
├─├─├─tag | string | 是 | 标签 |
路径: api/transform/create-headshot
方法: POST
标头
名称 | 值 | 必需 | 示例 | 注意 |
---|---|---|---|---|
Content-Type | application/json | 是 | ||
Authorization | Bearer {YOUR KEY} | 是 | Bearer 37f333a2d5f811edb248acde48001122 |
正文
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
imagePath | string | 是 | 调用时返回的图片路径 上传图片 api | ||
transformId | string | 是 | |||
width | integer | 否 | |||
height | integer | 否 | |||
keepHair | boolean | 否 | false | ||
keepPose | boolean | 否 | true |
名称 | 类型 | 必需 | 默认 | 注意 | 其他 |
---|---|---|---|---|---|
code | number | 是 | 0 -> 成功;1000 -> 积分不足 | ||
info | string | 否 | 错误信息 | ||
data | object | 是 | |||
├─id | string | 是 | 作业 ID | ||
├─credit | integer | 是 | 用户的总积分 | ||
├─consumedCredit | integer | 是 | 作业消耗的积分 |