> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedream 5.5 レイヤー分解
> > 🚧 **このモデルはまだ利用できません。お楽しみに**
- Seedream 5.5 レイヤー分解 (doubao-seedream-5.5-layerize) は、1枚の画像をベース画像と複数の独立したレイヤーに分解します
- 入力画像は `1` 枚です。`prompt` は省略可能で、省略時は主要な要素を自動で識別して分解します
- `n` で最大出力枚数を指定し、`model_params.text_recognition` で文字認識を有効にできます
- 非同期処理です。返されたタスク ID で[タスクの状態を確認](/ja/api-manual/task-management/get-task-detail)してください
- 生成された画像リンクは24時間有効です、お早めに保存してください
### 出力について
- ベース画像の形式は `output_format` で指定します。独立したレイヤーは透過チャンネル付き PNG で出力されます
- `result_data` 内の各画像には `z_index`（重ね順。ベース画像は `0`、レイヤーは `1` から昇順）と `background`（ベース画像は `opaque`、レイヤーは `transparent`）が付きます。レイヤーには `bounding_box`（`absolute` はベース画像の座標系でのピクセル座標、`normalized` は `0`～`1000`）、`name`、`description` も付きます
- いずれかのレイヤーが失敗するとタスク全体が失敗し、全額返金されます。一部成功の結果は返されません
### 課金について
- ベース画像と各レイヤーはそれぞれ1枚として課金されます。入力画像は別途課金されます
- タスク作成時に入力画像 `1` 枚と最大 `n` 枚の出力画像に相当するクレジットを事前に確保します。完了後は実際の出力枚数で精算し、未使用分は自動で返却されます
## OpenAPI
````yaml ja/api-manual/image-series/seedream-5.5/seedream-5.5-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: doubao-seedream-5.5-layerize インターフェース
description: Seedream 5.5 のレイヤー分解モデルで、1 枚の画像をベース画像と複数の編集可能なレイヤーに分割します
license:
name: MIT
version: 1.0.0
servers:
- url: https://api.evolink.ai
description: 本番環境
security:
- bearerAuth: []
tags:
- name: 画像生成
description: AI画像生成関連API
paths:
/v1/images/generations:
post:
tags:
- 画像生成
summary: doubao-seedream-5.5-layerize インターフェース
description: >-
> 🚧 **このモデルはまだ利用できません。お楽しみに**
- Seedream 5.5 レイヤー分解 (doubao-seedream-5.5-layerize)
は、1枚の画像をベース画像と複数の独立したレイヤーに分解します
- 入力画像は `1` 枚です。`prompt` は省略可能で、省略時は主要な要素を自動で識別して分解します
- `n` で最大出力枚数を指定し、`model_params.text_recognition` で文字認識を有効にできます
- 非同期処理です。返されたタスク ID
で[タスクの状態を確認](/ja/api-manual/task-management/get-task-detail)してください
- 生成された画像リンクは24時間有効です、お早めに保存してください
### 出力について
- ベース画像の形式は `output_format` で指定します。独立したレイヤーは透過チャンネル付き PNG で出力されます
- `result_data` 内の各画像には `z_index`（重ね順。ベース画像は `0`、レイヤーは `1` から昇順）と
`background`（ベース画像は `opaque`、レイヤーは `transparent`）が付きます。レイヤーには
`bounding_box`（`absolute` はベース画像の座標系でのピクセル座標、`normalized` は
`0`～`1000`）、`name`、`description` も付きます
- いずれかのレイヤーが失敗するとタスク全体が失敗し、全額返金されます。一部成功の結果は返されません
### 課金について
- ベース画像と各レイヤーはそれぞれ1枚として課金されます。入力画像は別途課金されます
- タスク作成時に入力画像 `1` 枚と最大 `n`
枚の出力画像に相当するクレジットを事前に確保します。完了後は実際の出力枚数で精算し、未使用分は自動で返却されます
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: 自動分解（prompt なし）と文字認識
value:
model: doubao-seedream-5.5-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: png
'n': 30
model_params:
text_recognition: true
prompt_layerize:
summary: 自然言語で対象を指定
value:
model: doubao-seedream-5.5-layerize
prompt: オウムとタイトル文字を分解して
image_urls:
- https://example.com/poster.png
quality: 2K
bbox_layerize:
summary: bbox 座標で正確に指定
value:
model: doubao-seedream-5.5-layerize
prompt: >-
タイトル文字179 58 809 197、オウム1羽330 274 641
991
image_urls:
- https://example.com/poster.png
quality: 1.5K
responses:
'200':
description: 画像生成タスクが正常に作成されました
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationResponse'
'400':
description: リクエストパラメータが不正です
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: invalid_request
message: Invalid request parameters
type: invalid_request_error
'401':
description: 未認証、トークンが無効または期限切れです
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: unauthorized
message: Invalid or expired token
type: authentication_error
'402':
description: クォータ不足のため、チャージが必要です
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: insufficient_quota
message: Insufficient quota. Please top up your account.
type: insufficient_quota
'403':
description: アクセスが拒否されました
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: model_access_denied
message: >-
Token does not have access to model:
doubao-seedream-5.5-layerize
type: invalid_request_error
'429':
description: レート制限を超えました
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Too many requests, please try again later
type: rate_limit_error
'500':
description: サーバー内部エラー
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: Internal server error
type: api_error
components:
schemas:
ImageGenerationRequest:
type: object
required:
- model
- image_urls
properties:
model:
type: string
description: 画像生成モデル名
enum:
- doubao-seedream-5.5-layerize
default: doubao-seedream-5.5-layerize
example: doubao-seedream-5.5-layerize
image_urls:
type: array
description: >-
分解対象の画像 URL（必須）
**注意:**
- **ちょうど `1` 枚が必要**です。指定しない場合や `2` 枚以上を指定した場合はエラーになります
- サポートされる形式: `.png`、`.jpeg`、`.jpg`（通常の生成より厳しく、webp などは拒否されます）
- 画像サイズ: 最大 `30MB`
- 総ピクセル数: `[262144, 6000×6000]`、つまり最低 `512×512`（通常の生成より下限が高い）
- 縦横比（幅/高さ）の範囲: `[1/16, 16]`
-
画像URLはサーバーから直接参照できるか、アクセス時に直接ダウンロードが始まる必要があります（通常このようなURLは`.png`や`.jpg`などの画像拡張子で終わります）
- 入力画像は別途課金されます
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/poster.png
prompt:
type: string
description: >-
分解したい要素の指定（任意）
**3 つの使い方：**
- **指定しない**：モデルが画像内の主要な要素をすべて認識し、1 つずつ分解します
- **自然言語**：例 `オウムとタイトル文字を分解して`。意味を解釈して要素を判別し、レイヤーに分けます
- **座標指定**：`` タグで位置を指定します。例 `タイトル文字179 58 809
197`。正規化座標（`0`～`1000`）の使用を推奨します
example: オウムとタイトル文字を分解して
'n':
type: integer
description: |-
ベース画像を含む最大出力枚数。デフォルトは `30` です。
**説明：**
- 指定範囲は `2`～`100` です。範囲外では `400` が返され、課金されません
- 上限に達すると分解を終了し、残りの要素は統合または省略される場合があります。値を大きくすると、より細かな分解が可能です
- `n` が大きいほど事前に確保するクレジットも増えます。完了後は実際の出力枚数で精算し、未使用分は自動で返却されます
minimum: 2
maximum: 100
default: 30
example: 30
quality:
type: string
description: >-
出力解像度。デフォルトは `auto` です。
**オプション：** `auto`、`1K`、`1.5K`、`2K`
**説明：**
- 上記の解像度オプションのみに対応します。比率（`16:9` など）やピクセルサイズ（`2048x2048`
など）を指定するとエラーになります
- `auto` は出力が入力画像に従うことを意味します。元のサイズが `[921600, 4624220]`
ピクセルの範囲内であればそのまま、1K 未満なら 1K、2K を超えるなら 2K で出力されます
- 各レイヤーは元画像での縦横比をそれぞれ保持し、ベース画像の縦横比は入力画像と同じです
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: |-
プロンプト最適化モード。`standard` のみに対応し、デフォルトも `standard` です。
`fast` を指定すると `400` が返され、課金されません。
enum:
- standard
default: standard
example: standard
output_format:
type: string
description: >-
出力画像フォーマット
**オプション：**
- `png`：PNG フォーマット（デフォルト）
- `jpeg`：JPEG フォーマット
**注意：** このパラメータは**ベース画像のみを制御します**。分解されたレイヤーは常に透過チャンネル付きの png
で、この設定の影響を受けません。
enum:
- png
- jpeg
default: png
example: png
model_params:
type: object
description: レイヤー分解の追加オプションです。`text_recognition` のみ指定でき、他のキーを渡すと `400` が返されます。
properties:
text_recognition:
type: boolean
description: >-
文字レイヤーに対して文字認識を行うかどうか
- `false`：レイヤーには `name`、`description`、`bounding_box`
のみが含まれます（デフォルト）
- `true`：整った文字のレイヤーには `text_recognition` が追加されます。全文の `text`（複数行は
`\n` で結合し、上から下、次に左から右の順）、各行の `bounding_box`、各テキスト部分の `text` と
`style`（`similar_font_family` は類似フォント、`foreground_color`
は文字色、`bold` / `italic` / `underline` / `strikethrough` /
`shadow` / `translucent` はスタイルフラグ）を含みます
アート文字、手書き文字、装飾文字のレイヤーには `text_recognition` は返されません。
default: false
example: true
callback_url:
type: string
description: >-
タスク完了後の HTTPS コールバックアドレス
**コールバックタイミング：**
- タスクが完了、失敗、またはキャンセルされた時にトリガーされます
- 課金確認完了後に送信されます
**セキュリティ制限：**
- HTTPS プロトコルのみサポート
- 内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x
など）
- URL の長さは `2048` 文字以内
**コールバックメカニズム：**
- タイムアウト：`10` 秒
- 失敗時最大 `3` 回リトライ（`1` 秒/`2` 秒/`4` 秒後にリトライ）
- コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
- コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします
format: uri
example: https://your-domain.com/webhooks/image-task-completed
ImageGenerationResponse:
type: object
properties:
created:
type: integer
description: タスク作成タイムスタンプ
example: 1757165031
id:
type: string
description: タスク ID
example: task-unified-1793612934-seedream55layerize
model:
type: string
description: 使用された実際のモデル名
example: doubao-seedream-5.5-layerize
object:
type: string
enum:
- image.generation.task
description: 具体的なタスクタイプ
progress:
type: integer
description: タスク進捗率（0-100）
minimum: 0
maximum: 100
example: 0
status:
type: string
description: タスクステータス
enum:
- pending
- processing
- completed
- failed
example: pending
task_info:
$ref: '#/components/schemas/TaskInfo'
description: 非同期タスク情報
type:
type: string
enum:
- text
- image
- audio
- video
description: タスク出力タイプ
example: image
usage:
$ref: '#/components/schemas/Usage'
description: 使用量と課金情報
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: エラーコード識別子
message:
type: string
description: エラーの説明
type:
type: string
description: エラータイプ
TaskInfo:
type: object
properties:
can_cancel:
type: boolean
description: タスクをキャンセルできるかどうか
example: true
estimated_time:
type: integer
description: 推定完了時間（秒）
minimum: 0
example: 150
Usage:
type: object
description: 使用量と課金情報
properties:
billing_rule:
type: string
description: 課金ルール
enum:
- per_call
- per_image
- per_token
- per_second
example: per_image
credits_reserved:
type: number
description: 推定消費クレジット
minimum: 0
example: 55.624
user_group:
type: string
description: ユーザーグループカテゴリ
example: default
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: |-
##すべてのAPIにBearer Token認証が必要です##
**APIキーの取得：**
[APIキー管理ページ](https://evolink.ai/dashboard/keys)にアクセスしてAPIキーを取得してください
**リクエストヘッダーに追加：**
```
Authorization: Bearer YOUR_API_KEY
```
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.