image2 API

强大的 AI 图像生成 API

接入 image2 AI 图像生成能力，将创意转化为高质量图像。简单易用，稳定高效，适用于各类应用和平台。

快速集成

稳定可靠

高性价比

数据安全

完整文档

立即获取 API Key 3步快速接入

POST /v1/images/generations

{
  "model": "gpt-image-2",
  "prompt": "一只可爱的猫咪，坐在窗边，阳光洒在它身上",
  "size": "1024x1024",
  "n": 1
}

生成完成

快速集成

简单的 API 接口设计，10 分钟即可完成集成

稳定可靠

99.9% 服务可用性，全球 CDN 加速

高性价比

按量计费，价格透明，没有隐藏费用

数据安全

HTTPS 加密传输，不存储您的敏感数据

完整文档

详细的 API 文档和丰富的示例代码

安装 image2 Skill，让 Agent 直接生成图片

适合反复使用 image2 API 的工作流。安装后，Agent 会优先调用 Skill 内置脚本，而不是每次临时手写 API 请求。

安装 image2 Skill 到你的 Agent 环境。

配置 IMAGE2_API_KEY，让 Skill 能安全读取你的 API Key。

之后直接告诉 Agent “用 image2 生成图片”。

通用安装

适用于支持 skills CLI 的 Agent 环境。

npx skills add ichizi/image2-skills

非交互安装

适合脚本化安装或不想确认交互的环境。

npx skills add ichizi/image2-skills -y

配置 API Key

Skill 只读取环境变量，不会保存你的密钥。

export IMAGE2_API_KEY="your_image2_api_key"

发给你的 Agent（如小龙虾、WorkBuddy）

如果你在使用小龙虾、WorkBuddy 或其他 Agent，直接复制这段话发给它，让它自己完成安装和启用。

请帮我安装并启用 image2 的图片生成 Skill：

https://github.com/ichizi/image2-skills

这是一个根目录包含 SKILL.md 的 Agent Skill。安装后请确认它可以读取 IMAGE2_API_KEY，并在我说“用 image2 生成图片”时调用该 Skill，而不是手写临时 API 请求。

安全建议：安装前可以先查看 GitHub 仓库源码。image2 Skill 不包含私有服务端代码，也不会存储 API Key。

查看 GitHub 仓库

给 AI Agent 使用

一段提示词，让 AI 学会调用 image2 API

复制这段提示词给 Codex、Claude、Cursor 等 AI Agent，它会先读取 llms.txt，再基于真实接口写出可运行的调用代码。

image2 - llms.txt prompt

请先读取 image2 API 的 AI 文档索引：

https://image2.vip/llms.txt

然后基于文档回答我的问题。你需要重点掌握：
1. 如何获取和使用 API Key
2. 如何调用 POST /api/v1/images/generations
3. 请求参数和响应格式
4. 常见错误处理
5. 如何用 cURL / Python / JavaScript 写出可运行示例

我的问题是：如何调用 image2 API 生成一张图片？

接入只需 3 步

获取 API Key

注册账号并获取 API Key

选择接口

选择合适的 API 接口

调用 API

发送请求并获取结果

快速开始

curl -X POST https://image2.vip/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的猫咪，坐在窗边，阳光洒在它身上",
    "size": "1024x1024",
    "n": 1,
    "image": ["https://example.com/reference-image.jpg"]
  }'

响应示例

{
  "created": 1715881600,
  "data": [
    {
      "url": "https://image2.vip/generations/img_abc123.png",
      "revised_prompt": "一只可爱的猫咪，坐在窗边，阳光洒在它身上"
    }
  ]
}

Async Mode

异步模式与任务轮询 (Async & Polling)

对于大批量生成或需要避免连接超时的场景，推荐使用异步模式。在生图请求体中传入 "async": true，接口将秒级返回任务 ID （task_id）。随后，使用查询接口轮询获取生图状态和最终图片。

1. 提交异步生成任务

POST /api/v1/images/generations

curl -X POST https://image2.vip/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的猫咪，坐在窗边，阳光洒在它身上",
    "async": true
  }'

响应示例

{
  "created": 1715881600,
  "task_id": "batch-uuid-example",
  "status": "pending",
  "data": [
    { "url": null, "status": "pending" }
  ]
}

2. 查询任务生成状态

GET /api/v1/images/tasks/batch-uuid-example

curl -X GET https://image2.vip/api/v1/images/tasks/batch-uuid-example \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "created": 1715881600,
  "task_id": "batch-uuid-example",
  "status": "completed",
  "progress": 100,
  "data": [
    {
      "url": "https://image2.vip/generations/img_abc123.png",
      "revised_prompt": "一只可爱的猫咪，坐在窗边，阳光洒在它身上",
      "status": "completed"
    }
  ],
  "error": null
}