API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. 可灵API（官方接口）
API reference
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • 系统内部接口
    • 用户查询账号信息
    • 查询Key信息
  • OpenAI
    • 聊天
      • 文本聊天
      • 识图
    • Responses
      • 创建模型响应
      • 获得模型响应
      • 删除模型响应
      • 取消模型响应
    • OpenAI-Realtime
      • Realtime
    • Completions
      • Instruct
    • 音频接口（Audio）
      • 音频转文本
      • 创建翻译
      • 文本转音频
    • 图像
      • 创建图像
      • 创建图像编辑
      • 创建图像变化
    • 嵌入
      • 创建嵌入
    • 审核
      • 创建审核
    • 模型
      • 获取模型列表
    • 帮助中心
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
  • Suno（音乐）
    • 场景一：续写音乐并获取完整音乐
    • 场景二：Cover 音乐:音乐翻版\修改风格
    • 场景三：Replace Section:替换片段
    • 场景四：Persona:歌手风格
    • 场景五：stems:声曲分离(仅限chirp_auk)
    • 场景六：Timing:歌词、音频时间线(仅限chirp_auk)
    • 场景七：wav:获取 wav 格式文件
    • 场景八：mp4:生成 mp4 mv 视频(仅限chirp_auk)
    • 场景九：all-stems:全轨声曲分离
    • 场景十：高价参数
    • 生成音乐
    • 上传音乐
    • 歌曲拼接
    • 新建 Persona
    • 声曲分离
    • Timing:歌词、音频时间线
    • 获取 wav 格式文件
    • 生成 mp4 mv 视频
    • 生成歌词
    • 查询单个任务
    • 批量查询任务
    • 批量查询歌曲
  • Udio（音乐）
    • 官方格式
      • 生成音乐
      • 查询单个任务
  • Midjourney API文档（生图）
    • 快速教学-完整流程一遍过
    • 怎么切换不同的速度
    • 任务提交
      • 提交Imagine任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Modal
      • 提交Describe任务
      • 提交编辑任务
      • 提交视频任务
      • 上传文件到discord
    • 任务查询
      • 指定ID获取任务
      • 根据ID列表查询任务
      • 根据ID列表查询任务-字段displays
      • 获取任务图片的seed
      • 查询所有任务
      • 分页查询任务
      • 查询任务队列
      • 取消任务
  • Flux（生图）
    • 官方格式
      • 生成图片
      • 微调
      • 查询任务
    • OpenAI Dalle3格式
  • Recraft（生图）
    • 官方格式
      • 附录
      • Generate Image（生成图片）
      • Vectorize Image（矢量化图片）
      • Remove Background（删除背景）
      • Clarity Upscale（清晰度提升）
      • Generative Upscale（生成高清）
      • Create style（创建样式）
    • OpenAI Dalle3格式-生成图片
  • Ideogram（生图）
    • 支持使用OpenAI /v1/images/generations
    • 官方文档（实时更新）
    • Generate with Ideogram 3.0
    • Edit with Ideogram 3.0
    • Remix with Ideogram 3.0
    • Reframe with Ideogram 3.0
    • Replace Background with Ideogram 3.0
    • Upscale
    • Describe
    • Generate(legacy)
    • Edit(legacy)
    • Remix(legacy)
  • Luma（视频）
    • 官方API格式接口
      • 生成视频
      • 单个查询任务
    • RixAPI格式接口
      • 任务提交
        • 文生视频
        • 图生视频
        • 扩展视频
        • 视频生成音频
        • 获取视频无水印链接
      • 任务查询
        • 单个查询任务
        • 批量查询任务
  • Runway（视频）
    • 官方API接口格式
      • 从图像生成视频
      • 获取任务详细信息
    • 逆向格式
      • generate(文本)
      • generate(参考图片)
      • video2video 视频转视频 风格重绘
      • Act-one 表情迁移
      • feed-获取任务
  • PIKA（视频）
    • generate(文本)
    • generate(参考图片)
    • generate(参考视频/扩展视频)
    • feed
  • 可灵API（官方接口）
    • 建议直接看官方文档
    • Callback协议
    • 生成图像
      POST
    • 扩图
      POST
    • 文生视频
      POST
    • 图生视频
      POST
    • 多图参考生视频
      POST
    • 视频特效
      POST
    • 视频延长
      POST
    • 对口型
      POST
    • 虚拟试穿
      POST
    • 查询任务（单个）
      GET
  • Replicate 通用接口
    • 创建任务
    • 查询任务
  • MiniMax海螺
    • 官方文档
    • 图片生成
    • 视频生成
    • 查询任务
    • 文件下载
  • 火山方舟
    • 创建视频
    • 查询视频状态
  • Pixverse
    • 生成任务
    • 查询任务
  • Viggle
    • 上传图片模板
    • 上传舞蹈视频模板
    • 创建舞蹈视频任务
    • 获取任务结果
    • 获取官方舞蹈视频TAG
    • 获取官方舞蹈视频TAG下的模板
  1. 可灵API（官方接口）

生成图像

POST
/kling/v1/images/generations
最后修改时间：2025-04-10 07:41:54
本文档不实时更新，完整版请查看官方文档：https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M

