4o Image API 快速开始
几分钟内开始使用 4o Image API 生成高质量的AI图像
欢迎使用 4o Image API
身份验证
API 基础 URL
https://api.kie.ai身份验证请求头
快速开始指南
第一步：生成您的第一个图像
Node.js
Python
cURL
第二步：检查任务状态
Node.js
Python
cURL
响应格式
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_4o_abc123"
}
}{
"code": 200,
"msg": "success",
"data": {
"taskId": "d231a99a9a9f1dd8f895be1b97be8065",
"paramJson": "{\"callBackUrl\":\"playground\",\"enableFallback\":true}",
"completeTime": null,
"response": null,
"successFlag": 0,
"status": "GENERATING",
"errorCode": null,
"errorMessage": null,
"createTime": 1755572609000,
"progress": "0.48"
}
}{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_4o_abc123",
"status": "SUCCESS",
"response": {
"result_urls": [
"https://example.com/generated-image.png"
]
},
"successFlag": 1,
"progress": "1.00",
"completeTime": 1755572669000,
"createTime": 1755572609000,
"errorCode": null,
"errorMessage": null
}
}{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_4o_abc123",
"status": "GENERATE_FAILED",
"response": null,
"successFlag": 2,
"progress": "0.00",
"completeTime": 1755572669000,
"createTime": 1755572609000,
"errorCode": 400,
"errorMessage": "图像内容违反了内容政策，请修改提示词后重试"
}
}核心功能
文本转图像
{
"prompt": "一只可爱的橙色小猫坐在彩虹上，卡通风格，明亮的色彩",
"size": "1:1",
"nVariants": 2,
"isEnhance": false
}图像编辑
{
"filesUrl": ["https://example.com/original-image.jpg"],
"maskUrl": "https://example.com/mask-image.png",
"prompt": "将天空替换成星空夜景",
"size": "3:2"
}图像变体
{
"filesUrl": ["https://example.com/base-image.jpg"],
"prompt": "保持主要元素，改变为水彩画风格",
"size": "2:3",
"nVariants": 4
}图像尺寸支持
关键参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
prompt | string | 是 | 图像生成的文本描述 |
size | string | 是 | 图像尺寸比例："1:1"、"3:2" 或 "2:3" |
filesUrl | array | 否 | 输入图像URL列表，最多支持5张图片 |
maskUrl | string | 否 | 蒙版图像URL，用于指定需要编辑的区域 |
nVariants | integer | 否 | 生成图像的变体数量（1、2 或 4） |
isEnhance | boolean | 否 | 提示词增强选项（默认：false） |
enableFallback | boolean | 否 | 启用托底机制（默认：false） |
提示词技巧
完整工作流程示例
JavaScript
Python
高级功能
蒙版编辑
托底机制
使用回调
任务状态说明
| 状态 | 描述 |
|---|---|
GENERATING | 任务正在处理中，请等待 |
SUCCESS | 图像生成任务成功完成，可获取生成的图像 |
CREATE_TASK_FAILED | 任务创建失败，请检查参数或联系技术支持 |
GENERATE_FAILED | 图像生成过程失败，可能由于内容违规、资源不足等原因 |
响应字段说明
| 参数 | 类型 | 描述 |
|---|---|---|
successFlag | integer | 成功标志：0（生成中）、1（成功）、2（失败） |
progress | string | 生成进度，范围从 "0.00" 到 "1.00" |
createTime | integer | 任务创建时间戳（毫秒） |
completeTime | integer | 任务完成时间戳（毫秒），未完成时为 null |
最佳实践
图像存储和下载
下一步
支持
需要帮助吗