AI绘画-AI图生图
专用API
【更新时间: 2024.03.07】
基于扩散模型实现图到图的生成，保持用户输入图内容的同时产生具有目标风格属性的图像，支持萌漫、次元漫画、新海城等多种风格
|
相似API
- API详情
- 接口文档
- 定价
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是AI图生图的AI绘画?
服务详情
基于扩散模型实现图到图的生成，保持用户输入图内容的同时产生具有目标风格属性的图像，支持萌漫、次元漫画、新海城等多种风格。
应用场景
核心优势
接入前准备
1.在快手开放平台完成入驻和应用创建，得到分配的app_id 和app_secret；已完成小程序入驻的开发者无需重新申请，可直接复用相关字段。
2.接入快手授权服务；
3.如需使用请先联系商务同学（E-mail：haozhiliu@kuaishou.com）免费获取1000次额度，有效期3个月。超过免费额度后可联系商务进行购买续费。
什么是AI图生图的AI绘画？
由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用AI图生图的AI绘画，从而实现程序的自动化交互，提高服务效率。
产品价格
需使用请先联系商务同学（E-mail：haozhiliu@kuaishou.com）免费获取1000次额度，有效期3个月。超过免费额度后可联系商务进行购买续费
计费模式一：后付费-按调用量计费（计费周期：月，月累计调用量达到对应档位后享受对应折扣）
| 价格档位 | 调用量梯度（次） | 单价（元/次） |
|---|---|---|
| 档位一 | 【5W<调用次数<=10W】 | 0.1 |
| 档位二 | 【10W<调用次数<=100W】 | 0.08 |
| 档位三 | 【100W<调用次数<=500W】 | 0.06 |
| 档位四 | 【500W<调用次数<=1000W】 | 0.05 |
| 档位五 | 【调用次数>1000W】 | 0.04 |
计费模式二：预付费-按购买资源包计费
| 价格档位 | 资源包（调用次数） | 价格（元） | 单价（元/次） |
|---|---|---|---|
| 档位一 | 10W | 8000 | 0.08 |
| 档位二 | 100W | 60000 | 0.06 |
| 档位三 | 500W | 250000 | 0.05 |
| 档位四 | 1000W | 400000 | 0.04 |
产品问答
?
在使用快手内容开放能力的视频流程中，上传视频的那一步已经返回成功了，为什么在发布视频时会返回错误VI...
上传接口只保证文件的上传是成功的，但是并不会对上传后的视频做校验。因此很可能因为上传姿势的不对，导致上传的视频有损坏。这样在发布视频时，视频会转码失败，返回这个错误码。请再次检查前一步的上传姿势是否正确。
?
在使用快手的直播开放能力的流程中，确认已经请求用户授权直播相关的scope了，但是调用open ap...
这个错误码的含义是用户还未开通直播权限，这里的权限不是指对第三方应用授予的权限，而是本人在快手上进行直播的权限。需要引导用户去快手上按步骤开通直播，之后再次调用open api就可以正常开播了。
关于我们
北京快手科技有限公司
企业
北京快手科技有限公司是一家领先的短视频社交平台，致力于为用户提供丰富、多元的内容。公司成立于2011年，总部位于中国北京。快手通过先进的技术，为用户打造了一个互动性强、参与度高的社区环境。用户可以在这里分享生活点滴、展示才艺，享受社交乐趣。快手不断推动技术创新，优化用户体验，已成为中国乃至全球短视频行业的领军企业。
联系信息
API接口列表
提交任务
1.1 简要描述
AI绘画-AI图生图提交任务
1.2 请求URL
/openapi/queue/effects/submit/aiPainting?app_id=xxx&access_token=xxx
1.3 请求方式
POST
1.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| openId | string | 是 | openId | |
| input | list | 是 | 输入素材，图片/视频等 | |
| input[].name | string | 否 | 素材名称 | |
| input[].dataUrl | string | 否 | dataUrl和dataBytes二选一 | |
| input[].dataBytes | string | 否 | Base64字符串，如何从图片的二进制获得base64字符串：org.apache.commons.codec.binary.Base64.encodeBase64String(bytes.toByteArray()) | |
| effect | string | 是 | 能力名称，具体支持列表参见 | |
| argument | map | 否 | 额外参数，参见具体方法说明 |
1.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| result | int | 错误码，0为成功，其它失败，参见返回错误码说明 | |
| errorMsg | string | 错误信息 | |
| requestId | string | 请求id，可用于查询任务 | |
| taskInfo | object | ||
| taskStatus | string | 排队中、运行中、已完成、已取消、已失败 | |
| etaTime | long | 预计完成时间戳 | |
| queueSize | int | 队列位置 | |
| beginTime | long | 开始时间戳 | |
| endTime | long | 完成时间戳 | |
| taskPercent | string | 进度百分比0-100 | |
| data | object | ||
| data.image | string | 图片Base64字符串，例如"data:image/png;base64,/9j/4AA" | |
| data.type | string | image：图片 | |
| data.video | string | 视频Base64字符串 |
1.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| SUCCESS0 | 成功 | |
| UNRECOGNIZED-1 | 未识别 | |
| NO_RESULTS1 | 没有结果 | |
| NO_FACE2 | 没有人脸 | |
| NO_HUMAN3 | 没有人 | |
| SIZE_MISMATCH4 | 输入图片大小/通道不匹配 | |
| RUN_ERROR5 | 运行错误 | |
| PARAM_ERROR6 | 无效输入参数 | |
| NO_BANDWIDTH12 | 无带宽 | |
| OUT_OF_QUOTA20 | 特效被限流 | |
| ERR_CV201 | cv异常（输入图片错误） | |
| ERR_STD202 | std异常 | |
| ERR_OTHER203 | 其他错误 |
1.7 示例
{
"result": 0,
"errorMsg": "",
"requestId":"请求id", // 查询任务所需字段
"effect":"",
"taskInfo":{
"taskStatus":"", //排队中、运行中、已完成、已取消、已失败
"etaTime":"", // 预计完成时间
"queueSize":0, // 队列位置
"beginTime":"时间戳",
"endTime":"实际完成时间",
"taskPercent":"1" // 进度百分比0-100
},
"data": {
"image":"data:image/png;base64,/9j/4AA",
"video":"",
"type":"image" // video / image
}
}
查询任务
2.1 简要描述
AI绘画-AI图生图查询任务
2.2 请求URL
/openapi/queue/effects/query?app_id=xxx&access_token=xxx
2.3 请求方式
POST
2.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| openId | string | 是 | openId | |
| requestId | string | 是 | 提交任务返回的requestId |
2.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| result | int | 错误码，0为成功，其它失败，参见返回错误码说明 | |
| errorMsg | string | 错误信息 | |
| requestId | string | 请求id，可用于查询任务 | |
| taskInfo | object | ||
| taskStatus | string | 排队中、运行中、已完成、已取消、已失败 | |
| etaTime | long | 预计完成时间戳 | |
| queueSize | int | 队列位置 | |
| beginTime | long | 开始时间戳 | |
| endTime | long | 完成时间戳 | |
| taskPercent | string | 进度百分比0-100 | |
| data | object | ||
| data.image | string | 图片Base64字符串，例如"data:image/png;base64,/9j/4AA" | |
| data.type | string | image：图片 | |
| data.video | string | 视频Base64字符串 |
2.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| SUCCESS0 | 成功 | |
| UNRECOGNIZED-1 | 未识别 | |
| NO_RESULTS1 | 没有结果 | |
| NO_FACE2 | 没有人脸 | |
| NO_HUMAN3 | 没有人 | |
| SIZE_MISMATCH4 | 输入图片大小/通道不匹配 | |
| RUN_ERROR5 | 运行错误 | |
| PARAM_ERROR6 | 无效输入参数 | |
| NO_BANDWIDTH12 | 无带宽 | |
| OUT_OF_QUOTA20 | 特效被限流 | |
| ERR_CV201 | cv异常（输入图片错误） | |
| ERR_STD202 | std异常 | |
| ERR_OTHER203 | 其他错误 |
2.7 示例
{
"result": 0,
"errorMsg": "",
"requestId":"请求id", // 查询任务所需字段
"effect":"",
"taskInfo":{
"taskStatus":"", //排队中、运行中、已完成、已取消、已失败
"etaTime":"", // 预计完成时间
"queueSize":0, // 队列位置
"beginTime":"时间戳",
"endTime":"实际完成时间",
"taskPercent":"1" // 进度百分比0-100
},
"data": {
"image":"data:image/png;base64,/9j/4AA",
"video":"",
"type":"image" // video / image
}
}
取消任务
3.1 简要描述
AI绘画-AI图生图取消任务
3.2 请求URL
/openapi/queue/effects/cancel?app_id=xxx&access_token=xxx
3.3 请求方式
POST
3.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| openId | string | 是 | openId | |
| requestId | string | 是 | 提交任务返回的requestId |
3.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| result | int | 错误码，0为成功，其它失败，参见返回错误码说明 | |
| errorMsg | string | 错误信息 | |
| requestId | string | 请求id，可用于查询任务 | |
| taskInfo | object | ||
| taskStatus | string | 排队中、运行中、已完成、已取消、已失败 | |
| etaTime | long | 预计完成时间戳 | |
| queueSize | int | 队列位置 | |
| beginTime | long | 开始时间戳 | |
| endTime | long | 完成时间戳 | |
| taskPercent | string | 进度百分比0-100 | |
| data | object | ||
| data.image | string | 图片Base64字符串，例如"data:image/png;base64,/9j/4AA" | |
| data.type | string | image：图片 | |
| data.video | string | 视频Base64字符串 |
3.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| SUCCESS0 | 成功 | |
| UNRECOGNIZED-1 | 未识别 | |
| NO_RESULTS1 | 没有结果 | |
| NO_FACE2 | 没有人脸 | |
| NO_HUMAN3 | 没有人 | |
| SIZE_MISMATCH4 | 输入图片大小/通道不匹配 | |
| RUN_ERROR5 | 运行错误 | |
| PARAM_ERROR6 | 无效输入参数 | |
| NO_BANDWIDTH12 | 无带宽 | |
| OUT_OF_QUOTA20 | 特效被限流 | |
| ERR_CV201 | cv异常（输入图片错误） | |
| ERR_STD202 | std异常 | |
| ERR_OTHER203 | 其他错误 |
3.7 示例
{
"result": 0,
"errorMsg": "",
"requestId":"请求id", // 查询任务所需字段
"effect":"",
"taskInfo":{
"taskStatus":"", //排队中、运行中、已完成、已取消、已失败
"etaTime":"", // 预计完成时间
"queueSize":0, // 队列位置
"beginTime":"时间戳",
"endTime":"实际完成时间",
"taskPercent":"1" // 进度百分比0-100
},
"data": {
"image":"data:image/png;base64,/9j/4AA",
"video":"",
"type":"image" // video / image
}
}
查询任务列表
4.1 简要描述
AI绘画-AI图生图查询任务列表
4.2 请求URL
/openapi/queue/effects/list?app_id=xxx&access_token=xxx
4.3 请求方式
POST
4.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| openId | string | 是 | openId | |
| pageNum | int | 否 | 页码，从1开始 | |
| pageSize | int | 否 | 一页数量，最大值:100 | |
| effect | string | 否 | 特效名称 | |
| task_status | string | 否 | 排队中、已完成、已取消、已失败 |
4.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| result | int | 错误码，0为成功，其它失败，参见返回错误码说明 | |
| errorMsg | string | 错误信息 | |
| totalSize | int | 总数量 | |
| dataList | list | ||
| requesstring,tId | string | 请求id，可用于查询任务 | |
| taskInfo | object | 任务排队等信息 | |
| taskStatus | string | 排队中、运行中、已完成、已取消、已失败 | |
| etaTime | long | 预计完成时间戳 | |
| queueSize | int | 队列位置 | |
| beginTime | long | 开始时间戳 | |
| endTime | long | 完成时间戳 | |
| taskPercent | string | 进度百分比0-100 |
4.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| SUCCESS0 | 成功 | |
| UNRECOGNIZED-1 | 未识别 | |
| NO_RESULTS1 | 没有结果 | |
| NO_FACE2 | 没有人脸 | |
| NO_HUMAN3 | 没有人 | |
| SIZE_MISMATCH4 | 输入图片大小/通道不匹配 | |
| RUN_ERROR5 | 运行错误 | |
| PARAM_ERROR6 | 无效输入参数 | |
| NO_BANDWIDTH12 | 无带宽 | |
| OUT_OF_QUOTA20 | 特效被限流 | |
| ERR_CV201 | cv异常（输入图片错误） | |
| ERR_STD202 | std异常 | |
| ERR_OTHER203 | 其他错误 |
4.7 示例
{
"result": 0,
"errorMsg": "",
"dataList":[
{
"requestId":"请求id",
"effect":"",
"taskInfo":{
"taskStatus":"",
"etaTime":"", // 预计完成时间
"queueSize":0, // 队列位置
"beginTime":"时间戳",
"endTime":"实际完成时间",
"taskPercent":"1" // 进度百分比0-100
}
}
]
}
effect参数
5.1 简要描述
支持的AI绘画能力列表
5.2 请求URL
/openapi/queue/effects/submit/aiPainting?app_id=xxx&access_token=xxx
5.3 请求方式
POST
5.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| openId | string | 是 | openId | |
| input | list | 是 | 输入素材，图片/视频等 | |
| input[].name | string | 否 | 素材名称 | |
| input[].dataUrl | string | 否 | dataUrl和dataBytes二选一 | |
| input[].dataBytes | string | 否 | Base64字符串，如何从图片的二进制获得base64字符串：org.apache.commons.codec.binary.Base64.encodeBase64String(bytes.toByteArray()) | |
| effect(仅AI绘画需要) | string | 是 | 能力名称，具体支持列表参见 | |
| argument | map | 否 | 额外参数，参见具体方法说明 |
5.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|
5.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| SUCCESS0 | 成功 | |
| UNRECOGNIZED-1 | 未识别 | |
| NO_RESULTS1 | 没有结果 | |
| NO_FACE2 | 没有人脸 | |
| NO_HUMAN3 | 没有人 | |
| SIZE_MISMATCH4 | 输入图片大小/通道不匹配 | |
| RUN_ERROR5 | 运行错误 | |
| PARAM_ERROR6 | 无效输入参数 | |
| NO_BANDWIDTH12 | 无带宽 | |
| OUT_OF_QUOTA20 | 特效被限流 | |
| ERR_CV201 | cv异常（输入图片错误） | |
| ERR_STD202 | std异常 | |
| ERR_OTHER203 | 其他错误 |
5.7 示例
产品价格
需使用请先联系商务同学（E-mail：haozhiliu@kuaishou.com）免费获取1000次额度，有效期3个月。超过免费额度后可联系商务进行购买续费
计费模式一：后付费-按调用量计费（计费周期：月，月累计调用量达到对应档位后享受对应折扣）
| 价格档位 | 调用量梯度（次） | 单价（元/次） |
|---|---|---|
| 档位一 | 【5W<调用次数<=10W】 | 0.1 |
| 档位二 | 【10W<调用次数<=100W】 | 0.08 |
| 档位三 | 【100W<调用次数<=500W】 | 0.06 |
| 档位四 | 【500W<调用次数<=1000W】 | 0.05 |
| 档位五 | 【调用次数>1000W】 | 0.04 |
计费模式二：预付费-按购买资源包计费
| 价格档位 | 资源包（调用次数） | 价格（元） | 单价（元/次） |
|---|---|---|---|
| 档位一 | 10W | 8000 | 0.08 |
| 档位二 | 100W | 60000 | 0.06 |
| 档位三 | 500W | 250000 | 0.05 |
| 档位四 | 1000W | 400000 | 0.04 |
依赖服务
产品问答
?
在使用快手内容开放能力的视频流程中，上传视频的那一步已经返回成功了，为什么在发布视频时会返回错误VI...
上传接口只保证文件的上传是成功的，但是并不会对上传后的视频做校验。因此很可能因为上传姿势的不对，导致上传的视频有损坏。这样在发布视频时，视频会转码失败，返回这个错误码。请再次检查前一步的上传姿势是否正确。
?
在使用快手的直播开放能力的流程中，确认已经请求用户授权直播相关的scope了，但是调用open ap...
这个错误码的含义是用户还未开通直播权限，这里的权限不是指对第三方应用授予的权限，而是本人在快手上进行直播的权限。需要引导用户去快手上按步骤开通直播，之后再次调用open api就可以正常开播了。
关于我们
北京快手科技有限公司
企业
北京快手科技有限公司是一家领先的短视频社交平台，致力于为用户提供丰富、多元的内容。公司成立于2011年，总部位于中国北京。快手通过先进的技术，为用户打造了一个互动性强、参与度高的社区环境。用户可以在这里分享生活点滴、展示才艺，享受社交乐趣。快手不断推动技术创新，优化用户体验，已成为中国乃至全球短视频行业的领军企业。
联系信息
