透明背景与思考模式

透明背景

文生图与图生图

选择 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

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

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 表示后台执行，当前不提供透明背景选项。

思考模式与附加费用

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

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

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

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"
}'

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 确认可用模型；生成请求会按所选模型计费。