> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 能上传已有图片只改背景吗？参数叫 image_urls 吗？

> 使用 gpt-image-2.5-flare-std 更换图片背景时，需在 POST /v1/images/tasks 的 images 字段中传入 1–16 个可访问 HTTPS 图片链接，字段名不是 image_urls。

可以。调用 `POST /v1/images/tasks` 使用 `gpt-image-2.5-flare-std` 更换背景时，需在 `images` 数组中传入 1–16 个公网可访问的 HTTPS 图片链接。参数名是 `images`，不是 `image_urls`；传入未声明字段会返回 `400 bad_request`。

## 传入公网链接或上传本地图片

* **公网图片链接**：直接将可访问的 HTTPS 图片地址写入 `images`，并在 `prompt` 中同时写明背景改动与需要保留的主体细节。
* **本地图片文件**：先通过 `POST /v1/files` 上传本地 PNG、JPG/JPEG 或 WebP 文件（单张不超过 50 MB），再把返回的 `data.url` 放进 `images`。

```bash
curl -sS -X POST 'https://api.beatapi.io/v1/images/tasks' \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare-std",
    "prompt": "把桌面换成浅灰，保留瓶身文字、标签位置和瓶盖颜色。",
    "images": ["https://example.com/product-photo.png"]
  }'
```

## 计费方式与成图核对

* **按 token 计费与质量档位**：`gpt-image-2.5-flare-std` 仅支持异步任务，按实际文本输入、图片输入与输出 token 计费；可选 `quality` 字段（`low`、`medium`、`high`、`xhigh`、`max`，默认 `medium`）决定输出 token 用量与成本。当前单价见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。
* **发布前人工核对**：成图返回后对照原图检查瓶身文字、色彩还原与商品边缘，确认无畸变后再发布。

## 合同与相关问题

发送收费请求前，先免费查看模型合同：`model:gpt-6-luna`, `model:gpt-image-2.5-flare-std`。

[返回AI 模型问题索引](/zh/faq/models)。