Bria

BRIA Product Shot

bria-product-shot

面向电商产品图的图像编辑模型，可将产品自然置入文本或参考图生成的场景背景，保留纹理与品牌细节

bria-product-shot

价格

bria-product-shot 每张

单价	$0.0575

定位简介

bria-product-shot 是面向电商产品视觉的图像编辑模型，接收产品图片并输入场景描述或场景参考图，自动将产品置入新背景，保持纹理、logo 与品牌细节，输出可用于商业展示的产品图。适合需要批量生成产品场景图、减少实体拍摄与手工合成的开发者与电商团队。

核心亮点

专为产品放置训练，光影自然——针对产品与场景的光照、阴影和尺度一致性优化，合成结果更接近实拍效果。
保留产品细节与品牌元素——在场景合成过程中保留产品纹理、logo 和品牌标识等关键细节。
文本或参考图两种场景引导——可通过英文场景描述或场景参考图指定新背景，二选一灵活控制输出。
预设位置与原始尺寸可选——支持手动指定产品在画面中的预设位置，或保留原始尺寸与位置输出。

能力说明

文本描述生成场景：提供英文场景描述（最长 1000 字符），模型自动生成背景并将产品置入，支持自动扩写描述以丰富场景细节。

参考图引导场景风格：上传场景参考图，模型跟随其背景风格合成产品图，适合统一视觉风格的批量产出。

产品位置与尺寸控制：手动放置模式支持从十个预设位置中选择产品落点；原始模式保留输入尺寸与位置，并可选择不缩放至约 1MP。

快速模式切换：默认开启快速模式以加速生成，关闭后使用标准模型，便于在速度与质量之间按需取舍。

适用场景

电商运营：产品主图批量场景化——输入产品图与场景描述，批量生成多背景产品图，用于商品详情页与广告素材。
营销团队：多风格变体制作——使用参考图引导不同背景风格，快速产出同一产品的多风格营销图，用于社交媒体与活动页面。
品牌方：上新视觉快速合成——在新品发布流程中，将产品图置入生活场景，减少实体拍摄环节，加速视觉素材上线。
开发者：自动化工作流集成——通过 HiAPI.ai 统一接口调用，将产品图场景合成嵌入内容生产管线，实现规模化自动处理。

限制与选型建议

该模型为图生图编辑能力，必须提供产品图作为输入，不支持纯文本生成图像；输出为静态图片，不涉及视频或 3D 内容。其定位聚焦电商产品场景合成，通用创意图像生成并非其目标用途。商业使用需遵循相关授权与合规条款。若需要从零生成创意图像或非产品类编辑，应选择通用图像生成模型。

近期更新

查看更新日志 →

模型上新新模型 bria-product-shot 商品场景图 Oct 20, 2026

常见问题

查看全部常见问题 →

场景描述和场景参考图能一起用吗？

不能，二选一。写英文场景描述（prompt）时不要传参考图；按参考图生成时不要写描述。Playground 里切换方式会自动清空另一种的内容。
场景描述要用英文吗？

是。prompt 请用英文描述新场景或背景，最多 1000 个字符；Playground 检测到中文会提示改写。
优化描述是什么？

开启后会自动扩写你的场景描述，默认开启；只在场景描述模式下生效，参考图模式下不会发送。
商品摆放有哪几种方式？

预设位置（manual_placement，默认；场景描述或参考图均可）会把商品放在画布的指定位置，默认底部居中，方图输入实测输出 1024×1024；保持原位（original）沿用商品在原图中的位置和比例。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：bria-product-shot

routestring可选

当前固定值：default

inputobject必填

bria-product-shot 和线路 default 的业务参数对象，见下方参数表。

fastboolean可选默认值: true

Faster generation; turn off for the standard model.

promptstring可选minLength 1maxLength 1000

English description of the new scene or background. Use either prompt or reference_image_url, not both.

image_urlstring必填minLength 1pattern ^https?://

Public URL of the product photo (JPEG, PNG or WEBP, up to 12 MB).

placement_typestring可选默认值: "manual_placement"

manual_placement puts the product at a preset position (with a scene description or a scene reference; measured 1024×1024 for square input); original keeps its position and the input size.

可选项：manual_placementoriginal

original_qualityboolean可选默认值: false

Keep the input size instead of scaling to about 1 MP. Applies to original only.

reference_image_urlstring可选minLength 1pattern ^https?://

Image whose scene or background style to follow. Use either prompt or reference_image_url, not both.

optimize_descriptionboolean可选默认值: true

Expand the scene description automatically. Applies to prompt only.

manual_placement_selectionstring可选默认值: "bottom_center"

Preset product position. Applies to manual_placement only.

可选项：bottom_centerupper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_center

显示全部（2 项）

center_verticalcenter_horizontal

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria-product-shot",
  "input": {
    "fast": true,
    "image_url": "…",
    "placement_type": "manual_placement",
    "original_quality": false,
    "optimize_description": true,
    "manual_placement_selection": "bottom_center"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "bria-product-shot",
    input: {
      "fast": true,
      "image_url": "…",
      "placement_type": "manual_placement",
      "original_quality": false,
      "optimize_description": true,
      "manual_placement_selection": "bottom_center"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "bria-product-shot",
        "input": {
          "fast": True,
          "image_url": "…",
          "placement_type": "manual_placement",
          "original_quality": False,
          "optimize_description": True,
          "manual_placement_selection": "bottom_center"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}