{ "aboutHtml": "

高速な画像制作エディション

Seedream 5.0 Flashは、生成速度を優先するフロー向けのByteDance Seedの画像生成・編集モデルです。メーカーのPro/Flashガイドは、テキストから画像と、一つまたは複数参照の画像から画像を説明しています。Flashの高速生成とProの高品質重視を区別し、すべての指示の固定応答時間は定めません。

共通の特徴は対話的な編集、レイヤー分解、ネイティブ多言語生成です。通常生成は完成画像1枚を返します。メーカーのFlashフローは、連続した関連画像生成、ウェブ検索、画像のストリーミング出力に対応しません。プロンプト最適化はstandardで、別のfast最適化制御はFlashでなくProに属します。

指示と参照から制作する

意図した画、主要被写体、構図、視覚処理を述べ、各参照の制御対象を特定します。商品ビジュアルでは、物体を定める参照と配色や表面素材を与える参照を分けます。「最初の画像の物体のシルエットと視点を保ち、二つ目は抑えた背景配色だけに使う」と役割を分けられます。

メーカーは中国語300文字以下、英語600語以下の簡潔なプロンプトを推奨しています。これは準備の目安で、厳密なテキスト入力上限とされたものではありません。必要な正確な文言、アスペクト比、保持する細部など、決定的な要件を先に挙げます。全体の印象だけに頼らず、この一覧と完成画像を比較します。

空間指示による編集

Flashは点、バウンディングボックス、矢印、自由な印で編集位置を示せます。元画像に位置と変更を添えます。室内案なら椅子を示し、布の交換を求め、床、壁、カメラ角度、近くの物体を保つよう指定します。印がガイドだけなら、完成画像から消すよう明示します。

メーカーの座標編集ガイドは<point>と<bbox>を使い、指定入力画像に対して0〜999に正規化した座標を指定します。点はx、y、ボックスは左上と右下です。特に枠に複数被写体が入る場合、画像番号と対象物を特定します。画像間編集では、一つの参照から取る物体と、別画像内の配置先を区別します。

比例位置を求める際は表示画像自体の寸法を使います。キャンバスのズーム、パン、ブラウザー座標は正規化画像座標ではありません。編集領域とともに保護領域も説明します。結果の遠近、照明、周囲の細部を元画像と比較します。

構成を編集可能なレイヤーに分ける

レイヤー分解は独立したモードで、画像ちょうど1枚から、ベース画像と最大16個の独立レイヤーを返します。各レイヤーはアルファ付きPNGです。プロンプトでタイトル、主要被写体、装飾など分ける要素を示せます。分解指示がなければ主な要素を自動で特定します。

結果にはレイヤー名、説明、重なり順、配置ボックスが含まれます。ベース画像を重なりインデックス0とし、他を昇順で置きます。絶対ボックスは出力ベース上、正規化ボックスは別キャンバス上の比例配置です。再配置前に元構成を復元できるよう、返された配置メタデータを画像ファイルとともに保ちます。

ポスター修正なら主画像をタイトル・装飾から分け、輪郭や復元された背景を確認します。透明レイヤーは、アルファチャンネルを持つ一つの入力で編集し、透明PNGを出力できます。透明背景オプションはこの単一入力の画像編集に限られ、通常のテキストから画像は別操作です。

多言語の構成

中国語と英語に加え、メーカーはロシア語、アラビア語、フィリピノ語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語のネイティブプロンプト・画像内文字に対応すると文書化しています。承認済みの正確な文言、読む方向、各文章ブロックの領域を示します。完成画像のアクセント記号、結合文字、改行、小さなラベルを確認します。

参照ファイルと出力仕様

画像生成はJPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIFの参照最大10枚です。各最大30 MB、両辺14ピクセル超、総画素196〜36,000,000、アスペクト比1:16〜16:1です。レイヤー分解はJPEGまたはPNG1枚、262,144〜36,000,000ピクセル、最大30 MB、同じ比率範囲です。

生成は1K、1.5K、2K、既定2K、または総画素921,600〜4,624,220、比率1:16〜16:1の明示寸法です。カスタム寸法には両制約が適用されます。レイヤー出力は1K、1.5K、2K、auto、既定autoで、ベースと各レイヤーはそれぞれ元の比率を保ちます。

完成画像はJPEGまたはPNGです。ベースの形式は別途選べ、分解レイヤーはアルファ付きPNGです。符号化画像データまたは24時間保持されるダウンロードリンクで受け取れます。返されたすべての画像とメタデータを目的のデザインフロー向けに保存します。使用サイズで文字、編集細部、レイヤーの位置合わせを確認します。

", "aboutText": "高速な画像制作エディション\n\nSeedream 5.0 Flashは、生成速度を優先するフロー向けのByteDance Seedの画像生成・編集モデルです。メーカーのPro/Flashガイドは、テキストから画像と、一つまたは複数参照の画像から画像を説明しています。Flashの高速生成とProの高品質重視を区別し、すべての指示の固定応答時間は定めません。\n\n共通の特徴は対話的な編集、レイヤー分解、ネイティブ多言語生成です。通常生成は完成画像1枚を返します。メーカーのFlashフローは、連続した関連画像生成、ウェブ検索、画像のストリーミング出力に対応しません。プロンプト最適化はstandardで、別のfast最適化制御はFlashでなくProに属します。\n\n指示と参照から制作する\n\n意図した画、主要被写体、構図、視覚処理を述べ、各参照の制御対象を特定します。商品ビジュアルでは、物体を定める参照と配色や表面素材を与える参照を分けます。「最初の画像の物体のシルエットと視点を保ち、二つ目は抑えた背景配色だけに使う」と役割を分けられます。\n\nメーカーは中国語300文字以下、英語600語以下の簡潔なプロンプトを推奨しています。これは準備の目安で、厳密なテキスト入力上限とされたものではありません。必要な正確な文言、アスペクト比、保持する細部など、決定的な要件を先に挙げます。全体の印象だけに頼らず、この一覧と完成画像を比較します。\n\n空間指示による編集\n\nFlashは点、バウンディングボックス、矢印、自由な印で編集位置を示せます。元画像に位置と変更を添えます。室内案なら椅子を示し、布の交換を求め、床、壁、カメラ角度、近くの物体を保つよう指定します。印がガイドだけなら、完成画像から消すよう明示します。\n\nメーカーの座標編集ガイドはとを使い、指定入力画像に対して0〜999に正規化した座標を指定します。点はx、y、ボックスは左上と右下です。特に枠に複数被写体が入る場合、画像番号と対象物を特定します。画像間編集では、一つの参照から取る物体と、別画像内の配置先を区別します。\n\n比例位置を求める際は表示画像自体の寸法を使います。キャンバスのズーム、パン、ブラウザー座標は正規化画像座標ではありません。編集領域とともに保護領域も説明します。結果の遠近、照明、周囲の細部を元画像と比較します。\n\n構成を編集可能なレイヤーに分ける\n\nレイヤー分解は独立したモードで、画像ちょうど1枚から、ベース画像と最大16個の独立レイヤーを返します。各レイヤーはアルファ付きPNGです。プロンプトでタイトル、主要被写体、装飾など分ける要素を示せます。分解指示がなければ主な要素を自動で特定します。\n\n結果にはレイヤー名、説明、重なり順、配置ボックスが含まれます。ベース画像を重なりインデックス0とし、他を昇順で置きます。絶対ボックスは出力ベース上、正規化ボックスは別キャンバス上の比例配置です。再配置前に元構成を復元できるよう、返された配置メタデータを画像ファイルとともに保ちます。\n\nポスター修正なら主画像をタイトル・装飾から分け、輪郭や復元された背景を確認します。透明レイヤーは、アルファチャンネルを持つ一つの入力で編集し、透明PNGを出力できます。透明背景オプションはこの単一入力の画像編集に限られ、通常のテキストから画像は別操作です。\n\n多言語の構成\n\n中国語と英語に加え、メーカーはロシア語、アラビア語、フィリピノ語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語のネイティブプロンプト・画像内文字に対応すると文書化しています。承認済みの正確な文言、読む方向、各文章ブロックの領域を示します。完成画像のアクセント記号、結合文字、改行、小さなラベルを確認します。\n\n参照ファイルと出力仕様\n\n画像生成はJPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIFの参照最大10枚です。各最大30 MB、両辺14ピクセル超、総画素196〜36,000,000、アスペクト比1:16〜16:1です。レイヤー分解はJPEGまたはPNG1枚、262,144〜36,000,000ピクセル、最大30 MB、同じ比率範囲です。\n\n生成は1K、1.5K、2K、既定2K、または総画素921,600〜4,624,220、比率1:16〜16:1の明示寸法です。カスタム寸法には両制約が適用されます。レイヤー出力は1K、1.5K、2K、auto、既定autoで、ベースと各レイヤーはそれぞれ元の比率を保ちます。\n\n完成画像はJPEGまたはPNGです。ベースの形式は別途選べ、分解レイヤーはアルファ付きPNGです。符号化画像データまたは24時間保持されるダウンロードリンクで受け取れます。返されたすべての画像とメタデータを目的のデザインフロー向けに保存します。使用サイズで文字、編集細部、レイヤーの位置合わせを確認します。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8d62fb60029ff2e037e090c261a4d72b520e58d423331b03f68d8a68be59e1aa", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ja", "methods": [ { "html": "

•

ByteDance Seed: Seedream 5.0 Flash

ByteDance Seed /bytedance-seed/seedream-5-0-flash

はじめに

テキストの制作指示から完成画像を1枚作成します。

商品の静止画像を作成
ビジュアルコンセプトを探る
シーンを描く

対応する入力: テキスト
結果: 画像

モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

高速な画像制作エディション

Seedream 5.0 Flashは、生成速度を優先するフロー向けのByteDance Seedの画像生成・編集モデルです。メーカーのPro/Flashガイドは、テキストから画像と、一つまたは複数参照の画像から画像を説明しています。Flashの高速生成とProの高品質重視を区別し、すべての指示の固定応答時間は定めません。

共通の特徴は対話的な編集、レイヤー分解、ネイティブ多言語生成です。通常生成は完成画像1枚を返します。メーカーのFlashフローは、連続した関連画像生成、ウェブ検索、画像のストリーミング出力に対応しません。プロンプト最適化はstandardで、別のfast最適化制御はFlashでなくProに属します。

指示と参照から制作する

意図した画、主要被写体、構図、視覚処理を述べ、各参照の制御対象を特定します。商品ビジュアルでは、物体を定める参照と配色や表面素材を与える参照を分けます。「最初の画像の物体のシルエットと視点を保ち、二つ目は抑えた背景配色だけに使う」と役割を分けられます。

メーカーは中国語300文字以下、英語600語以下の簡潔なプロンプトを推奨しています。これは準備の目安で、厳密なテキスト入力上限とされたものではありません。必要な正確な文言、アスペクト比、保持する細部など、決定的な要件を先に挙げます。全体の印象だけに頼らず、この一覧と完成画像を比較します。

空間指示による編集

Flashは点、バウンディングボックス、矢印、自由な印で編集位置を示せます。元画像に位置と変更を添えます。室内案なら椅子を示し、布の交換を求め、床、壁、カメラ角度、近くの物体を保つよう指定します。印がガイドだけなら、完成画像から消すよう明示します。

メーカーの座標編集ガイドは<point>と<bbox>を使い、指定入力画像に対して0〜999に正規化した座標を指定します。点はx、y、ボックスは左上と右下です。特に枠に複数被写体が入る場合、画像番号と対象物を特定します。画像間編集では、一つの参照から取る物体と、別画像内の配置先を区別します。

比例位置を求める際は表示画像自体の寸法を使います。キャンバスのズーム、パン、ブラウザー座標は正規化画像座標ではありません。編集領域とともに保護領域も説明します。結果の遠近、照明、周囲の細部を元画像と比較します。

構成を編集可能なレイヤーに分ける

レイヤー分解は独立したモードで、画像ちょうど1枚から、ベース画像と最大16個の独立レイヤーを返します。各レイヤーはアルファ付きPNGです。プロンプトでタイトル、主要被写体、装飾など分ける要素を示せます。分解指示がなければ主な要素を自動で特定します。

結果にはレイヤー名、説明、重なり順、配置ボックスが含まれます。ベース画像を重なりインデックス0とし、他を昇順で置きます。絶対ボックスは出力ベース上、正規化ボックスは別キャンバス上の比例配置です。再配置前に元構成を復元できるよう、返された配置メタデータを画像ファイルとともに保ちます。

ポスター修正なら主画像をタイトル・装飾から分け、輪郭や復元された背景を確認します。透明レイヤーは、アルファチャンネルを持つ一つの入力で編集し、透明PNGを出力できます。透明背景オプションはこの単一入力の画像編集に限られ、通常のテキストから画像は別操作です。

多言語の構成

中国語と英語に加え、メーカーはロシア語、アラビア語、フィリピノ語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語のネイティブプロンプト・画像内文字に対応すると文書化しています。承認済みの正確な文言、読む方向、各文章ブロックの領域を示します。完成画像のアクセント記号、結合文字、改行、小さなラベルを確認します。

参照ファイルと出力仕様

画像生成はJPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIFの参照最大10枚です。各最大30 MB、両辺14ピクセル超、総画素196〜36,000,000、アスペクト比1:16〜16:1です。レイヤー分解はJPEGまたはPNG1枚、262,144〜36,000,000ピクセル、最大30 MB、同じ比率範囲です。

生成は1K、1.5K、2K、既定2K、または総画素921,600〜4,624,220、比率1:16〜16:1の明示寸法です。カスタム寸法には両制約が適用されます。レイヤー出力は1K、1.5K、2K、auto、既定autoで、ベースと各レイヤーはそれぞれ元の比率を保ちます。

完成画像はJPEGまたはPNGです。ベースの形式は別途選べ、分解レイヤーはアルファ付きPNGです。符号化画像データまたは24時間保持されるダウンロードリンクで受け取れます。返されたすべての画像とメタデータを目的のデザインフロー向けに保存します。使用サイズで文字、編集細部、レイヤーの位置合わせを確認します。

Ailootで利用可能 · 入力とメソッド

Ailoot Ultra · 画像 POST /v1/images/generations

入力の種類: text
出力の種類: image
出力形式: 画像ファイル
出力数: 1 出力

フィールド	種類	要件	値と制限	デフォルト
フィールド`model`	種類`string`	要件必須	値と制限 bytedance-seed/seedream-5-0-flash	デフォルト—
フィールド`prompt`	種類`string`	要件必須	値と制限最小の長さ: 1 条件: 空でないUTF8のプロンプト。メーカー全体に共通する文字数上限を独自に設けることはしません。	デフォルト—
フィールド`n`	種類`integer`	要件任意	値と制限 1	デフォルト1
フィールド`response_format`	種類`string`	要件任意	値と制限 url, b64_json	デフォルト—
フィールド`stream`	種類`boolean`	要件任意	値と制限 false	デフォルトfalse

入力素材の組み合わせ

テキストから画像へ · 必須: prompt

メソッドのパラメータとライフサイクル

パラメータ	仕様
パラメータ`content_type`	仕様application/json
パラメータ`required`	仕様model, prompt
パラメータ`material_types`	仕様text
パラメータ`optional`	仕様n, response_format, stream
パラメータ`n`	仕様1
パラメータ`stream`	仕様false
パラメータ`response_format`	仕様url, b64_json
パラメータ`reference_images`	仕様false
パラメータ`edit`	仕様false
パラメータ`output_format_optional`	仕様
パラメータ`resolution_control`	仕様null
パラメータ`aspect_ratio_control`	仕様null
パラメータ`other_fields`	仕様固定された内部プロバイダールーティングと厳密に一致する場合を除き、拒否されます

ライフサイクル: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · 実際に返された task_id またはメディアライブラリのレコード

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

プロンプトから画像を一枚生成します。

すべてのデータ項目を保存してください。url/b64_jsonは結果のエンコード形式です。

料金

最終料金の計算方法

表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。

料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。

高速モード: 未指定高速モードが選択されている場合
Flex モード: 未指定 flex モードが選択されている場合
最大推論量: 未指定推論量が最大で、調整に既定値（default）を使用する場合

比較用の推定料金

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定	料金表	予測数量	課金単位	料金
設定基本トークン料金	料金表基本料金	予測数量—	課金単位—	料金入力 · 入力トークン · 比較専用の見積もり — / 1K トークン出力 · 出力トークン · 比較専用の見積もり — / 1K トークン入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン
設定入力画像	料金表—	予測数量—	課金単位入力画像あたり	料金入力 · 入力画像 · 比較専用の見積もり $0 入力画像あたり
設定Ultra	料金表—	予測数量—	課金単位出力画像あたり	料金出力 · 画像出力 · 比較専用の見積もり $0.036 出力画像あたり
設定生成費用の見積もり	料金表—	予測数量生成1回分の概算	課金単位—	料金出力 · 推定生成コスト · 比較専用の見積もり $0.036 生成前の見積もりこの見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →

参考料金の詳細

モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。

画像料金の設定

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定	課金条件	料金
設定出力画像	課金条件料金バリエーションは宣言されていません。	料金出力 · 出力画像 $0.036 画像あたり
設定入力画像	課金条件料金バリエーションは宣言されていません。	料金入力 · 入力画像 $0 画像あたり

同等の掲載項目は同じ料金を示しています。二つ目の料金が加算されるわけではありません。

リクエスト例

Ailoot Ultra · 画像

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

from openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\n\nrequest={'model': 'bytedance-seed/seedream-5-0-flash', 'prompt': 'A lighthouse on a cliff, watercolor', 'n': 1, 'response_format': 'b64_json'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

結果を受け取って保存

Ailoot Ultra · 画像

返された画像をすべてダウンロードするか、Base64の内容を保存

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

完了した結果をすべて保存

完了した画像をすべて保存してください。返された各URLから取得するか、Base64の内容をデコードしてください。

すべてのデータ項目を保存してください。各 b64_json をデコードするか、返された署名付き URL すべてから取得してください。実際の MIME タイプ／バイト列に応じてファイル名の拡張子を選んでください。

元のレスポンスを確認する場合

画像の生成または編集の結果に確認が必要な場合は、元の operation_id/X-Client-Request-ID と、返された結果情報を保存してください。実際の task_id または asset_id の値を使い、メディアライブラリから自分が所有する既存の結果を取得してください。生成／編集リクエストを再送したり、operation_id からポーリング URL を組み立てたりしないでください。

レスポンスのフィールド

フィールド	種類
フィールド`created`	種類integer
フィールド`data[].url`	種類string
フィールド`data[].b64_json`	種類base64 string
フィールド`usage`	種類object

エラーと次の手順

レスポンス	条件	次の手順
レスポンス400 · `invalid_request_error`	条件必須フィールド、素材の表現形式、またはパラメーター値が不正です	次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。
レスポンス`server_error`	条件返されたレスポンスは、操作または結果の確認が必要であることを示しています	次の手順最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。

エイリアス

モデルのエイリアス

Ailoot Ultra bytedance-seed/seedream-5-0-flash

メソッドパスのエイリアス

上記に表示されたメソッドパスを使用してください。

関連する呼び出し用ID

bytedance-seed/seedream-5-0-flash

", "method_identity": { "effective_request_model_id": "bytedance-seed/seedream-5-0-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "bytedance-seed/seedream-5-0-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|bytedance-seed%2Fseedream-5-0-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "必須フィールド、素材の表現形式、またはパラメーター値が不正です", "http_status": 400, "recovery": "新しい生成リクエストを送る前に、指定されたフィールドを修正してください。", "type": "invalid_request_error" }, { "code": null, "condition": "返されたレスポンスは、操作または結果の確認が必要であることを示しています", "http_status": null, "recovery": "最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "画像の生成または編集の結果に確認が必要な場合は、元の operation_id/X-Client-Request-ID と、返された結果情報を保存してください。実際の task_id または asset_id の値を使い、メディアライブラリから自分が所有する既存の結果を取得してください。生成／編集リクエストを再送したり、operation_id からポーリング URL を組み立てたりしないでください。" }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "すべてのデータ項目を保存してください。各 b64_json をデコードするか、返された署名付き URL すべてから取得してください。実際の MIME タイプ／バイト列に応じてファイル名の拡張子を選んでください。", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "空でないUTF8のプロンプト。メーカー全体に共通する文字数上限を独自に設けることはしません。", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "プロンプトから画像を一枚生成します。", "すべてのデータ項目を保存してください。url/b64_jsonは結果のエンコード形式です。" ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "固定された内部プロバイダールーティングと厳密に一致する場合を除き、拒否されます", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "実際に返された task_id またはメディアライブラリのレコード", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "入力画像", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "生成費用の見積もり", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"とを使い、指定入力画像に対して0〜999に正規化した座標を指定します。点はx、y、ボックスは左上と右下です。特に枠に複数被写体が入る場合、画像番号と対象物を特定します。画像間編集では、一つの参照から取る物体と、別画像内の配置先を区別します。\n\n比例位置を求める際は表示画像自体の寸法を使います。キャンバスのズーム、パン、ブラウザー座標は正規化画像座標ではありません。編集領域とともに保護領域も説明します。結果の遠近、照明、周囲の細部を元画像と比較します。\n\n構成を編集可能なレイヤーに分ける\n\nレイヤー分解は独立したモードで、画像ちょうど1枚から、ベース画像と最大16個の独立レイヤーを返します。各レイヤーはアルファ付きPNGです。プロンプトでタイトル、主要被写体、装飾など分ける要素を示せます。分解指示がなければ主な要素を自動で特定します。\n\n結果にはレイヤー名、説明、重なり順、配置ボックスが含まれます。ベース画像を重なりインデックス0とし、他を昇順で置きます。絶対ボックスは出力ベース上、正規化ボックスは別キャンバス上の比例配置です。再配置前に元構成を復元できるよう、返された配置メタデータを画像ファイルとともに保ちます。\n\nポスター修正なら主画像をタイトル・装飾から分け、輪郭や復元された背景を確認します。透明レイヤーは、アルファチャンネルを持つ一つの入力で編集し、透明PNGを出力できます。透明背景オプションはこの単一入力の画像編集に限られ、通常のテキストから画像は別操作です。\n\n多言語の構成\n\n中国語と英語に加え、メーカーはロシア語、アラビア語、フィリピノ語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語のネイティブプロンプト・画像内文字に対応すると文書化しています。承認済みの正確な文言、読む方向、各文章ブロックの領域を示します。完成画像のアクセント記号、結合文字、改行、小さなラベルを確認します。\n\n参照ファイルと出力仕様\n\n画像生成はJPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIFの参照最大10枚です。各最大30 MB、両辺14ピクセル超、総画素196〜36,000,000、アスペクト比1:16〜16:1です。レイヤー分解はJPEGまたはPNG1枚、262,144〜36,000,000ピクセル、最大30 MB、同じ比率範囲です。\n\n生成は1K、1.5K、2K、既定2K、または総画素921,600〜4,624,220、比率1:16〜16:1の明示寸法です。カスタム寸法には両制約が適用されます。レイヤー出力は1K、1.5K、2K、auto、既定autoで、ベースと各レイヤーはそれぞれ元の比率を保ちます。\n\n完成画像はJPEGまたはPNGです。ベースの形式は別途選べ、分解レイヤーはアルファ付きPNGです。符号化画像データまたは24時間保持されるダウンロードリンクで受け取れます。返されたすべての画像とメタデータを目的のデザインフロー向けに保存します。使用サイズで文字、編集細部、レイヤーの位置合わせを確認します。", "alias_of": null, "aliases": [], "author": "ByteDance Seed", "available": null, "canonical_model": "bytedance-seed/seedream-5-0-flash", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "構成の料金情報はすべて詳細で確認できます。" } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c28268da12f5c8a4b252dcc4", "label": "画像料金の設定", "profiles": [ { "basis": "同等の掲載項目は同じ料金を示しています。二つ目の料金が加算されるわけではありません。", "dimensions": { "conditions": "料金バリエーションは宣言されていません。" }, "label": "出力画像", "units": [ { "amount": "0.036", "amount_unit": "usd_per_image", "billing_input": false, "key": "output_image", "label": "Output image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "out", "unit": "image" } ] }, { "basis": "同等の掲載項目は同じ料金を示しています。二つ目の料金が加算されるわけではありません。", "dimensions": { "conditions": "料金バリエーションは宣言されていません。" }, "label": "入力画像", "units": [ { "amount": "0", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Input image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "images" ], "id": "bytedance-seed/seedream-5-0-flash", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "必須フィールド、素材の表現形式、またはパラメーター値が不正です", "http_status": 400, "recovery": "新しい生成リクエストを送る前に、指定されたフィールドを修正してください。", "type": "invalid_request_error" }, { "code": null, "condition": "返されたレスポンスは、操作または結果の確認が必要であることを示しています", "http_status": null, "recovery": "最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "画像の生成または編集の結果に確認が必要な場合は、元の operation_id/X-Client-Request-ID と、返された結果情報を保存してください。実際の task_id または asset_id の値を使い、メディアライブラリから自分が所有する既存の結果を取得してください。生成／編集リクエストを再送したり、operation_id からポーリング URL を組み立てたりしないでください。" }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "すべてのデータ項目を保存してください。各 b64_json をデコードするか、返された署名付き URL すべてから取得してください。実際の MIME タイプ／バイト列に応じてファイル名の拡張子を選んでください。", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "空でないUTF8のプロンプト。メーカー全体に共通する文字数上限を独自に設けることはしません。", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "プロンプトから画像を一枚生成します。", "すべてのデータ項目を保存してください。url/b64_jsonは結果のエンコード形式です。" ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "固定された内部プロバイダールーティングと厳密に一致する場合を除き、拒否されます", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "実際に返された task_id またはメディアライブラリのレコード", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "入力画像", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "生成費用の見積もり", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"