请求参数

Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
Header 参数
Authorization
string 
可选
默认值:
{{YOUR_API_KEY}}
Body 参数application/json
model_name
enum<string> 
模型名称
可选
枚举值:
kling-v1kling-v1-5
默认值:
kling-v1
prompt
string 
必需
正向文本提示词，不能超过500个字符
<= 500 字符
negative_prompt
string 
可选
负向文本提示词，不能超过200个字符。注：图生图（即image字段不为空时）场景下，不支持负向提示词
<= 200 字符
image
string 
可选
参考图像。支持Base64编码或URL格式，图片格式支持.jpg/.jpeg/.png，大小不超过10MB，分辨率不小于300*300px，宽高比在1:2.5~2.5:1之间
image_reference
enum<string> 
可选
图片参考类型。subject：角色特征参考，face：人物长相参考。使用face时需仅含1张人脸。仅kling-v1-5支持
枚举值:
subjectface
image_fidelity
number 
可选
生成过程中对用户上传图片的参考强度
>= 0<= 1
默认值:
0.5
human_fidelity
number 
可选
主体参考度，即参考图主体（服装、发型等）相似度
>= 0<= 1
默认值:
0.45
n
integer 
生成图片数量
可选
>= 1<= 9
默认值:
1
aspect_ratio
enum<string> 
可选
生成图片的画面纵横比（宽:高）
枚举值:
16:99:161:14:33:43:22:3
默认值:
16:9
callback_url
string <uri>
可选
任务结果回调通知地址
示例
{
  "model_name": "kling-v1-5",
  "prompt": "在海滩上度假的快乐场景。",
  "image": "iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAABFFBMVEUAAAABFBYFZWoHeoMHd4MFXmsBFhoAeGUC1MYI+fsP+P8P8f8N5v8K1/8Hq9wDXHwAUDEA6KQA/80E990J9e4R9/8K1vkHyPYEsfgBk9sAKy0AkUsA/5YA/aQA+rkG+NEN+egFgvoAP/0AMf8ARv8AGFsBn0YG/3wA/YQF/aoQ/MQInv8AUP8BW/8CYf8AdS8Y+m0g/5wo/rMd5OcCTqMAEEIBJEoDadEAGC8AEwcR/WIs92FU+2xT/XpP/o1U/6ctwqMAABEFhc4Fn/YBFyQlpT5l/1+G+F6Z+2SW/4BUuG8COEcIwvpmpzzP/17c+VyIz3EGmqqkqTz//1nS+oIAACEZrpkATUkAwrbg+nSWzmECZ//nXTRpAAABDklEQVR4AbXQA0+wYRjF8XO9RjaGPGU3Ztv4mtnmEKZsDtk4PUZrXv/pbL+HN74mcW6tp8/wtwK6X35EH1G6+38n/0TpyIXhonYq+B4gApF1B8aJ3HjKqedZpCgGyrKNSYJ7+Ss7Ci0gU86A4FkTc8wvkRGo5Qtk0EQUicbd0KuQ8SvYVVXX1NTCyqMOzuobGptg9TcMbm22d0sr3LW22Lu53m1hAfZuamtwa52HvdtraqqrnMcXjPQu6JWTIDlgYSHBYajlkdR1xsTsUyCI88gg73ntwb/gEkxEx0oCsMKg6X8e/K8o12BjLN9EXm+v8Z+KkIdwIMKodEfyP5Uu4ELA2/qUR8BEu1/U/at7B7OBbYeTZaCnAAAAAElFTkSuQmCC",
  "image_reference": "subject"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/kling/v1/images/generations' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model_name": "kling-v1-5",
  "prompt": "在海滩上度假的快乐场景。",
  "image": "iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAABFFBMVEUAAAABFBYFZWoHeoMHd4MFXmsBFhoAeGUC1MYI+fsP+P8P8f8N5v8K1/8Hq9wDXHwAUDEA6KQA/80E990J9e4R9/8K1vkHyPYEsfgBk9sAKy0AkUsA/5YA/aQA+rkG+NEN+egFgvoAP/0AMf8ARv8AGFsBn0YG/3wA/YQF/aoQ/MQInv8AUP8BW/8CYf8AdS8Y+m0g/5wo/rMd5OcCTqMAEEIBJEoDadEAGC8AEwcR/WIs92FU+2xT/XpP/o1U/6ctwqMAABEFhc4Fn/YBFyQlpT5l/1+G+F6Z+2SW/4BUuG8COEcIwvpmpzzP/17c+VyIz3EGmqqkqTz//1nS+oIAACEZrpkATUkAwrbg+nSWzmECZ//nXTRpAAABDklEQVR4AbXQA0+wYRjF8XO9RjaGPGU3Ztv4mtnmEKZsDtk4PUZrXv/pbL+HN74mcW6tp8/wtwK6X35EH1G6+38n/0TpyIXhonYq+B4gApF1B8aJ3HjKqedZpCgGyrKNSYJ7+Ss7Ci0gU86A4FkTc8wvkRGo5Qtk0EQUicbd0KuQ8SvYVVXX1NTCyqMOzuobGptg9TcMbm22d0sr3LW22Lu53m1hAfZuamtwa52HvdtraqqrnMcXjPQu6JWTIDlgYSHBYajlkdR1xsTsUyCI88gg73ntwb/gEkxEx0oCsMKg6X8e/K8o12BjLN9EXm+v8Z+KkIdwIMKodEfyP5Uu4ELA2/qUR8BEu1/U/at7B7OBbYeTZaCnAAAAAElFTkSuQmCC",
  "image_reference": "subject"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
错误码；具体定义错误码
message
string 
错误信息
必需
request_id
string 
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object 
必需
task_id
string 
任务ID，系统生成
必需
task_status
string 
必需
任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
created_at
integer 
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer 
必需
任务更新时间，Unix时间戳、单位ms
示例
{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}
修改于 2025-04-10 07:41:54
上一页
Callback协议
下一页
扩图
Built with