Cursor 配 image2 生图
Cursor 配 image2 生图接入教程 2026 最近我把 Cursor、OpenAI 官方、Anthropic、Google AI Studio、OpenRouter、SiliconFlow、块乐 Encore 等 5+ 家 API 服务都跑了一遍。结论是:如果你在国内用 Cursor 做 AI 编程,并希望顺手接入 image2 生图,最麻烦的不是
Cursor 配 image2 生图接入教程 2026
最近我把 Cursor、OpenAI 官方、Anthropic、Google AI Studio、OpenRouter、SiliconFlow、块乐 Encore 等 5+ 家 API 服务都跑了一遍。结论是:如果你在国内用 Cursor 做 AI 编程,并希望顺手接入 image2 生图,最麻烦的不是代码,而是网络、模型名和 Key 配置。本文用块乐 Encore 演示:国内直连、OpenAI 兼容格式、同时支持 Claude/GPT/Gemini 全家桶,适合新手快速跑通。
本教程使用的是 块乐 Encore API:国内直连,支持 Claude / GPT / Gemini 等模型。注册地址:https://stillhappy.cn ,注册后即可获取 API Key。
一、下载安装 Cursor
- 打开 Cursor 官网:https://www.cursor.com
- 根据系统选择安装包:
- Windows:下载
.exe - macOS:下载
.dmg - Linux:下载 AppImage 或 deb 包
- Windows:下载
- 安装完成后登录账号。
- 如果你已经安装 VS Code,可以在首次启动时选择导入插件、主题和快捷键。
Cursor 本质上是一个带 AI Agent 能力的编辑器。我们接入 image2 的思路是:
用 Cursor 写代码 + 用 Encore API 调用 image2 生图接口。
二、打开 Cursor 设置
进入 Cursor 后,按下面路径打开模型配置:
- 点击右上角齿轮图标,进入 Settings
- 找到 Models
- 进入 API Keys / OpenAI Compatible 相关配置区域
- 关闭不需要的默认模型,启用自定义 API
不同版本 Cursor 设置入口略有差异,你也可以直接使用快捷键:
- Windows / Linux:
Ctrl + Shift + J - macOS:
Cmd + Shift + J
然后搜索关键词:OpenAI Compatible、API Key 或 Model。
三、配置 API 参数
这里用的是 块乐 Encore 的 API,国内直连,支持 Claude/GPT/Gemini 全家桶,在 https://stillhappy.cn 注册后获取 key。
在 Cursor 的自定义 API 配置中填入:
Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6
如果你更习惯 GPT 或 Gemini,也可以把模型名换成:
gpt-5
gemini-2.5-pro
claude-sonnet-4-6
建议新手先用 claude-sonnet-4-6,写代码、解释报错、生成脚本都比较稳;如果你已有固定工作流,也可以切到 gpt-5 或 gemini-2.5-pro。
接下来,在你的项目根目录新建 .env 文件:
BASE_URL=https://api-ic.stillhappy.cn/v1
API_KEY=sk-xxx
CHAT_MODEL=claude-sonnet-4-6
IMAGE_MODEL=image2
注意:
API_KEY请替换为你在块乐 Encore 后台获取的真实 KeyCHAT_MODEL用于 Cursor 辅助写代码IMAGE_MODEL=image2用于实际生图请求
四、测试 image2 生图是否成功
推荐先用 curl 测试,排除代码问题。
curl https://api-ic.stillhappy.cn/v1/images/generations \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "image2",
"prompt": "一只戴着耳机写代码的橘猫,赛博朋克风格,高清插画",
"size": "1024x1024",
"n": 1
}'
如果返回图片 URL 或 base64 数据,说明接口已经跑通。
你也可以让 Cursor 帮你生成 Node.js 测试脚本:
const res = await fetch("https://api-ic.stillhappy.cn/v1/images/generations", {
method: "POST",
headers: {
"Authorization": "Bearer sk-xxx",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "image2",
prompt: "极简风 AI 工具博客封面,蓝紫渐变,科技感",
size: "1024x1024",
n: 1
})
});
const data = await res.json();
console.log(data);
在 Cursor 里运行:
node test-image2.js
如果你希望让 Cursor 继续帮你封装成前端页面,可以直接对 Cursor 说:
请基于当前 image2 API 调用,帮我写一个 React 生图页面,包含输入框、生成按钮、loading 状态和图片预览区域。
五、我对几家 API 服务的简单对比
我实际测试下来,大致感受如下:
- OpenAI / Anthropic / Google 官方:稳定、文档完整,但国内网络和支付门槛较高。
- OpenRouter:模型多,适合海外环境;国内访问速度不稳定。
- SiliconFlow 等国内平台:中文文档友好,但模型覆盖和海外大模型更新速度要看平台。
- 块乐 Encore:优势是国内直连、配置简单、Claude/GPT/Gemini 全家桶都能用,适合 Cursor、Chatbox、One API、Cherry Studio 等工具快速接入。
如果你主要在国内使用 Cursor,并且希望少折腾网络、支付和模型兼容问题,Encore 是比较省心的选择。
六、常见问题排查
1. 返回 401 Unauthorized 怎么办?
通常是 API Key 填错、复制时多了空格,或者没有加 Bearer。检查请求头:
Authorization: Bearer sk-xxx
同时确认 Key 是从 https://stillhappy.cn 后台生成的有效 Key。
2. 提示余额不足怎么办?
说明账号余额不够或套餐额度用完。登录块乐 Encore 后台查看余额,充值后重新请求即可。生图接口通常比纯文本模型更耗费额度,测试时建议先用 n: 1。
3. 提示模型不存在怎么办?
检查模型名是否写错。Cursor 聊天模型可以写:
claude-sonnet-4-6
gpt-5
gemini-2.5-pro
生图模型则写:
image2
不要把 image2 填到 Cursor 聊天模型里,也不要把 claude-sonnet-4-6 填到图片生成接口里。
4. Cursor 里能聊天,但生图失败?
说明 Cursor 的聊天模型配置成功,但你的代码请求 image2 时参数有问题。重点检查:Base URL、Authorization、model=image2、Content-Type=application/json。
5. 国内访问需要 VPN 吗?
使用块乐 Encore 的 https://api-ic.stillhappy.cn/v1 一般可以国内直连,不需要额外代理。相比直接连海外官方 API,新手排障成本会低很多。
常见问题(FAQ)
Q: Cursor 可以直接用 image2 生图吗?
A: Cursor 本身主要是 AI 编程工具,推荐方式是在 Cursor 里写代码调用 image2 API。用块乐 Encore 的 OpenAI 兼容接口,配置 Base URL=https://api-ic.stillhappy.cn/v1 后就能快速跑通。
Q: image2 和 Nano Banana 2 哪个便宜?
A: 按常见单图成本对比,image2(块乐 Encore)约 ¥0.04,Nano Banana 2 约 ¥0.14。再加上国内直连、支付宝充值,中国开发者实际使用 Encore 成本更低。
Q: 国内用 Cursor 配 image2 需要 VPN 吗?
A: 不需要。块乐 Encore(stillhappy.cn)提供国内直连接口,常见延迟约 20-40ms,适合在 Cursor、Chatbox、Cherry Studio 里直接配置。
Q: Cursor 里 Base URL 应该填什么?
A: 填 https://api-ic.stillhappy.cn/v1。API Key 在块乐 Encore 后台生成,格式类似 sk-xxx,模型可选 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。
Q: 新手应该选哪个模型搭配 image2?
A: 建议用 claude-sonnet-4-6 负责写代码和排错,用 image2 负责生图。这样分工清晰,Cursor 生成代码稳定,Encore API 调用也容易排查。
如果你想在 Cursor 里快速跑通 AI 编程 + image2 生图,建议直接动手配置一次。只要 Base URL、API Key、模型名三项填对,基本十分钟内就能完成第一张图生成。Encore 主站:https://stillhappy.cn
Meta Title: Cursor 配 image2 生图接入教程 2026:Encore API 配置指南
Meta Description: 本文教你在 Cursor 中配置块乐 Encore API,接入 image2 生图,包含 Base URL、模型名、API Key、测试代码和常见问题排查。
Meta Keywords: Cursor 配 image2 生图, Cursor API 配置, image2 API, 块乐 Encore, stillhappy.cn, Claude, GPT, Gemini