https://wellapi.cc 特价渠道对应的大模型、请求参数、请求示例、返回值结构和返回值示例,方便其他系统直接接入。| 模型 | 调用模型名称 | 接口 地址 |
|---|---|---|
| nano banana pro | gemini-3-pro-image-preview | https://wellapi.cc/v1beta/models/gemini-3-pro-image-preview:generateContent |
| nano banana 2 | gemini-3.1-flash-image-preview | https://wellapi.cc/v1beta/models/gemini-3.1-flash-image-preview:generateContent |
注意:两个渠道都走 Gemini 风格的同步 generateContent接口,返回结果中图片以 URL 形式直接出现在parts[].text字段中,而非 base64 数据。
key={API_KEY}Authorization: Bearer {API_KEY}{
"contents": [
{
"role": "user",
"parts": [
{
"text": "图片生成提示词"
},
{
"inline_data": {
"mime_type": "image/png",
"data": "参考图 base64,不包含 data:image/png;base64, 前缀"
}
}
]
}
],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
}| 字段 | 类型 | 是否必填 | 说明 | 示例 |
|---|---|---|---|---|
contents | array | 是 | 对话内容数组。当前项目固定传 1 个 user 内容。 | 见上方 JSON |
contents[].role | string | 是 | 角色,固定为 user。 | user |
contents[].parts | array | 是 | 内容片段数组,至少包含一个文本提示词。可追加参考图。 | 见上方 JSON |
parts[].text | string | 是 | 生成图片的文本提示词。 | 一只橘猫坐在赛博朋克城市霓虹灯下,电影感 |
parts[].inline_data | object | 否 | 参考图。文生图可不传;图生图/参考图生成时传。 | { "mime_type": "image/png", "data": "..." } |
inline_data.mime_type | string | 传参考图时必填 | 参考图 MIME 类型。 | image/png、image/jpeg |
inline_data.data | string | 传参考图时必填 | 参考图 base64 字符串,不要带 data:image/...;base64, 前缀。 | iVBORw0KGgo... |
generationConfig.responseModalities | array | 是 | 返回模态。当前项目对这两个模型传 IMAGE。 | ["IMAGE"] |
generationConfig.imageConfig.aspectRatio | string | 是 | 图片比例。 | 1:1、16:9、9:16、4:3、3:4 |
generationConfig.imageConfig.imageSize | string | 是 | 图片清晰度/尺寸档位。 | 1K、2K、4K |
1:12:33:23:44:34:55:49:1616:921:9Auto,当前项目后端/前端会按 1:1 处理。1K2K4Knano banana 2 还有 512 档位,nano banana pro 仅支持 1K/2K/4K。| 项 | 值 |
|---|---|
| 模型名称 | gemini-3-pro-image-preview |
| Base URL | https://wellapi.cc |
| Path | /v1beta/models/gemini-3-pro-image-preview:generateContent |
| 完整接口 | https://wellapi.cc/v1beta/models/gemini-3-pro-image-preview:generateContent |
| 项 | 值 |
|---|---|
| 模型名称 | gemini-3.1-flash-image-preview |
| Base URL | https://wellapi.cc |
| Path | /v1beta/models/gemini-3.1-flash-image-preview:generateContent |
| 完整接口 | https://wellapi.cc/v1beta/models/gemini-3.1-flash-image-preview:generateContent |
⚠️ 重要:两个模型的实际返回结构与标准 Gemini inline_data结构不同。图片 URL 直接以纯文本形式出现在candidates[0].content.parts[0].text字段中,而非 base64 或source.url嵌套结构。接入方须以此为准进行解析。
abd.wellapi.xin 域名),有效期有限,请及时下载或转存。{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "https://abd.wellapi.xin/api/generations/3cfb9eeb-b1af-4376-970d-5e1a7c224744/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwdXJwb3NlIjoib3BlbmFwaS1nZW5lcmF0aW9uLWltYWdlIiwiZ2VuZXJhdGlvbklkIjoiM2NmYjllZWItYjFhZi00Mzc2LTk3MGQtNWUxYTdjMjI0NzQ0IiwiYWN0b3JJZCI6ImNtcTdtc2llajA2NHh6NDl4a3ZhcGZla20iLCJhY3RvclR5cGUiOiJhcGlLZXkiLCJpYXQiOjE3ODI4MzM5MzUsImV4cCI6MTc4Mjg0MTEzNX0.XWFfq9rUase1NFVqW27wshxNKuA5WjfbzH6oRuUINO4"
}
]
},
"finishReason": "STOP",
"index": 0
}
],
"modelVersion": "Nano_Banana_Pro",
"usageMetadata": {
"promptTokenCount": 96,
"candidatesTokenCount": 1548,
"totalTokenCount": 1644
}
}file1.aitohumanize.com 域名),可直接访问。{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "https://file1.aitohumanize.com/file/52032f4491534bbca42ebef18ddd1ae5.png"
}
]
},
"finishReason": "STOP",
"index": 0
}
],
"modelVersion": "gemini-3.1-flash-image-preview",
"usageMetadata": {
"promptTokenCount": 16,
"candidatesTokenCount": 11145,
"totalTokenCount": 11161
}
}| 字段 | 类型 | 说明 |
|---|---|---|
candidates | array | 候选结果数组,通常取第一个(index: 0)。 |
candidates[0].content.role | string | 固定为 model。 |
candidates[0].content.parts | array | 模型返回的内容片段数组。 |
candidates[0].content.parts[0].text | string | 图片 URL,直接为可访问的 HTTP(S) 地址。 |
candidates[0].finishReason | string | 生成结束原因,成功时为 STOP。 |
candidates[0].index | number | 候选结果索引,固定为 0。 |
modelVersion | string | 实际调用的模型版本标识。pro 渠道返回 Nano_Banana_Pro,flash 渠道返回 gemini-3.1-flash-image-preview。 |
usageMetadata.promptTokenCount | number | 输入 token 数。 |
usageMetadata.candidatesTokenCount | number | 输出 token 数(图片计费单位)。 |
usageMetadata.totalTokenCount | number | 总 token 数。 |
| 模型 | 图片 URL 域名 | URL 类型 | 注意事项 |
|---|---|---|---|
gemini-3-pro-image-preview | abd.lingting.xin | 带 JWT token 的临时鉴权链接 | 有过期时间, 需在有效期内下载或转存,不可长期引用 |
gemini-3.1-flash-image-preview | file1.aitohumanize.com | 公开 CDN 静态链接 | 可直接访问,稳定性依赖上游 CDN |
1. 解析 JSON 根对象。
2. 取 candidates[0].content.parts[0].text。
3. 判断该字段值是否以 http:// 或 https:// 开头。
- 是 → 即为图片 URL,直接使用或转存。
- 否 → 记录完整返回体,上报异常。
4. 对 gemini-3-pro-image-preview 返回的 URL,建议立即下载/转存,
避免 JWT token 过期后无法访问。{
"error": {
"code": 400,
"message": "Invalid request body",
"status": "INVALID_ARGUMENT"
}
}{
"error": {
"code": 401,
"message": "API key not valid",
"status": "UNAUTHENTICATED"
}
}| 状态码 | 含义 | 建议处理 |
|---|---|---|
400 | 请求体格式错误或参数不支持 | 检查 JSON 结构、aspectRatio、imageSize、base64 是否正确。 |
401 / 403 | API Key 错误或无权限 | 检查 key 和 Authorization。 |
429 | 请求过多或额度限制 | 做退避重试,或降低并发。 |
500 / 502 / 503 | 上游服务异常 | 做短暂重试,仍失败则提示用户稍后再试。 |
| 超时 | 生成耗时过长或参考图过大 | 减少参考图数量/大小,降低 imageSize,增大客户端超时时间。 |
data:image/png;base64, 前缀,只传纯 base64 字符串。imageSize=4K 生成时间通常明显更长,客户端需要设置更长超时时间。gemini-3-pro-image-preview 返回的图片 URL 携带 JWT token,存在过期时间,务必在获取后立即下载或转存到自有存储,不可将该 URL 直接持久化或长期展示。gemini-3.1-flash-image-preview 返回的是公开 CDN 链接,可直接使用,但稳定性依赖上游,生产环境建议同样转存。