生成图片

根据文字描述或参考图生成图片，成功后返回图片 URL 或 Base64 数据。 按张计费模型按成功生成张数 × 单价结算，币种以调用站点为准；按 token 计费模型按实际用量结算。

Seedream 5.0 Pro / Flash 图层拆分

使用支持分层的 Seedream 5.0 Pro / Flash 模型，传入 layer_decomposition: true 和一张待拆分图片。 分层输入仅支持 PNG 或 JPEG；上传文件和 Base64 Data URI 也须使用这两种格式。 prompt 可省略以自动识别主要元素，也可指定需要拆分的元素。普通图片生成仍须传入 prompt。 分层 size 支持 auto（默认）、1K、1.5K、2K；仅支持单张输入，n 须为 1。 返回 1 张底图和最多 16 个带透明通道的 PNG 图层。output_format 仅控制底图格式，图层始终为 PNG。 data 中保留 z_index、name、description、bounding_box；底图 z_index=0，其余图层按数值递增叠放。 bounding_box.absolute 是输出底图中的像素坐标，normalized 是 0–1000 的归一化坐标，均为 [left, top, right, bottom]。 还原时将图层缩放至框的宽高，再放到框的左上角，按 z_index 从小到大叠放；各图层文件尺寸可以与底图不同。 底图和每个成功输出图层分别按实际输出分辨率计费；n=1 不表示只收一张的费用。 这与 sequential_image_generation 组图生成不同；5.0 Pro 不支持组图生成。

Seedream 5.0 Pro 计费方式

普通生成与图层拆分分别按实际输出分辨率结算。每张成功输出的实际像素数为其宽 × 高；261 万像素（2,610,000）及以下为低档，超过该值为高档。 底图也算一张输出；底图和所有成功图层各按自己的实际像素档位计费，同一请求可混合高低档。n=1 是一次拆分请求，不是只计一张费用。 只有成功输出计费，失败请求不扣费并退还冻结金额。 Pro 的首张参考图免费，第 2 张起按参考图张数收取输入费用。每次请求参考图费用为 max(参考图张数 − 1, 0) × 当前账户输入单价，仅计算一次，不按输出张数倍增；输出图片费用另算。分层恰好一张参考图，因此没有参考图输入费用。 适用的账户折扣同时作用于输入和输出单价。具体单价和适用折扣以当前调用站点的模型价格列表为准。

以下请求示例使用国内站；海外调用请使用对应站点和模型 ID。

curl https://api.xrtoken.net/v1/images/generations \
  -H "Authorization: Bearer $XRTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"volcengine/doubao-seedream-5.0-pro","image":"https://example.com/source.png","layer_decomposition":true,"size":"auto","response_format":"url"}'

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -X post "https://api.xrtoken.net/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "volcengine/doubao-seedream-5.0-pro",    "image": []  }'

{
  "created": 0,
  "data": [
    {
      "url": "http://example.com",
      "b64_json": "string",
      "size": "1273x265",
      "output_format": "string",
      "z_index": 0,
      "name": "string",
      "description": "string",
      "bounding_box": {
        "absolute": [
          383,
          120,
          1655,
          384
        ],
        "normalized": [
          187,
          59,
          808,
          188
        ]
      }
    }
  ],
  "usage": {
    "input_images": 0,
    "generated_images": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0
  }
}

{
  "error": "model field is required",
  "type": "invalid_request_error"
}

{
  "error": "invalid or missing API key",
  "type": "auth_error"
}

{
  "error": "insufficient balance -- please top up or upgrade your plan",
  "type": "billing_error"
}

{
  "error": "rate limit exceeded",
  "type": "rate_limit_error"
}

{
  "error": "upstream provider error",
  "type": "server_error"
}