# 透明背景与思考模式

<a id="transparent-background"></a>

<a id="透明背景"></a>

## 透明背景

文生图与图生图

选择 Adobe GPT Image 图片模型，例如 `firefly-gpt-image-2`，在请求中传 `"background": "transparent"`。图生图表单传 `background=transparent`；JSON 编辑同样支持该字段。`opaque` 请求不透明背景，省略或传 `auto` 使用模型默认行为。

提示词应明确主体独立、无桌面或场景背景；完整场景描述可能只让画面边缘透明。`response_format` 只决定返回 URL 还是 Base64，两种方式都保留原图透明度。保存时保留 PNG 等支持透明度的原始格式；不要转换成 JPEG，`transparent` 与 `output_format: "jpeg"` 同传会返回 400。

 **生成透明背景图片**  `POST /v1/images/generations`

```bash
curl 'https://y.junlistudio.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "gpt-image-2-high",
  "prompt": "一只独立的红色陶瓷杯，完整主体，透明背景，无桌面、无环境场景",
  "background": "transparent",
  "response_format": "b64_json"
}'
```

 **编辑为透明背景**  `POST /v1/images/edits · multipart`

```bash
curl 'https://y.junlistudio.com/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=gpt-image-2-high' \
  -F 'prompt=保留图中主体，去掉背景，输出透明背景图片' \
  -F 'image=@input.png' \
  -F 'background=transparent' \
  -F 'response_format=b64_json'
```

使用 Base64 响应时，将 `data[0].b64_json` 解码后保存图片。此参数用于 `/v1/images/generations` 和 `/v1/images/edits`；`/v1/responses` 的布尔值 `background: true` 表示后台执行，当前不提供透明背景选项。

<a id="思考模式与附加费用"></a>

## 思考模式与附加费用

`thinking` 是独立布尔参数，不改变公开模型 ID。通过 `GET /v1/models` 查看 `thinking_supported` 和 `thinking_price`；当前价格可在模型目录查看。每张总价 = 当前用户的图片价格 + 开启思考时的附加积分；工作台另选去AI特征时再叠加对应费用。附加费默认 1 积分，可由管理员按模型修改，0 表示免费。

总价一并参与余额、API Key 额度和模型价格上限检查。生成失败按原扣费总额退款；后续调价不改变已有扣费的退款金额。请求按已确认的思考模式价格计费，不重复扣费。内容审核拒绝、请求取消及已提交但尚未确定结果的任务不会另起一笔生成。思考不保证更快或固定提升画质。

 **开启思考生图**  `POST /v1/images/generations`

```bash
curl 'https://y.junlistudio.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "gpt-image-2.5-flare",
  "prompt": "金色夕阳下的逆光人像",
  "thinking": true,
  "response_format": "url"
}'
```

```python
from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://y.junlistudio.com/v1")
result = client.images.generate(
    model="gpt-image-2.5-flare",
    prompt="金色夕阳下的逆光人像",
    response_format="url",
    extra_body={"thinking": True},
)
print(result.data[0].url)
```

Python OpenAI SDK 使用 `extra_body={"thinking": True}` 传递本站扩展参数。图生图表单加 `-F thinking=true`；后台图片任务在 `/v1/responses` 顶层同时传 `"background": true` 和 `"thinking": true`，两个开关互相独立。

调用前请携带密钥读取 [GET /v1/models](https://y.junlistudio.com/docs.md?page=models#models) 确认可用模型；生成请求会按所选模型计费。