GPT88 API 配置与首次生成
创建 API Key、选择服务端点、加载模型并验证第一次图片生成。
先选择你的使用方式
这篇教程对应 GPT88 OpenTu 工作台。先准备 GPT88 API Key，再在 OpenTu 的“供应商”设置中添加服务、加载模型，最后回到画布完成一次生成。
如果供应商和模型已经配置好，可直接从AI 生成图片开始。GPT88 另有图片工作台指南，适合了解模板化的图片生产流程。
创建并保管 API Key
- 登录 GPT88 控制台，进入 API Key 管理页面。
- 创建一个便于识别用途的 Key；若界面提供分组选择，确认该分组开放了你需要的模型。
- 复制 Key 到工具的凭证输入框，检查首尾是否粘贴了空格。
- 在大模型广场或控制台确认当前模型权限、计费单位与可用性。
Key 是账户凭证。不要放进公开截图、分享项目、笔记、群聊或代码。怀疑泄露时，在控制台停用该 Key 后重新创建。
在 OpenTu 设置中新增供应商
打开 GPT88 OpenTu 工作台，从左上角菜单进入“设置”，切换到“供应商”标签，点击“新增供应商”。当前页面会依次显示基础配置、图片接口格式、API 地址、API Key 和模型列表等字段：
| 字段 | 填写方式 |
|---|---|
| 名称 | GPT88，或能区分用途的自定义名称 |
| API Key | 刚创建的 GPT88 Key |
| 接口类型 | OpenAI 兼容；只有使用 Gemini 原生请求或自定义协议时才选择其他类型 |
| 图片接口格式 | 使用 OpenAI 图片格式时选“OpenAI GPT Image”；无法确认时先用“自动” |
| API 地址 | OpenTu 图片模型使用 https://img.gpt88.cc；接入标准文本 API 时使用 https://api.gpt88.cc/v1 |
| 模型价格 URL | 可留空；不要把旧供应商的价格地址带入 GPT88 配置 |
| 模型 | 当前账号已开放、且客户端支持的模型 ID |
保存前确认供应商分组已选中、启用状态打开，并检查图片接口格式和 API 地址是一套协议。OpenTu 的图片供应商可先用“OpenAI GPT Image”格式与 https://img.gpt88.cc，再从账号可用模型里选择 gpt-image-2 等图片模型；不要把旧供应商的默认地址、价格 URL 或模型名复制到 GPT88 配置。详见统一服务端点、图片 API与视频 API。
加载和添加模型
- 保存供应商配置；若有启用开关，确认已开启。
- 在供应商详情中点击“获取模型”，等待模型列表返回。
- 搜索目标模型，先勾选少量实际需要的模型，再确认添加。
- 返回生成界面，重新选择供应商、分组和模型。
列表为空时，依次确认地址、Key 是否有效、模型权限与网络状态。能够加载模型只说明发现接口可用，还需要一次实际生成验证客户端是否支持该模型协议。
完成第一次生成
输入简单提示词，例如“白色背景上的绿色玻璃杯，柔和侧光，产品摄影”，先选择普通尺寸并提交一次任务。查看任务状态，等待结果后预览并下载图片。
完成标准：模型能被选择、任务有明确状态、结果能够正常打开。成功后再增加参考图、高清尺寸或批量任务，便于定位配置问题。
排查配置问题
| 现象 | 下一步 |
|---|---|
| 401 / 403 | 检查 Key 是否停用、权限或分组是否匹配；不要反复混用新旧凭证 |
| 模型可见但生成失败 | 对照模型的接口协议、请求字段和支持尺寸，检查余额与错误信息 |
| 生成界面找不到模型 | 确认执行了添加操作，供应商已启用，再刷新模型选择器 |
| 长时间没有结果 | 查看任务队列，记录任务 ID，再按排障指南处理 |
如果模型发现成功而 OpenTu 生成失败，可按快速开始单独验证 API，再核对 OpenTu 的接口类型、图片接口格式和当前模型是否匹配。