Source: https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/ Canonical: https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/ Language: ja # Google: Nano Banana (Gemini 2.5 Flash Image) [Markdown](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/index.md) · [JSON](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/facts.json) ## [Google: Nano Banana (Gemini 2.5 Flash Image)](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/) Nano Banana（Gemini 2.5 Flash Image）は、テキストと画像から画像を生成・編集します。会話型の手順を使い、保持すべき詳細を示しながら、シーンの構成、選んだ要素の変更、視覚参照の組み合わせ、商品画像の洗練を行えます。 - [**Ailoot Ultra · OpenAI チャット** `POST /v1/chat/completions` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/#method-0) - [**Ailoot Ultra · 画像** `POST /v1/images/generations` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/#method-1) - [**Ailoot Ultra · Anthropic メッセージ** `POST /v1/messages` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/google-gemini-2-5-flash-image/#method-2) モデルについて この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。 Gemini 2.5 Flash ImageはNano Bananaとも呼ばれ、ビジュアル制作と会話型の画像編集に向けたGoogleのテキスト・画像モデルです。指示と任意の参照画像を受け取り、付随するテキストを伴う画像を返せます。この正確な2.5 Flash Image版は、Nano Banana 2、Nano Banana Pro、後のLite画像モデルと区別されます。有用な結果は、生成・修正されたビジュアル素材であり、一般的なGemini 2.5テキストモデルの回答ではありません。 当該モデルカードには、入力65,536トークン、出力32,768トークンと記載されています。画像と指示が入力の一部であり、返された画像やテキストが結果の一部です。ガイドの解像度表では、対応するアスペクト比の例として、1:1出力が1024×1024、3:4が864×1184、16:9が1344×768とされています。シーンを設計する前に、想定する表示の形を選んでください。後のGemini画像版の高解像度オプションを、このモデルに公開された制御として扱ってはいけません。 テキストから画像を作る場合は、被写体、動作、環境、スタイル、照明、視点を指定します。商品イラストでは、渡したビジュアルアイデンティティを使い、適切な設定で素材の詳細が明瞭に見えるよう求められます。モデルが被写体と文字のための空間を配分できるよう、画像の目的を説明してください。無関係なスタイル用語を並べるより、接写、真上からの構図、ローアングルなどの写真表現を使うと、フレーミングを明確に定義できます。 編集では、元画像を渡し、変更する部分を特定します。開発元のガイドは、要素の追加や削除、セマンティックマスキング、スタイル転写、参照を使った構図を説明しています。有用な依頼では、修正と保持する条件の両方を指定します。たとえば、商品の形、表面、ラベルを保ちながら背景を変えるという指示です。参照を組み合わせる場合は、被写体の外見、設定、スタイルなど、各入力の役割にラベルを付けてください。ガイドは、この版は入力画像3枚までで最もよく機能すると述べています。これは実用的な指針であり、無制限に矛盾する参照を組み合わせてよいという意味ではありません。 会話による洗練では、同じ被写体を保ちながら、特定の視覚的な判断を変更できます。1回に1つの関連する修正を求め、そのターンで使う元画像と採用済みの結果を保持します。何を一貫させ、何を変えてよいかを説明してください。素材の連作では、新しい独立したプロンプトが自動的に取り戻すと考えず、共通の被写体、色、視覚規則を明示します。保持の指示が成功したと扱う前に、修正画像と参照を比較してください。 画像内テキストでは、ガイドの推奨どおり、先に正確な文言を確定してから、それを含む画像を依頼します。ラベルの言語、読む順番、配置、相対的な強調を指定してください。インフォグラフィックの依頼では、各ラベルが説明する関係と、それを支える視覚要素を特定します。実際の表示サイズで、つづり、句読点、視覚的な対応を確認してください。読みやすく見える生成ラベルでも、名前、数値、意図した意味が変わっている場合があります。 モデルカードには、この版について思考、検索グラウンディング、関数呼び出し、コード実行、制約付き構造化出力は挙げられていません。音声生成やLive APIも公開していません。公開されている入力はテキストと画像なので、他のGeminiモデルの音声、動画、文書処理機能をこのモデルに付け加えてはいけません。アプリケーションは、通常の文章の返信に完成した画像素材が含まれると考えず、返されたコンテンツの各部分を明示的に扱う必要があります。 ガイドは、要求した画像枚数が必ず守られるとは限らないことと、生成画像にSynthIDが付加されることを述べています。返されたすべての画像について、構図、被写体への忠実度、物体数、正確な文言を検査してください。シーンに複数の構成要素がある場合は、その配置を明確な順序で説明し、求める外観を肯定的に表します。正確なモデル識別情報、プロンプト、参照を結果と一緒に保持してください。こうすることで、画像生成・編集の課題を確認でき、後の修正に具体的な出発点を与えられます。 実用タスク ### 実用タスク 英語の技術例 ``` Change a product photo background Using the supplied product photograph, preserve the ceramic mug's shape, handle, glaze and existing logo exactly. Replace only the background with a pale stone tabletop and soft morning side light. Keep the camera angle and mug position. Remove unrelated background clutter and add no new lettering, props or decorative marks. ``` #### 期待される結果 ``` An edited image retaining the reference mug while changing its setting and light as requested. ``` #### 結果の確認 ``` Compare the result with the reference for mug geometry, logo fidelity, camera angle and removal of clutter. ``` **Ailoot Ultra · OpenAI チャット** `POST /v1/chat/completions` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) Google /`google/gemini-2.5-flash-image` ### はじめに Nano Banana（Gemini 2.5 Flash Image）は、テキストと画像から画像を生成・編集します。会話型の手順を使い、保持すべき詳細を示しながら、シーンの構成、選んだ要素の変更、視覚参照の組み合わせ、商品画像の洗練を行えます。 対応する入力 テキスト 結果 テキスト ### Ailootで利用可能 · 入力とメソッド **Ailoot Ultra · OpenAI チャット** `POST /v1/chat/completions` 入力の種類 `text` 出力の種類 `text` 出力形式 jsonまたはSSE | フィールド | 種類 | 要件 | 値と制限 | デフォルト | | --- | --- | --- | --- | --- | | フィールド`model` | 種類`string` | 要件必須 | 値と制限 google/gemini-2.5-flash-image | デフォルト— | | フィールド`messages` | 種類`message[]` | 要件必須 | 値と制限 最小項目数: 1 | デフォルト— | | フィールド`messages[].role` | 種類`string` | 要件必須 | 値と制限 例：system, user, assistant, tool, function 条件: これらのロールはソースコードの互換型で明示されています。正確なロールの集合はモデルごとに異なります。 モデルによる | デフォルト— | | フィールド`messages[].content` | 種類`string\|content_part[]\|null` | 要件任意 | 値と制限 | デフォルト— | | フィールド`messages[].tool_calls` | 種類`tool_call[]` | 要件任意 | 値と制限 | デフォルト— | | フィールド`messages[].tool_call_id` | 種類`string` | 要件任意 | 値と制限 適用条件: role=tool。実際に返されたIDを使ってください | デフォルト— | | フィールド`messages[].name` | 種類`string` | 要件任意 | 値と制限 | デフォルト— | | フィールド`messages[].reasoning_content` | 種類`string` | 要件任意 | 値と制限 適用条件: このモデルが使用する場合は、実際に返された推論をそのまま次のリクエストへ戻してください | デフォルト— | | フィールド`messages[].reasoning_details` | 種類`object\|array` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`max_tokens` | 種類`integer` | 要件任意 | 値と制限 最小値: 1 モデルによる | デフォルト— | | フィールド`max_completion_tokens` | 種類`integer` | 要件任意 | 値と制限 最小値: 1 モデルによる | デフォルト— | | フィールド`stream` | 種類`boolean` | 要件任意 | 値と制限 | デフォルトfalse | | フィールド`stream_options.include_usage` | 種類`boolean` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`temperature` | 種類`number` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`top_p` | 種類`number` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`stop` | 種類`string\|string[]` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`tools` | 種類`function_tool[]` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`tools[].type` | 種類`string` | 要件任意 | 値と制限 function モデルによる | デフォルト— | | フィールド`tools[].function.name` | 種類`string` | 要件必須 | 値と制限 適用条件: 関数ツールの指定あり | デフォルト— | | フィールド`tools[].function.description` | 種類`string` | 要件任意 | 値と制限 | デフォルト— | | フィールド`tools[].function.parameters` | 種類`JSON_schema` | 要件任意 | 値と制限 | デフォルト— | | フィールド`tool_choice` | 種類`string\|object` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`parallel_tool_calls` | 種類`boolean` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`response_format` | 種類`object` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`reasoning_effort` | 種類`string` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`reasoning` | 種類`object` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`service_tier` | 種類`string` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`instructions` | 種類`string` | 要件任意 | 値と制限 互換性用のフィールド | デフォルト— | | フィールド`functions` | 種類`function[]` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`function_call` | 種類`string\|object` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`prompt_cache_options` | 種類`object` | 要件任意 | 値と制限 モデルによる | デフォルト— | | フィールド`modalities` | 種類`string[]` | 要件任意 | 値と制限 text | デフォルト— | | フィールド`provider` | 種類`object` | 要件任意 | 値と制限 条件: このUltraテキストルートではprovider.optionsは拒否されます | デフォルト— | | フィールド`cache_control.ttl` | 種類`string` | 要件任意 | 値と制限 条件: 実際のプロンプトキャッシュの指定箇所では1hは拒否されます | デフォルト— | 入力素材の組み合わせ **テキスト** · UTF8テキスト `messages[].content` メソッドのパラメータとライフサイクル | パラメータ | 仕様 | | --- | --- | | パラメータ`content_type` | 仕様application/json | | パラメータ`required` | 仕様model, messages | | パラメータ`material_types` | 仕様text | | パラメータ`messages` | 仕様role/content形式のメッセージ配列 | | パラメータ`file_material` | 仕様実際のUTF-8文書をテキストとしてそのまま挿入します。ファイルIDは推定しません | | パラメータ`optional_controls` | 仕様stream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | パラメータ`control_scope` | 仕様モデル固有。ユーザーの関数ツールとホスト側のツールは異なります | | パラメータ`output_modalities` | 仕様text | | パラメータ`hosted_operations` | 仕様false | | パラメータ`multimodal_input_binding` | 仕様null | ライフサイクル: `synchronous_or_streamed` 正確なモデルIDをmessagesとともに送ってください。 コンテキスト長は出力上限ではありません。 テキストファイルはテキストをそのまま提供できます。画像／音声／ファイルオブジェクトの入力には正確なバインディングが必要です。 ### 料金 料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。 高速モード 標準料金 高速モードが選択されている場合 Flex モード 標準料金 flex モードが選択されている場合 最大推論量 標準料金 推論量が最大で、調整に既定値（default）を使用する場合 明示的キャッシュの料金 無効 明示的キャッシュを要求した場合 #### Ailootの料金 #### 設定別の価格 各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。 | 設定 | 料金表 | コンテキストトークン数が次の値を超える場合 | コンテキストトークン数が次の値以下の場合 | 料金 | | --- | --- | --- | --- | --- | | 設定トークンの基本単価 | 料金表基本料金 | コンテキストトークン数が次の値を超える場合— | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン **$0.0006** / 1K トークン 出力 · 出力トークン **$0.005** / 1K トークン 入力 · キャッシュ読み取り **$0.00006** / 1K トークン 入力 · キャッシュ書き込み **$0.0001666666666666666** / 1K トークン 入力 · キャッシュ書き込み、1時間 **—** / 1K トークン 出力 · 出力画像トークン **$0.06** / 1K 画像トークン | | 設定リクエスト長に応じた料金区分 1 | 料金表— | コンテキストトークン数が次の値を超える場合0 | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン **$0.0006** / 1K トークン 出力 · 出力トークン **$0.005** / 1K トークン 入力 · キャッシュ読み取り **$0.00006** / 1K トークン 入力 · キャッシュ書き込み **$0.0001666666666666666** / 1K トークン 入力 · キャッシュ書き込み、1時間 **—** / 1K トークン | #### 参考料金の詳細 モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。 google/gemini-2.5-flash-image #### 設定別の価格 | 設定 | 課金条件 | 料金 | | --- | --- | --- | | 設定google/gemini-2.5-flash-image · 標準設定 | 課金条件デフォルト設定 | 料金 入力 · 入力 **$0.0006** / 1K トークン 出力 · 出力 **$0.06** / 1K トークン | Google: Nano Banana (Gemini 2.5 Flash Image) #### 設定別の価格 | 設定 | 課金条件 | 料金 | | --- | --- | --- | | 設定Google: Nano Banana (Gemini 2.5 Flash Image) · 標準設定 | 課金条件デフォルト設定 | 料金 入力 · 入力トークン **$0.0006** / 1K トークン 出力 · 出力トークン **$0.005** / 1K トークン 入力 · 入力画像 **$0.0006** / 1K トークン 出力 · 出力画像 **$0.06** / 1K トークン 入力 · 音声入力 **$0.002** / 1K トークン 入力 · 音声キャッシュ読み取り **$0.0002** / 1K トークン 出力 · ウェブ検索 **$0.028** 検索ごと 出力 · 推論トークン **$0.005** / 1K トークン 入力 · キャッシュ読み取り **$0.00006** / 1K トークン 入力 · キャッシュ書き込み · 5分 **≈$0.000167** / 1K トークン | Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。[金額の確保と精算の仕組み →](https://ailoot.ai/docs/ja/billing/reserve/) ### リクエスト例 #### Ailoot Ultra · OpenAI チャット curlPython SDKPythonストリーミング ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-2.5-flash-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### 結果を受け取って保存 #### Ailoot Ultra · OpenAI チャット jsonまたはSSE ##### 完了した結果をすべて保存 返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。 すべての選択肢と、その内容・ツール呼び出し・推論を保持してください。SSEでは選択肢／ツールのインデックスごとに差分を組み立て、最終的な終了理由と使用量を残します。 ##### 元のレスポンスを確認する場合 リクエスト／応答IDとヘッダーを保持してください。テキストジョブを取得する汎用URLは提供されません。 レスポンスのフィールド | フィールド | 種類 | | --- | --- | | フィールド`choices[].index` | 種類integer | | フィールド`choices[].message.content` | 種類string\|null | | フィールド`choices[].message.tool_calls` | 種類tool\_call\[\] | | フィールド`choices[].message.reasoning_content` | 種類string | | フィールド`choices[].message.reasoning_details` | 種類object\|array | | フィールド`choices[].finish_reason` | 種類string\|null | | フィールド`usage` | 種類object | エラーと次の手順 | レスポンス | 条件 | 次の手順 | | --- | --- | --- | | レスポンス400 · `invalid_request_error` | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 | ### エイリアス #### モデルのエイリアス **Ailoot Ultra** [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) #### メソッドパスのエイリアス `/v1/images` #### 関連する呼び出し用ID [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) **Ailoot Ultra · 画像** `POST /v1/images/generations` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/ja/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=images) Google /`google/gemini-2.5-flash-image` ### はじめに Nano Banana（Gemini 2.5 Flash Image）は、テキストと画像から画像を生成・編集します。会話型の手順を使い、保持すべき詳細を示しながら、シーンの構成、選んだ要素の変更、視覚参照の組み合わせ、商品画像の洗練を行えます。 対応する入力 テキスト · 画像 結果 画像 ### Ailootで利用可能 · 入力とメソッド **Ailoot Ultra · 画像** `POST /v1/images/generations` 入力の種類 `text`, `image` 出力の種類 `image` | フィールド | 種類 | 要件 | 値と制限 | デフォルト | | --- | --- | --- | --- | --- | | フィールド`model` | 種類`string` | 要件必須 | 値と制限 google/gemini-2.5-flash-image | デフォルト— | | フィールド`prompt` | 種類`string` | 要件必須 | 値と制限 最小の長さ: 1 | デフォルト— | | フィールド`aspect_ratio` | 種類`string` | 要件任意 | 値と制限 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | デフォルト— | | フィールド`n` | 種類`integer` | 要件任意 | 値と制限 最小値: 1 最大値: 1 | デフォルト— | | フィールド`input_references` | 種類`array` | 要件任意 | 値と制限 最小項目数: 0 最大項目数: 3 | デフォルト— | | フィールド`provider` | 種類`object` | 要件任意 | 値と制限 | デフォルト— | メソッドのパラメータとライフサイクル | パラメータ | 仕様 | | --- | --- | | パラメータ`content_type` | 仕様application/json | | パラメータ`required` | 仕様model, prompt | | パラメータ`material_types` | 仕様text, image | ライフサイクル: `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}` ### 料金 ##### 最終料金の計算方法 表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。 料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。 高速モード 未指定 高速モードが選択されている場合 Flex モード 未指定 flex モードが選択されている場合 最大推論量 未指定 推論量が最大で、調整に既定値（default）を使用する場合 #### 比較用の推定料金 #### 設定別の価格 各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。 | 設定 | 料金表 | 予測数量 | 料金 | | --- | --- | --- | --- | | 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 料金 入力 · 入力トークン · 比較専用の見積もり **—** / 1K トークン 出力 · 出力トークン · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり **—** / 1K トークン | | 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 料金 出力 · 推定生成コスト · 比較専用の見積もり **$0.24576** 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 | Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。[金額の確保と精算の仕組み →](https://ailoot.ai/docs/ja/billing/reserve/) ### リクエスト例 #### Ailoot Ultra · 画像 curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-2.5-flash-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"