# 翎航生图：直接交给 Codex 使用

更新日期：2026-10-02

这份文件是给 Codex 读取并执行的操作说明。用户会同时提供一个包含翎航生图专用 API Key 的 TXT 文件，并在对话中说明要生成或修改什么图片。

## Codex 必须遵守

1. 这把密钥只用于翎航生图 API。不要用它替换 CCS、Codex 或当前对话的主模型密钥，不要更改当前对话模型。
2. 生图请求只能使用下列接口：
   - 获取模型：`GET https://api.tianjinlinghang.com/v1/models`
   - 文生图：`POST https://api.tianjinlinghang.com/v1/images/generations`
   - 图生图：`POST https://api.tianjinlinghang.com/v1/images/edits`
3. 不要把图片模型发送到 `/v1/responses` 或 `/v1/chat/completions`，也不要用当前对话模型（例如 `gpt-5.6-luna`）发起生图。
4. 使用客户端的 `--key-file` 从用户提供的 TXT 文件读取密钥。不要输出密钥内容，不要写入源码、Git、聊天消息、命令历史或普通日志。
5. 先执行只读的 `models` 命令，确认密钥和模型列表。用户明确要求生成图片，即视为允许发起一次可能扣费的生图请求；每项任务只提交一次，失败或超时后不要自动重试。
6. 图片保存在用户当前项目的 `images` 文件夹，并把最终绝对路径告诉用户。不得把密钥发送给返回的图片 URL。

## 首次准备

在当前工作目录下载本站客户端：

```powershell
Invoke-WebRequest `
  -Uri 'https://api.tianjinlinghang.com/docs/image/linghang-image-client.py' `
  -OutFile '.\linghang-image-client.py'
python -m pip install requests
```

如果 `python` 不存在，先检查 Windows Python；不要改用 CCS 主模型接口模拟生图。

## 使用 TXT 密钥

用户可能提供任意文件名。先找到用户明确指定的 TXT 文件；若同目录只有一个 TXT，可以使用它。文件应只包含一行完整的 `sk-...` 密钥。下文用 `'.\翎航生图密钥.txt'` 表示该文件。不要执行 `Get-Content` 后回显，也不要把真实密钥拼进命令参数。

## 第一步：只读检查

```powershell
python .\linghang-image-client.py models --key-file '.\翎航生图密钥.txt'
```

当前“生图专用分组”通常可见以下模型，仍以命令实际返回为准：

- `gpt-image-2`
- `gpt-image-2-1k`
- `gpt-image-2-1k-th`
- `gpt-image-2-2k`
- `gpt-image-2-4k`
- `gpt-image-2.5`
- `gpt-image-2.5-flare`
- `gpt-image-2.5-sunburst`

不要自行拼接模型名。若模型不在返回列表中，停止并把错误告诉用户。

## 文生图

推荐默认使用 `gpt-image-2.5`、`1024x1024`。用户指定比例或尺寸时再调整；宽高使用小写 `x`。

```powershell
python .\linghang-image-client.py generate `
  --key-file '.\翎航生图密钥.txt' `
  --model 'gpt-image-2.5' `
  --prompt '把这里替换成用户的完整生图要求' `
  --size '1024x1024' `
  --output-dir '.\images'
```

这条命令会真实生成图片并可能扣费。客户端成功后会输出保存路径。

## 图生图 / 修改参考图

用户提供参考图时使用 `edit`。参考图必须是本机真实的 PNG、JPEG 或 WebP 文件。

```powershell
python .\linghang-image-client.py edit `
  --key-file '.\翎航生图密钥.txt' `
  --model 'gpt-image-2.5' `
  --prompt '保留主体，将背景改为白色摄影棚' `
  --reference '.\reference.png' `
  --size '1024x1024' `
  --output-dir '.\images'
```

多张参考图重复添加 `--reference`：

```powershell
python .\linghang-image-client.py edit `
  --key-file '.\翎航生图密钥.txt' `
  --model 'gpt-image-2.5' `
  --prompt '融合两张参考图的主体和配色' `
  --reference '.\reference-1.png' `
  --reference '.\reference-2.jpg' `
  --size '1536x1024' `
  --output-dir '.\images'
```

最多 9 张；单张不超过 10MB。不要把文件路径放入 JSON，也不要把图生图请求发到 `/v1/responses`。

## 结果与错误处理

- `401`：TXT 中不是完整有效的本站令牌，或令牌已失效。
- `403`：检查余额、令牌分组是否为“生图专用分组”、账户计费偏好和分组权限。
- `400`：模型、尺寸或参考图参数不受支持；重新运行 `models`，不要猜模型名。
- `429`：请求过于频繁。停止，不要自动重试。
- `502/503/524` 或超时：记录时间、模型、HTTP 状态和 Request ID，停止，不要自动再生成，以免重复扣费。
- 报错若提到 `/v1/responses`、`/v1/chat/completions` 或普通对话模型，说明调用方式错误；恢复当前 CCS/Codex 主对话配置，然后按本文件调用独立生图客户端。

执行结束后只向用户报告：是否成功、使用的图片模型、输出文件绝对路径；失败时报告 HTTP 状态和 Request ID。不要展示 API Key 或整段 Base64。

网页教程：https://api.tianjinlinghang.com/docs/image/