Recraft V4 Styles Proは、Recraftの専用V4 Stylesファミリーに属する高解像度ラスター画像モデルです。テキストの制作指示と、参照画像または保存済みスタイルで与える視覚スタイルから、新しい画像を制作します。描画、質感、構図の特徴を素材間で引き継ぐ必要があるキャンペーン、ブランドイラスト、画像シリーズを想定しています。スタイル入力がモデルの必須条件ではなく任意であるRecraft V4 ProやV4.1 Proとは別のモデルです。
Styles Proは、ロスレスWebPまたはPNG形式で2Kのラスター画像を出力します。開発元のサイズ表では正方形は2048 × 2048ピクセル、16:9は2688 × 1536で、ほかの対応比率にも固有の寸法があります。Proの大きな出力は、精細なキャンペーンビジュアルや大きなレイアウトに役立ちます。ベクター版は代わりにSVGを生成し、固定のピクセル寸法を持ちません。編集可能なベクターファイルが必要な場合は、このラスター版Proを選ばないでください。
Stylesファミリーでは、すべての生成にスタイルが必要です。PNG、JPG、WebPの参照画像を1～10枚提供するか、互換性のある保存済みスタイルを再利用します。スタイル識別子と新しい参照画像は代替の入力であり、併用しません。開発元のワークフローでは参照画像の合計64 MB以下、各ファイル20 MB未満が条件です。スタイル作成に、利用者自身が行う学習工程は必要ありません。明確な参照1枚でも一貫した方向性を定められます。複数枚を使う場合は、異なる見た目を競合させず、すでに同じ視覚表現を共有している参照を選びます。各参照画像は短辺256ピクセル以上、長辺4,096ピクセル以下、総解像度16メガピクセル以下である必要があります。
標準の柔軟なスタイルマッチングでは、参照を緩やかに解釈できます。精密なマッチングは、描画、パレット、構図、照明により忠実に従います。参照は視覚表現を定めますが、テキストの制作指示には新しい被写体、動作、シーン、フレーミングが必要です。精細な商品キャンペーンなら、淡い石の面に置いたガラス瓶、斜めからの視点、柔らかな側光、見出し用の明確な余白を指定し、写真の表現は参照に担わせます。
モデルは最大10,000文字のプロンプト、優先色、背景色、ランダムシードに対応します。記載された生成ワークフローでは1～6枚の画像を返せます。使える制御は旧Recraft版と異なり、プリセットのスタイル名、negative_prompt、text_layoutに対応しません。またStylesファミリーは画像から画像への変換やインペインティングを提供しません。参照はスタイルの供給源であり、マスクでも、既存写真の各ピクセルを維持するための指示でもありません。
明瞭で十分な細部のある参照素材を準備し、シリーズ制作では同じスタイルを再利用します。出力が単調になったら、無関係な参照を加えるのではなく、テキストの指示で被写体、ポーズ、カメラアングル、シーンを変えます。参照と出力の色の完全一致は保証されません。優先色の指定は方向性を示すもので、色校正の結果を保証しません。完成したキャンペーン素材は実際の表示・印刷サイズで評価し、被写体、使える余白、視覚表現が制作指示と合うかを確認します。
", "aboutText": "Recraft V4 Styles Proは、Recraftの専用V4 Stylesファミリーに属する高解像度ラスター画像モデルです。テキストの制作指示と、参照画像または保存済みスタイルで与える視覚スタイルから、新しい画像を制作します。描画、質感、構図の特徴を素材間で引き継ぐ必要があるキャンペーン、ブランドイラスト、画像シリーズを想定しています。スタイル入力がモデルの必須条件ではなく任意であるRecraft V4 ProやV4.1 Proとは別のモデルです。\n\nStyles Proは、ロスレスWebPまたはPNG形式で2Kのラスター画像を出力します。開発元のサイズ表では正方形は2048 × 2048ピクセル、16:9は2688 × 1536で、ほかの対応比率にも固有の寸法があります。Proの大きな出力は、精細なキャンペーンビジュアルや大きなレイアウトに役立ちます。ベクター版は代わりにSVGを生成し、固定のピクセル寸法を持ちません。編集可能なベクターファイルが必要な場合は、このラスター版Proを選ばないでください。\n\nStylesファミリーでは、すべての生成にスタイルが必要です。PNG、JPG、WebPの参照画像を1～10枚提供するか、互換性のある保存済みスタイルを再利用します。スタイル識別子と新しい参照画像は代替の入力であり、併用しません。開発元のワークフローでは参照画像の合計64 MB以下、各ファイル20 MB未満が条件です。スタイル作成に、利用者自身が行う学習工程は必要ありません。明確な参照1枚でも一貫した方向性を定められます。複数枚を使う場合は、異なる見た目を競合させず、すでに同じ視覚表現を共有している参照を選びます。各参照画像は短辺256ピクセル以上、長辺4,096ピクセル以下、総解像度16メガピクセル以下である必要があります。\n\n標準の柔軟なスタイルマッチングでは、参照を緩やかに解釈できます。精密なマッチングは、描画、パレット、構図、照明により忠実に従います。参照は視覚表現を定めますが、テキストの制作指示には新しい被写体、動作、シーン、フレーミングが必要です。精細な商品キャンペーンなら、淡い石の面に置いたガラス瓶、斜めからの視点、柔らかな側光、見出し用の明確な余白を指定し、写真の表現は参照に担わせます。\n\nモデルは最大10,000文字のプロンプト、優先色、背景色、ランダムシードに対応します。記載された生成ワークフローでは1～6枚の画像を返せます。使える制御は旧Recraft版と異なり、プリセットのスタイル名、negative_prompt、text_layoutに対応しません。またStylesファミリーは画像から画像への変換やインペインティングを提供しません。参照はスタイルの供給源であり、マスクでも、既存写真の各ピクセルを維持するための指示でもありません。\n\n明瞭で十分な細部のある参照素材を準備し、シリーズ制作では同じスタイルを再利用します。出力が単調になったら、無関係な参照を加えるのではなく、テキストの指示で被写体、ポーズ、カメラアングル、シーンを変えます。参照と出力の色の完全一致は保証されません。優先色の指定は方向性を示すもので、色校正の結果を保証しません。完成したキャンペーン素材は実際の表示・印刷サイズで評価し、被写体、使える余白、視覚表現が制作指示と合うかを確認します。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7b8895b1c9035812af159e95a806184951bab3a463431b7f8e692ee5fa5c95bb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ja", "methods": [ { "html": "recraft/recraft-v4-styles-proRecraft V4 Styles Proは、参照で定めた視覚スタイルの2Kラスター画像を生成します。被写体が変わっても質感、描画、パレット、全体の見た目をそろえる必要がある、精細なキャンペーン素材や画像シリーズに向いています。
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Recraft V4 Styles Proは、Recraftの専用V4 Stylesファミリーに属する高解像度ラスター画像モデルです。テキストの制作指示と、参照画像または保存済みスタイルで与える視覚スタイルから、新しい画像を制作します。描画、質感、構図の特徴を素材間で引き継ぐ必要があるキャンペーン、ブランドイラスト、画像シリーズを想定しています。スタイル入力がモデルの必須条件ではなく任意であるRecraft V4 ProやV4.1 Proとは別のモデルです。
Styles Proは、ロスレスWebPまたはPNG形式で2Kのラスター画像を出力します。開発元のサイズ表では正方形は2048 × 2048ピクセル、16:9は2688 × 1536で、ほかの対応比率にも固有の寸法があります。Proの大きな出力は、精細なキャンペーンビジュアルや大きなレイアウトに役立ちます。ベクター版は代わりにSVGを生成し、固定のピクセル寸法を持ちません。編集可能なベクターファイルが必要な場合は、このラスター版Proを選ばないでください。
Stylesファミリーでは、すべての生成にスタイルが必要です。PNG、JPG、WebPの参照画像を1～10枚提供するか、互換性のある保存済みスタイルを再利用します。スタイル識別子と新しい参照画像は代替の入力であり、併用しません。開発元のワークフローでは参照画像の合計64 MB以下、各ファイル20 MB未満が条件です。スタイル作成に、利用者自身が行う学習工程は必要ありません。明確な参照1枚でも一貫した方向性を定められます。複数枚を使う場合は、異なる見た目を競合させず、すでに同じ視覚表現を共有している参照を選びます。各参照画像は短辺256ピクセル以上、長辺4,096ピクセル以下、総解像度16メガピクセル以下である必要があります。
標準の柔軟なスタイルマッチングでは、参照を緩やかに解釈できます。精密なマッチングは、描画、パレット、構図、照明により忠実に従います。参照は視覚表現を定めますが、テキストの制作指示には新しい被写体、動作、シーン、フレーミングが必要です。精細な商品キャンペーンなら、淡い石の面に置いたガラス瓶、斜めからの視点、柔らかな側光、見出し用の明確な余白を指定し、写真の表現は参照に担わせます。
モデルは最大10,000文字のプロンプト、優先色、背景色、ランダムシードに対応します。記載された生成ワークフローでは1～6枚の画像を返せます。使える制御は旧Recraft版と異なり、プリセットのスタイル名、negative_prompt、text_layoutに対応しません。またStylesファミリーは画像から画像への変換やインペインティングを提供しません。参照はスタイルの供給源であり、マスクでも、既存写真の各ピクセルを維持するための指示でもありません。
明瞭で十分な細部のある参照素材を準備し、シリーズ制作では同じスタイルを再利用します。出力が単調になったら、無関係な参照を加えるのではなく、テキストの指示で被写体、ポーズ、カメラアングル、シーンを変えます。参照と出力の色の完全一致は保証されません。優先色の指定は方向性を示すもので、色校正の結果を保証しません。完成したキャンペーン素材は実際の表示・印刷サイズで評価し、被写体、使える余白、視覚表現が制作指示と合うかを確認します。
POST /v1/images/generationstext, imageimage| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 recraft/recraft-v4-styles-pro | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 最小の長さ: 1 | デフォルト— |
フィールドaspect_ratio | 種類string | 要件任意 | 値と制限 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto | デフォルト— |
フィールドn | 種類integer | 要件任意 | 値と制限 最小値: 1 最大値: 6 | デフォルト— |
フィールドinput_references | 種類array | 要件任意 | 値と制限 最小項目数: 1 最大項目数: 10 | デフォルト— |
フィールド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}
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金単位 | 課金条件 | 料金 |
|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金単位— | 課金条件— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定入力参照 | 料金表— | 予測数量— | 課金単位リクエストあたり | 課金条件スタイル参照を使って生成する場合のスタイル作成料金。リクエストごとに一度、出力画像の料金に加算されます。 | 料金 入力 · 入力参照 · 比較専用の見積もり $0.01 リクエストあたり |
| 設定出力画像 | 料金表— | 予測数量— | 課金単位出力画像あたり | 課金条件— | 料金 出力 · 出力画像 · 比較専用の見積もり $0.2 出力画像あたり |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金単位— | 課金条件— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.2 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
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={'model': 'recraft/recraft-v4-styles-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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返された画像をすべてダウンロードするか、Base64の内容を保存
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n完了した画像をすべて保存してください。返された各URLから取得するか、Base64の内容をデコードしてください。
レスポンスとヘッダーの全体、実際の出力すべて、最初に返された識別子、使用量フィールドすべてを保存してください。作成リクエストを再送せずに、元の操作を復旧してください。
照合のため、返された X-Client-Request-ID を保存してください。実際に返された task_id/asset_id の値、または自分が所有するメディアライブラリだけを使って読み取ってください。操作 ID からタスクの URL を組み立てたり、作成リクエストを再送したりしないでください。
| フィールド | 種類 |
|---|---|
フィールドcreated | 種類 |
フィールドdata[].url | 種類 |
フィールドdata[].b64_json | 種類 |
フィールドusage | 種類 |
Ailoot Ultra recraft/recraft-v4-styles-pro
/v1/images