客户看到的示例是什么意思？
示例中的 AI 没有在旧版公开文档里找到生图接口、模型 ID 和请求示例，因此拒绝直接发起一个可能扣费的生成请求。它遇到的 401 只表示鉴权未通过，不能据此断定“密钥没有图像权限”。
POST /v1/images/generations。不要把 Kili 等上游密钥直接交给客户。1. 创建生图专用令牌
登录控制台，打开「令牌管理」，点击创建令牌。
令牌分组选择「生图专用分组」，不要选择普通文本分组。
复制以 sk- 开头的令牌，仅保存在自己的设备中。
LINGHANG_API_KEY。2. 调用代码生成器
选择清晰度和画幅后，模型名与单张价格会自动更新。此页面只生成示例代码，不会上传提示词、读取令牌或发起付费请求。
3. 模型 ID 与价格
模型命名规则为 gpt-image-清晰度-画幅。例如：gpt-image-2k-16x9 表示 2K 横屏图。
| 清晰度 | 模型格式 | 单张价格 | 适用场景 |
|---|---|---|---|
| 1K | gpt-image-1k-画幅 | $0.03 | 预览图、社交媒体配图、快速试稿 |
| 2K | gpt-image-2k-画幅 | $0.06 | 宣传配图、商品图、桌面壁纸 |
| 4K | gpt-image-4k-画幅 | $0.10 | 高精细海报、大图输出、后期处理 |
4. 返回结果与保存图片
常见返回结果会在 data[0].url 中提供图片地址：
{
"created": 1784300000,
"data": [
{ "url": "https://example.com/generated-image.png" }
]
}
如果上游返回 b64_json，它表示 Base64 图片数据，需要在客户端解码保存。建议优先使用示例中的 response_format: "url"。
5. 在 Codex 中调用生图
生图模型不能作为 Codex 的主对话模型直接出现在模型选择器里，因为它使用的是 Images API，而 Codex 对话使用 Responses/聊天协议。
Codex 仍然可以运行上面的 PowerShell、Python 或 Node.js 代码并保存生成结果。推荐先在系统环境变量中设置令牌：
$env:LINGHANG_API_KEY = "sk-你的生图专用令牌"
随后可以直接告诉 Codex：
使用环境变量 LINGHANG_API_KEY，调用 https://api.tianjinlinghang.com/v1/images/generations 模型使用 gpt-image-2k-16x9，生成一张现代科技产品宣传图， 把返回图片下载到桌面，不要在终端输出令牌。
gpt-image-* 当作代码对话模型。6. 常见报错排查
401 Unauthorized
检查是否使用本站令牌、请求头是否写成 Authorization: Bearer sk-...，以及令牌是否被禁用。401 不是“图像权限不足”的专用提示。
no available channel / model not found
核对模型 ID 是否完全正确，并确认生图上游已经开放。模型不要写成 Image2-4k，应写成类似 gpt-image-4k-16x9。
404 Not Found
通常是地址重复拼接了 /v1。完整请求地址只能是 https://api.tianjinlinghang.com/v1/images/generations。
请求等待时间较长
高分辨率生成可能需要较长时间。客户端超时建议设置为 180 秒以上，不要在生成过程中连续重复提交。
已经扣费但没有拿到图片
保留请求时间、模型 ID 和使用日志中的请求信息，联系售后核对。请勿在截图中暴露完整令牌。