Pop-cam NanoBanana 技能

使用 Pop-cam NanoBanana API 生成图像。该模型支持任意视觉风格——包括写实摄影、电影感、卡通、插画、水彩、3D 渲染，以及您能在提示词中描述的任何其他风格。

本技能支持两种模式：

• 图生图（Image-to-image）：发送一张 base64 编码的图片，以及一段描述如何变换该图的提示词。
• 文生图（Text-to-image）：仅发送 prompt 字段（不包含 image 字段），即可从零开始生成图像。

两种模式每次生成均消耗 1 点积分，且共用同一接口端点。

身份认证

所有生成请求均需在 Authorization 请求头中提供 Pop-cam API Token（以 pk_ 开头）。

若用户尚未拥有 Token，请按以下顺序引导其完成操作：

1. 注册账号：访问 https://www.pop-cam.com/sign-up（如已拥有账号则跳过此步）。
2. 登录账号：访问 https://www.pop-cam.com/sign-in。
3. 创建 API Token：访问 https://www.pop-cam.com/developer，将 Token 命名为 “OpenClaw”。请立即复制该 Token，系统仅显示一次。

请妥善保存该 Token，并在每次请求中携带：

Authorization: Bearer pk_YOUR_TOKEN

若无法确认用户是否已登录，可先调用鉴权状态接口：

curl https://www.pop-cam.com/api/openclaw/auth-status

响应内容将明确告知是否需要登录，并附上对应的操作链接。

技能定义 JSON

如需获取本技能完整机器可读版本（含功能说明、接口地址、数据结构定义、示例等），请调用：

curl https://www.pop-cam.com/api/openclaw/skill

生成接口端点

POST https://www.pop-cam.com/api/v1/nanobanana

请求头（Headers）

请求体（Request Body）

图生图示例

对现有照片进行变换：

curl -X POST https://www.pop-cam.com/api/v1/nanobanana 
  -H "Authorization: Bearer $POPCAM_API_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "image": "data:image/png;base64,iVBOR...",
    "prompt": "Enhance this photo with cinematic lighting and shallow depth of field"
  }'

文生图示例

仅凭文本提示词生成图像，无需源图：

curl -X POST https://www.pop-cam.com/api/v1/nanobanana 
  -H "Authorization: Bearer $POPCAM_API_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "A photorealistic portrait of a man in a leather jacket standing on a city rooftop at golden hour, natural lighting, shallow depth of field"
  }'

同步响应（HTTP 200）

{
  "job_id": "a1b2c3d4-...",
  "image_url": "https://cdn.pop-cam.com/generated/user_id/a1b2c3d4.png",
  "download_url": "https://...r2.cloudflarestorage.com/...?X-Amz-Signature=...",
  "used_prompt": "A photorealistic portrait of a man in a leather jacket standing on a city rooftop at golden hour, natural lighting, shallow depth of field",
  "credits_remaining": 22,
  "mode": "text-to-image"
}

重要提示：请使用 download_url 下载生成的图像。该 URL 为预签名链接，有效期 1 小时，且不受存储桶私有设置影响。而 image_url 是永久性存储引用地址，若存储桶设为私有，则可能无法直接访问。

mode 字段值为 "text-to-image" 或 "image-to-image"，取决于所使用的调用路径。

Webhook / 异步模式

若在请求体中包含 webhook_url，将立即收到 HTTP 202 响应并返回 job_id。当图像生成完成后，Pop-cam 将把结果以 POST 方式推送至您指定的 URL（最多重试 3 次，采用指数退避策略）。

初始响应（HTTP 202）：

{
  "job_id": "a1b2c3d4-...",
  "status": "processing",
  "message": "Your image is being generated. Results will be POSTed to your webhook_url."
}

Webhook 推送的负载中同样包含 download_url（预签名，1 小时过期），供您下载图像。

错误处理

积分说明

• 每次生成（无论图生图或文生图）均消耗 1 点积分。
• 新注册账号可免费获得初始积分。
• 每次响应中均包含 credits_remaining 字段，显示剩余积分。
• 更多积分请访问 https://www.pop-cam.com/checkout 购买。

提示词技巧

该模型不限定于任何单一风格，最终输出完全取决于您的提示词。以下是可直接使用的风格示例：

如需获得最逼真的效果，建议在提示词中包含光照条件、镜头参数、景深及环境等细节信息。

快速参考