可灵-图像生成模型支持文生图、参考图生图两种任务。
本文档仅适用于“中国内地(北京)”地域,且必须使用该地域的API Key。
模型概览
模型名称 | 能力支持 | 输入模态 | 输出图像规格 |
kling/kling-v3-image-generation |
| 文本、图像 | 图像分辨率:1k、2k 宽高比:16:9、9:16、1:1 图像张数:通过参数n指定(1~9) 图像格式:png |
kling/kling-v3-omni-image-generation |
| 文本、图像 | 图像分辨率:1k、2k、4k 宽高比:16:9、9:16、1:1 图像张数:
图像格式:png |
前提条件
开通服务:前往阿里云百炼控制台,搜索“可灵”,找到可灵AI 模型卡片,单击立即开通,在弹窗内确认开通及授权。
配置API Key:选择地域并获取API Key,再配置API Key到环境变量。
HTTP调用
图像生成任务有一定耗时(通常为1-2分钟),API采用异步调用。整个流程包含 "创建任务 -> 轮询获取" 两个核心步骤,具体如下:
步骤一:提交图像生成任务
北京地域:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation
请求参数 | 文生图支持模型: 图生图(组图模式)支持模型: 支持以下模式:
|
请求头(Headers) | |
Content-Type 请求内容类型。此参数必须设置为 | |
Authorization 请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值:Bearer sk-xxxx。 | |
X-DashScope-Async 异步处理配置参数。HTTP请求只支持异步,必须设置为 重要 缺少此请求头将报错:“current user api does not support synchronous calls”。 | |
请求体(Request Body) | |
model 模型名称。可选值:
| |
input 输入参数对象,包含以下字段: parameters 控制图像生成,比如图像张数、宽高比等。 |
响应参数 | 成功响应请保存 task_id,用于查询任务状态与结果。 异常响应创建任务失败,请参见错误信息进行解决。 |
output 任务输出信息。 | |
request_id 请求唯一标识。可用于请求明细溯源和问题排查。 | |
code 请求失败的错误码。请求成功时不会返回此参数,详情请参见错误信息。 | |
message 请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误信息。 |
步骤二:查询任务结果
北京地域:GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
请求参数 | 查询任务结果将 |
请求头(Headers) | |
Authorization 请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值:Bearer sk-xxxx。 | |
URL路径参数(Path parameters) | |
task_id 任务ID。 |
响应参数 | 任务执行成功任务执行异常如果因为某种原因导致任务执行失败,将返回相关信息,可以通过code和message字段明确指示错误原因。请参见错误信息进行解决。 |
output 任务输出信息。 | |
usage 输出信息统计。只对成功的结果计数。 | |
request_id 请求唯一标识。可用于请求明细溯源和问题排查。 | |
code 请求失败的错误码。请求成功时不会返回此参数,详情请参见错误信息。 | |
message 请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误信息。 |
错误码
如果模型调用失败并返回报错信息,请参见错误信息进行解决。