Taylent AITaylent AI
返回文档
教程 · 图像生成

GPT-Image-2 接入指南

用 Taylent 调用 gpt-image-2 生成图像，并把它无痛集成到 Codex 的 imagegen Skill。

先看清楚：API Key 分组不同

聊天对话和文生图走的是不同接口、用的是不同分组的 API Key。在 Taylent 控制台创建 Key 时记得选对：

用途令牌分组端点
文生图default/v1/images/generations
聊天对话gpt / gpt-pro/v1/responses 或 /v1/chat/completions

1. 直接 API 调用

图片生成可能要等几十秒到几分钟，调用方耐心等待即可。

curl · 文生图调用
curl https://api.taylent.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${apikey}" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着护目镜的橘猫工程师，坐在机械键盘前写代码，漫画插画风格",
    "size": "1024x1024"
  }'

响应示例：

response.json
{
  "created": 1776889447,
  "data": [
    {
      "b64_json": "<图片 Base64>",
      "revised_prompt": "漫画插画风格，一只戴着护目镜的橘猫工程师……"
    }
  ],
  "background": "opaque",
  "output_format": "png",
  "quality": "medium",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 81,
    "input_tokens_details": { "image_tokens": 0, "text_tokens": 81 },
    "output_tokens": 1756,
    "output_tokens_details": { "image_tokens": 1756, "text_tokens": 0 },
    "total_tokens": 1837
  }
}

2. 在 Codex 里调用

Codex 直接对话走的是 /v1/chat/completions / /v1/responses，不会自动调用图片生成接口。Codex 自带的 imagegen Skill 才会做这件事：

imagegen Skill 路径
~/.codex/skills/.system/imagegen/SKILL.md

触发方式：

Codex 提示词
$imagegen 漫画插画风格，一只戴着护目镜的橘猫工程师，坐在机械键盘前认真写代码……

imagegen 会用 Python 脚本去调上面那条 curl 接口。但实际跑起来你大概率会撞上下面三个坑。

坑一：缺少 OPENAI_API_KEY

Codex 默认会跟你说：

当前环境缺少 OPENAI_API_KEY, 现在还不能实际生成图片.

因为聊天和文生图分开走，Codex 默认不知道你的图片 Key 在哪。 MacOS 用户在 ~/.zshrc 末尾加两行：

~/.zshrc
# 文生图专属环境变量（Key 用 default 分组的那个）
export OPENAI_BASE_URL="https://api.taylent.com/v1"
export OPENAI_API_KEY="sk-tay-..."

已有的 ~/.codex/config.toml 和 ~/.codex/auth.json 管的是普通对话，跟图片生成是两件事，不冲突也别误删。

坑二：模型自动降级到 gpt-image-1

不指定模型时，Codex 会逐级降级尝试： gpt-image-1.5 → gpt-image-1 → gpt-image-1-mini。 想用 gpt-image-2 必须在提示词里说清楚：

带模型限定的提示词
$imagegen 使用 gpt-image-2 模型, 生成漫画插画风格，一只戴着护目镜的橘猫工程师……

坑三：Codex 等不及，提前 abort

图片生成可能耗时几分钟。Codex 有时候摆烂直接结束任务 — 但接口大多按次扣费，提前结束也算钱。在提示词里强制要求等待：

完整提示词模板
$imagegen 生成漫画插画风格，一只戴着护目镜的橘猫工程师……
 
要求 1. 使用 gpt-image-2 模型
要求 2. 必须等待接口请求返回后才能结束任务，不允许私自提前结束。

完成后图片会落到工作目录的 ./output/imagegen/ 下。

常见问题

请求超过 120s 后仍然超时

Taylent 边缘节点由 Cloudflare 提供，Cloudflare 默认超时是 120s。如果你确认是上游慢导致的 524，请发邮件到 info@taylent.com，我们安排专属高时长通道。

需要帮助？

邮件 info@taylent.com，工单 5 分钟内响应。

回到文档