# Doubao Seedream 5.0 Pro 交互编辑

> 使用标注图、点坐标与框坐标精确指定 Seedream 5.0 Pro 的图片编辑位置

交互编辑使用同一个同步端点 `POST /api/v3/images/generations`，兼容火山方舟图片生成 API 的请求与响应契约。上传待编辑图片，并通过标注图或提示词坐标指定目标位置，即可完成局部替换、删除或重绘。

<Info>
提示词坐标使用 **0..999** 的归一化坐标系：左上角为 `(0, 0)`，右下角为 `(999, 999)`。点坐标依次填写 `x y`，框坐标依次填写 `left top right bottom`。
</Info>

## 支持方式

<CardGroup cols={2}>
  <Card title="任意标记编辑" icon="pen">
    在图片上画线、画框或添加箭头，并在提示词中描述标记区域的修改目标
  </Card>
  <Card title="点坐标编辑" icon="location-dot">
    使用 `<point>x y</point>` 指定一个编辑位置
  </Card>
  <Card title="框坐标编辑" icon="vector-square">
    使用 `<bbox>left top right bottom</bbox>` 指定矩形编辑区域
  </Card>
  <Card title="普通输出控制" icon="sliders">
    可继续使用 `size`、`output_format`、`response_format` 与 `watermark`
  </Card>
</CardGroup>

## 任意标记编辑

<Steps>
  <Step title="标记目标区域">
    在原图上添加手绘线、方框或箭头等清晰标记。
  </Step>
  <Step title="上传标注图">
    将标注后的图片作为单张 `image` 输入。
  </Step>
  <Step title="描述修改目标">
    在 `prompt` 中说明标记区域及期望结果，例如“把红色箭头指向的杯子改成玻璃材质”。
  </Step>
</Steps>

## 请求示例

<CodeGroup>

```bash 标注图交互编辑（cURL）
curl -X POST "https://api.looprouter.com/api/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "把红色箭头指向的杯子改成透明玻璃材质，移除图片中的箭头标记",
    "image": "https://example.com/images/annotated-cup.png",
    "size": "2K",
    "output_format": "png"
  }'
```

```bash 点坐标编辑（cURL）
curl -X POST "https://api.looprouter.com/api/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "把图1<point>520 460</point>位置换成皇冠",
    "image": "https://example.com/images/portrait.jpg",
    "size": "2K"
  }'
```

```bash 框坐标编辑（cURL）
curl -X POST "https://api.looprouter.com/api/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "把图1<bbox>120 180 640 760</bbox>区域替换成花园",
    "image": "https://example.com/images/courtyard.jpg",
    "size": "2K"
  }'
```

</CodeGroup>

## 坐标规则

| 标签 | 格式 | 坐标范围 | 含义 |
| --- | --- | --- | --- |
| `<point>` | `<point>x y</point>` | 每个值为 **0..999** | 指定一个点 |
| `<bbox>` | `<bbox>left top right bottom</bbox>` | 每个值为 **0..999** | 指定矩形左上角与右下角 |

<Tip>
坐标按图片的相对位置计算，与输入图片的实际像素尺寸无关。例如 `(500, 500)` 大致位于图片中心。
</Tip>

<Warning>
交互编辑提示词的坐标范围是 **0..999**。图层拆分响应中的 `bounding_box.normalized` 使用另一套 **0..1000** 范围，请勿混用。
</Warning>

## 输入与输出

交互编辑属于普通单图编辑，因此必须传入一张非空图片。输入图支持 jpeg（含 jpg 别名）、png、webp、bmp、tiff（含 tif 别名）、gif、heic、heif；单张不超过 30 MB，宽和高均大于 14 px，总像素位于 [196, 36,000,000]，宽高比位于 [1/16, 16]。普通响应的 `data` 包含一张基础图。完整返回格式请参阅[图片生成与编辑](/api-capabilities/seedream/image-generation)。

当 `response_format: "url"` 时，图片链接在生成后 **24 小时**内有效；使用 `response_format: "b64_json"` 时，图片数据位于 `data[0].b64_json`。

## 相关文档

<CardGroup cols={2}>
  <Card title="图片生成与编辑" icon="image" href="/api-capabilities/seedream/image-generation">
    查看普通模式参数与输入图片限制
  </Card>
  <Card title="图层拆分" icon="layer-group" href="/api-capabilities/seedream/layer-decomposition">
    查看图层元数据与 0..1000 响应坐标
  </Card>
  <Card title="能力概览" icon="circle-info" href="/api-capabilities/seedream/overview">
    查看模型的完整能力范围
  </Card>
  <Card title="API Reference" icon="code" href="/api-reference/seedream/create-image">
    查看统一端点的请求结构
  </Card>
</CardGroup>