生图 Key 接入教程

把 Key 发给 AI，它帮你配好，以后直接说「帮我生一张……」就行，不用自己写代码。

不想碰 Key？

用网页版生图站，登录就能画，见 生图站使用教程。

第一步：拿到你的 Key

登录 Portdan，顶部菜单点「令牌」，点「添加令牌」新建一个。Key 只显示一次，立刻复制保存，关掉弹窗就看不到了。

第二步：把 Key 发给 AI，一句话配好

打开你常用的 AI 工具（Codex、Claude 都行），把下面这段完整复制，把 sk-你的key 换成真实的 Key 后发过去：

这是我的 API Key：sk-你的key
请求地址：https://portdan.com
帮我把它们配置成长期使用的环境变量，配置好后调用 /v1/images/generations 帮我生图测试一下。

AI 会自动配好，配完直接出一张测试图。只配这一次，以后不用再配。

Key 是私密信息

Key 只发给你信任的 AI 工具，不要发到群聊或截图分享。Key 泄露立刻到「令牌」页删掉再建一个。

第三步：直接说提示词出图

配好之后，直接说：

帮我生一张图：一只橘猫坐在窗台上看雨，写实摄影风，2K。

或者：

生图：赛博朋克城市夜景，霓虹灯倒映在水坑里，高质量。

提示词里可以说尺寸和出图质量。先确认所选模型和线路支持这些档位，再让 AI 设置参数：

你说的	实际发送的参数
1K / 小图 / 快速	size 约 1024×1024
2K / 中等	size 约 2048×2048
4K / 高清	size 约 3840×2160
低质量 / 快	quality=low
中等	quality=medium
高质量 / 细腻	quality=high

---

可用模型

你能用哪些模型和档位，取决于令牌分组与模型线路。同一个模型名，换条线路，支持的尺寸也可能不同。

线路	可用尺寸	怎么选
快速生图	约 1K	固定档位，不能靠传 2K/4K 参数升级
标准生图	1K / 2K	只选页面开放的档位
高清生图	以页面列出的 1K / 2K / 4K 为准	质量与尺寸都要看该线路开放范围

“低、中、高”指发送给模型的出图质量参数，不是推理强度，也不等于 1K、2K、4K。实际画质取决于上游服务。

不知道自己能用哪些模型？

让 AI 用这个 Key 读取 /v1/models，从返回列表中选择完整模型名。生图站的模型选择器可以查看当前开放的线路；页面展示名不一定是 API 模型名。

---

让 AI 帮你批量生图

一次说多张也行：

用刚才确认可用的生图模型和档位，帮我生 3 张图：
1. 清晨的咖啡馆，温暖光线，胶片感
2. 海边落日，剪影构图
3. 雪山脚下的小木屋，夜晚，窗里透出暖光

---

常见问题

配完之后 AI 说「找不到模型」怎么办？ 让 AI 用同一个 Key 重新读取 /v1/models，使用列表里的完整模型名重试，不要直接照抄线路展示名。

生了图但扣费不对？不要把“实际出图更小”理解成一定会少扣费。 有些快速线路会忽略尺寸参数，仍可能按请求的高档位计费。用生图站时以页面开放的选项和预估费用为准；直接用 Key 时也要核对对应线路的能力，遇到不符请保留用量记录联系支持。

Key 用量怎么查？ 登录 Portdan 主站，顶部「用量」页可以看每一次的扣费明细。

图生图（参考图）怎么用？ 直接说：

用这张图作为参考，画一只类似风格的猫：[粘贴图片]

或者上传图片后说「以这张图为参考生图」。

换了台电脑，还要重新配吗？ 环境变量是配在当前这台电脑（或当前这个 AI 会话）里的。换电脑或换工具，把第二步的那段话再发一遍即可。

---

遇到问题？去 联系我们 找技术支持，或直接在 QQ 群里问。