生成

文本 → 图像

POST/v1/images

通过文本提示词生成图像，还可使用最多 4 张参考图像来引导结果。

异步 返回 id，可轮询或使用 webhook通常 ~10–40s费用 ≈15–50 credits

参数

参数说明
prompt必填
string		图像提示词。最多 5,000 个字符。
model可选
string		使用的图像模型。例如 nano-banana、gpt-image-2。省略则使用默认模型。列表：GET /v1/models?category=image。
aspectRatio可选
string		例如 1:1、16:9、9:16。支持的宽高比因模型而异，请参见 GET /v1/models 中的 supportedAspectRatios。
referenceImages可选
string[]		用作视觉引导的图像 URL，最多 4 个。本地文件放入 multipart 的 referenceFiles 部分（每个 ≤20 MB）。参考图编辑推荐使用 nano-banana。

请求

请求
curl -X POST https://api.picoberry.ai/v1/images \
  -H "Authorization: Bearer pb_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a low-poly wooden barrel","model":"nano-banana","aspectRatio":"1:1"}'
r = requests.post("https://api.picoberry.ai/v1/images", headers=headers,
    json={"prompt": "a low-poly wooden barrel", "model": "nano-banana"})
asset_id = r.json()["data"]["id"]
const res = await fetch(`${BASE}/v1/images`, {
  method: "POST", headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "a low-poly wooden barrel", model: "nano-banana" }),
});
const { id } = (await res.json()).data;

响应

响应 · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0, "type": "image" } }

轮询 GET /v1/assets/{id} 直到 taskStatus 变为 2；图像 URL 会出现在 files.image 中。

参考图像（本地文件）

可以发送 multipart/form-data，包含最多 4 个 referenceFiles 部分（每个 ≤20 MB），以替代托管的 referenceImages URL，其余字段将作为表单字段。

curl -X POST https://api.picoberry.ai/v1/images \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "prompt=a low-poly wooden barrel" -F "model=nano-banana" \
  -F "referenceFiles=@./ref1.png" -F "referenceFiles=@./ref2.png"