4o Image API 快速开始

几分钟内开始使用 4o Image API 生成高质量的AI图像

欢迎使用 4o Image API

4o Image API 基于强大的 GPT-4o 模型，为您提供高质量的AI图像生成服务。无论是文本转图像、图像编辑还是图像变体生成，我们的API都能满足您的创作需求。

文本转图像

从文本描述生成高质量图像

图像编辑

使用蒙版和提示词编辑现有图像

图像变体

基于输入图像生成多个创意变体

任务管理

跟踪和监控您的图像生成任务

身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面获取您的 API 密钥。

请妥善保管您的 API 密钥，切勿公开分享。如果怀疑密钥泄露，请立即重置。

API 基础 URL

https://api.kie.ai

身份验证请求头

快速开始指南

第一步：生成您的第一个图像

从一个简单的文本转图像生成请求开始：

Node.js

Python

cURL

第二步：检查任务状态

使用返回的任务ID检查生成状态：

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
}

图像尺寸支持

支持三种标准图像比例：

1:1

方形

适合社交媒体帖子、头像、产品展示

3:2

横向

适合风景照片、桌面壁纸、展示横幅

2:3

纵向

适合人物肖像、手机壁纸、海报设计

关键参数

参数	类型	必需	描述
`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

高级功能

蒙版编辑

使用蒙版进行精确的图像编辑：

蒙版图像中的黑色区域将被编辑，白色区域保持不变。蒙版必须与原图尺寸一致。

托底机制

启用托底机制确保服务可靠性：

使用回调

设置webhook回调以获得自动通知：

了解更多关于回调

设置webhook回调以在图像准备就绪时接收自动通知。

任务状态说明

状态	描述
`GENERATING`	任务正在处理中，请等待
`SUCCESS`	图像生成任务成功完成，可获取生成的图像
`CREATE_TASK_FAILED`	任务创建失败，请检查参数或联系技术支持
`GENERATE_FAILED`	图像生成过程失败，可能由于内容违规、资源不足等原因

响应字段说明

参数	类型	描述
`successFlag`	integer	成功标志：0（生成中）、1（成功）、2（失败）
`progress`	string	生成进度，范围从 "0.00" 到 "1.00"
`createTime`	integer	任务创建时间戳（毫秒）
`completeTime`	integer	任务完成时间戳（毫秒），未完成时为 null

最佳实践

提示词优化

图像质量

性能优化

错误处理

图像存储和下载

生成的图像存储 14天 后自动删除。下载URL有效期为 20分钟。

图像URL在生成后14天内保持可访问

使用下载URL API解决跨域下载问题

下载URL有效期为20分钟

建议及时下载并本地存储重要图像

下一步

生成图像

图像生成的完整API参考

任务详情

查询和监控任务状态

下载URL

获取直接下载URL

回调设置

设置自动通知回调

支持

需要帮助吗

我们的技术支持团队随时为您提供帮助。

邮箱: support@kie.ai

文档: docs.kie.ai

API状态: 查看我们的状态页面了解实时API健康状况

4o Image API 快速开始

欢迎使用 4o Image API#

身份验证#

API 基础 URL#

身份验证请求头#

快速开始指南#

第一步：生成您的第一个图像#

第二步：检查任务状态#

响应格式#

核心功能#

文本转图像#

图像编辑#

图像变体#

图像尺寸支持#

关键参数#

提示词技巧#

完整工作流程示例#

高级功能#

蒙版编辑#

托底机制#

使用回调#

任务状态说明#

响应字段说明#

最佳实践#

图像存储和下载#

下一步#

支持#

欢迎使用 4o Image API

身份验证

API 基础 URL

身份验证请求头

快速开始指南

第一步：生成您的第一个图像

第二步：检查任务状态

响应格式

核心功能

文本转图像

图像编辑

图像变体

图像尺寸支持

关键参数

提示词技巧

完整工作流程示例

高级功能

蒙版编辑

托底机制

使用回调

任务状态说明

响应字段说明

最佳实践

图像存储和下载

下一步

支持