Wan 2.7 Pro のテキストから画像で resolution を 4k に設定すると何が変わりますか。

Wan 2.7 Pro のテキストから画像エンドポイントは、約 400 万画素の 2k キャンバスから約 1,600 万画素の 4k キャンバスに移行します。これは Alibaba のドキュメントが合計 4096×4096 のピクセル予算と定めているものです。それ以外のリクエスト内容は変わらず、同じプロンプト・アスペクト比・seed が適用され、呼び出しは相変わらず画像を 1 枚だけ返します。4k の画像はそのサイズで生成されるのであって 2k の結果を拡大したものではないため、フレーミングが異なる場合があります。

Wan 2.7 Pro のテキストから画像 API の料金はいくらですか。

Wan 2.7 Pro のテキストから画像は生成した画像 1 枚ごとに米ドルで課金され、解像度の階調は別の価格帯ではないため、2k と 4k は同じ単価に乗ります。現在の金額はこのページ上部の価格パネルと、送信前に返る見積もりで確認できます。

Wan 2.7 Pro のテキストから画像で構図パスをオフにできますか。

いいえ、Wan 2.7 Pro のテキストから画像エンドポイントはすべてのリクエストで構図パスを実行し、それをスキップするフィールドはありません。Alibaba のドキュメントでは、このパスは生成時間と引き換えに出力品質を高めると説明されています。標準の Wan 2.7 テキストから画像エンドポイントには enable_thinking があり、デフォルトは true で false に設定できます。

Wan 2.7 Pro のプロンプトはどれくらいの長さにできますか。

Wan 2.7 Pro は両方のエンドポイントで prompt を最大 5,000 文字まで受け付けます。これは構図、素材のリスト、ライティングの指示を 1 パスに収める余地です。特にテキストから画像では構図パスが描画前にプロンプト全体を 1 つのシーンとして読み取るため、脈絡のない単語の羅列より、つながった 1 つの説明のほうがうまく働きます。

Wan 2.7 Pro のテキストから画像は参照画像を受け付けますか。

いいえ、Wan 2.7 Pro のテキストから画像エンドポイントが受け付けるのは prompt、aspect_ratio、resolution、seed のみで、画像入力用のフィールドはありません。参照を送るにはファミリーの画像から画像エンドポイントを呼び出す必要があり、そちらは 1〜9 枚の参照画像を受け付け、固定の 2k キャンバスで動作します。特定の既存製品や人物を再現するにはそのエンドポイントが必要です。

Wan 2.7 Pro の画像を完全に再現するには seed を固定するだけで十分ですか。

いいえ、Wan 2.7 Pro で seed を固定すると、prompt と resolution が変わらない限り比較に使える程度まで描画は安定しますが、Alibaba のドキュメントは生成が確率的であり、同一の seed でも結果が変わり得ると明記しています。seed は単一の句を反復するための制御として扱い、重要なフレームは返された URL を保存しておいてください。

Wan 2.7 Pro のテキストから画像 API から画像を取得するにはどうすればよいですか。

Wan 2.7 Pro のテキストから画像は非同期なので、リクエストは task id を返し、それをポーリングするかコールバック URL と組み合わせて使います。完成した画像はプラットフォームのストレージ上の URL として届き、間に再アップロードの手順を挟まず製品から直接リンクできます。リクエストに Idempotency-Key を添えておけば、再試行で 2 つ目の課金タスクが作られるのを防げます。

Wan 2.7 Pro のテキストから画像ではプロンプトをどう構成すべきですか。

Wan 2.7 Pro は描画を始める前にレイアウトとライティングを解決するため、まずフレームと被写体から書き始め、ガラス、濡れた石、ブラッシュド加工の金属、織物といったキャンバスを裏付ける素材を挙げ、最後に光の方向を 1 つだけ添えてください。ものごとが互いにどう配置されているかを述べる文は、形容詞を積み重ねるよりレンダリングを生き延びます。

Wan 2.7 Pro Text to Image API – テキストから画像

alibaba/wan-2.7-pro/text-to-image

Wan 2.7 Pro は Alibaba の大判 text-to-image で、1 リクエスト 1 枚を 2k（約 400 万画素）か 4k（約 1,600 万画素）で返します。1:1 から 16:9・9:16 まで 7 種の比率、シード、カラーパレットに対応します。

エンドポイントごとにフィルタリングの扱いが異なります：画像編集 — 規制なし, テキストから画像 — 置き換え。

最低価格 $0.075/枚

モデルを実行 API を見る

入力

テキストから画像

プロンプト339/5000

アスペクト比

解像度

カラーパレット0/10

シード値

セーフティチェックオフ

SpicyAPI はこのモデルにセーフティチェックをかけません。プロンプトと素材はそのままモデルに渡り、出力はモデル自身が決めます。

送信と料金見積もりを有効にする前にアカウントを確認しています。

出力

実行待ち

サンプル出力

編集

レイヤー分解

動画化

{
  "model": "alibaba/wan-2.7-pro/text-to-image",
  "input": {
    "aspect_ratio": "3:4",
    "resolution": "2k",
    "prompt": "Cinematic film still, hotel room at night. A woman in a dark robe stands at a floor-to-ceiling window, city lights breaking into points across the glass; in the glass reflection a second figure stands further back in the dark room, watching. 35mm, shallow depth of field, heavy grain, sodium orange and night blue, restrained and tasteful."
  }
}

はじめに

Wan 2.7 Pro テキストから画像は、文章のアートディレクションから新しい画像を作ります。構図、被写体、光、視覚的な優先順位をブリーフから設計する必要があるときに使います。

手元の素材から Wan 2.7 Pro のモードを選ぶ

最初に手元にあるもの	モード
文章のビジュアルブリーフ	Wan 2.7 Pro テキストから画像
狙いを定めた変更が必要な画像	Wan 2.7 Pro 画像編集

主な機能とハイライト

text-to-image で 4K まで

ここの text-to-image は既定で 2k（約 400 万画素）、4k（約 1,600 万画素）まで上げられます。標準の Wan 2.7 は 2k が上限です。image-to-image は 2k で動きます。この分け方こそが要点で、4k はトリミングや印刷を前提にしたメインビジュアルを生成するときに使い、パッケージ写真の色替えには使いません。

蝋燭の光、肌、筆致

このページの 2 枚目は絵画的な室内です。逆光の屏風を背にした人物と、漆の卓に置かれた蝋燭 1 本とワイングラスが描かれています。柔らかい光の減衰、見える筆の質感、そのサイズで読める顔は、小さなキャンバスでまず崩れるものであり、まさに大きなキャンバスの用途です。

長い指示のどの一節も取りこぼしません

image-to-image では、その余力が複合的な指示に従うことへ向かいます。「この物体を取り、あの面に置き、2 枚目の光に合わせ、結露はそのままにする」といった指示です。標準版はこの種の指示のうち 1 節を落とす頻度が、こちらより高くなります。

リクエストパラメーター

Wan 2.7 Pro · Text to Image のリクエストパラメーター
パラメーター	必須	説明
`prompt`	はい	画面を書いてから、キャンバスに見合う素材を名指しします。レザー、濡れたコンクリート、ガラス、印刷された文字などです。 1 文字以上 · 5000 文字以内
`aspect_ratio`	いいえ	指定できるのは 1:1、4:3、3:4、16:9、9:16、3:2、2:3 で、既定は 1:1 です。どの比率も同じ画素予算なので、サイズのためではなく納品する切り抜きのために選んでください。 `1:1` · `4:3` · `3:4` · `16:9` · `9:16` · `3:2` · `2:3` · デフォルト値: `1:1`
`resolution`	いいえ	2k か 4k で、既定は 2k です。2k は約 400 万画素、4k はその 4 倍の約 1,600 万画素です。 `2k` · `4k` · デフォルト値: `2k`
`color_palette`	いいえ	3〜10 色の任意の配色テーマです（推奨は 8 色）。各色を #RRGGBB の 16 進コードで入力し、必要なら画像の何パーセントを占めるかも指定します。 3 件以上 · 10 件以内
`seed`	いいえ	0〜2147483647 の整数です。seed と prompt が同じなら乱数はそのままなので、1 節ずつの反復に意味が出ます。 `≥ 0` · `≤ 2147483647`

料金

$0.075 / 枚

ユースケース

制作前にビジュアルのコンセプトを探る

元画像から残すものがなく、トリミング、拡大、印刷を前提にした 1 枚ならテキストから画像を使います。既定は 2k（約 400 万画素）で、4k にすると約 1,600 万画素になります。画素数はどの比率でも同じです。

絵コンテのキービジュアルを作る

静止画を 4k でレンダリングし、4K の画像から動画のエンドポイントに冒頭のフレームとして渡します。レンダリングを決めるのは元画像ではなく動画の解像度なので、大きくシャープな静止画から始めることが、クリップの中で布や肌の質感を生かす鍵になります。

キャンペーンのビジュアル体系を作る

読める誌名と表紙コピーの入った雑誌の表紙は、文字をくっきり保つために大きな画面が必要です。3:2 か 2:3 で生成し、seed を固定して、文字がきれいに出るまでタイポグラフィの部分だけを直していきます。

主なユースケースのチュートリアルを見る

プロンプトガイドと実践のヒント

装飾より先に構図を書く

画面を書いてから、大きな画面に見合う素材を挙げます。革、濡れたコンクリート、ガラス、印刷された文字などです。構図は描く前に設計されるので、キーワードを積み上げるより、空間の関係を 1 つはっきり書くほうが効きます。

seed を固定し、1 回に 1 か所だけ変える

seed とほかの入力をすべて固定すれば乱数も保たれるので、2 回の結果の違いが、変えた部分の効果です。そのあとで、納品に必要なトリミングに合わせて aspect_ratio を変えていきます。

使い回す前に確かめる

テキストから画像は 1 リクエストにつき 1 枚を返し、seed ごとに新しい顔を作ります。特定の人物が必要なら、参照画像と画像編集のエンドポイントを使ってください。フィードやサムネイルに使うだけなら、Wan 2.7 が同じ仕事を小さな画面でこなします。

API クイックスタート

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-2.7-pro/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。

このファミリーで唯一 4k 階調を使えるエンドポイント

Wan 2.7 Pro のテキストから画像 API は、書いたプロンプトを 1 枚の画像に変換します。resolution フィールドで解像度を選べ、2k（約 400 万画素）または 4k（約 1,600 万画素）です。Alibaba のドキュメントによると 4K 出力はテキストから画像のみに許可されており、このファミリーで 4k に到達できるのはこのエンドポイントだけです。7 種類のアスペクト比が同じピクセル予算を共有し、seed を固定すれば実行間の描画を安定させられます。

プレイグラウンドを開く

解像度: 指定しない場合は 2k（約 400 万画素）。4k は約 1,600 万画素
アスペクト比: 1:1、4:3、3:4、16:9、9:16、3:2、2:3。デフォルトは 1:1 で、どれも同じ予算
1 回あたりの出力: 画像 1 枚。このエンドポイントに num_outputs フィールドはありません
プロンプト: 最大 5,000 文字
Seed: 0〜2147483647。比較実行の再現性を高めますが、完全に同一の画像を保証するものではありません
構図パス: すべてのリクエストで実行され、これをオフにするフィールドはありません

解像度: 編集エンドポイントにはない 4k 階調resolution は 2k または 4k を指定でき、Alibaba のドキュメントでは 4K 出力はテキストから画像に限定されています。ファミリーの画像から画像エンドポイントには resolution フィールドがなく常に 2k で返るため、拡大や印刷用トリミングに耐えるフレームはこのエンドポイントから直接出す必要があります。後から編集を通すと 2k に戻ります。
バッチ処理: 1 回の呼び出しにつき画像 1 枚このエンドポイントに num_outputs フィールドはないため、すべてのリクエストは画像 1 枚だけを返します。標準の Wan 2.7 テキストから画像エンドポイントは num_outputs を 1〜4 で受け付けますが、ここでバリエーションセットを作るにはプロンプトを固定したまま seed を 1 ずつずらしてリクエストをループさせます。
構図: 構図パスにオフスイッチはないWan 2.7 Pro は描画を始める前にレイアウト、オブジェクト同士の関係、ライティングを解決しますが、このエンドポイントにはその処理をスキップするフィールドがありません。Alibaba のドキュメントでは、このパスは生成時間と引き換えに出力品質を高めると説明されています。標準エンドポイントはこれをブール値の設定項目として持ち、false にできます。

Wan 2.7 Pro API が得意なこと

4k 階調が生む印刷に近いディテール

4k は約 1,600 万画素で、デフォルトの 2k の 4 倍の画素数です。これがガラスについた結露やリネン生地の織り目を、画面のクロップより大きなサイズでも読み取れる状態に保つ理由です。Alibaba のドキュメントでは 4K の仕様を、選択したアスペクト比に応じて再配分される合計 4096×4096 のピクセル予算と定めています。

4k に切り替えてもプロンプトの書き方は変わらない

2k で正しく構図が決まった静物描写のプロンプトは、resolution の値を変えるだけで 4k でもそのままレンダリングされます。大きな階調専用の構文も、追加すべき品質指定の一文も、書き直す並べ替えもありません。デフォルト階調で組んだプロンプトのライブラリは、そのまま流用できます。

7 種類の比率が 1 つの予算を分け合う
1:1、4:3、3:4、16:9、9:16、3:2、2:3 はどちらの階調でも使え、予算は形状に合わせて配分されるため、9:16 の縦長ポートレートも 1:1 の正方形と同じディテール量で仕上がります。リクエストで省略すると aspect_ratio は 1:1 になりますが、それはバナーが必要とする形状であることは稀です。
値を 1 つ動かすだけの比較実行
prompt、aspect_ratio、seed を固定し、呼び出しごとに値を 1 つだけ変えます。同じリクエストを 2k と 4k で比べる、あるいは同じ階調を 2 つの形状で比べる、といった具合です。seed は 0〜2147483647 を受け付け、Alibaba のドキュメントは生成が確率的であると明言しているため、再実行は近い結果を得る比較であって同一性の保証ではありません。
固まった 2k プロンプトはフィールド 1 つで 4k に移行
デフォルト階調で構図が正しく決まったら、同じプロンプトを resolution だけ 4k に変えて再送信すればそれで完了です。エンドポイントの切り替えや 2 つ目の実装は必要ありません。4k の呼び出しはプロンプトを大きなサイズで再度レンダリングするのであって 2k の画像を拡大するわけではないため、フレーミングがずれることがあり、出荷前に新しいフレームを確認する価値があります。

Wan 2.7 Pro はどんな人に向くか

パッケージ・印刷物制作
デフォルト階調では余裕が足りない場面
パッケージモックアップ、ポスター、大判のマーケティング用クロップは近距離で確認されるため、4k は約 1,600 万画素の作業余地を与えます。デザイナーが最終サイズのレイアウトにアセットを拡大しても、ラベルの端、生地の縫い目、素材の質感はそのまま保たれます。
大判ヒーロークロップ
1 回の生成から複数の納品クロップ
4k のソースがあれば、同じ画像からワイドバナーとよりタイトな正方形の両方を切り出す余地が残ります。最も横長のクロップに近い比率で一度生成し、他の形状は後処理で切り出せば、被写体・光・パレットをセット全体で統一できます。
固まった構図のアップグレード
プロンプトは固定、変わるのは階調だけ
被写体・フレーミング・光がまだ決まっていない間はデフォルトの 2k で反復し、出荷する回だけ resolution を 4k に上げます。プロンプトの文言は両階調でそのまま通用するため、説明を練り上げる労力を二重に払う必要はありません。
API 統合
2 つのエンドポイントが要る場面を 1 つのフィールドで済ませる
resolution はリクエストのフィールドなので、サムネイル用ジョブと印刷用アセットのジョブは同じエンドポイントに同じボディ形状で投げ、値を 1 つ変えるだけで済みます。1 つのワーカーで両方のキューを処理でき、階調の判断は呼び出し側にリクエスト時点で委ねられます。

Wan 2.7 Pro API の使い方

まずデフォルトの 2k から始める
resolution を省略したときエンドポイントが使うのは 2k で、被写体の配置・素材・光の向きといった文言を固める段階にはこの階調が向いています。構図パスが 1 つのまとまったフレームを解決できるよう、シーンは 1 つのつながった説明として書いてください。
変えるのは resolution、プロンプトではない
説明が固まったら、同じ文言のまま resolution だけを 4k にして再送信します。文言・aspect_ratio・seed はすべてそのままで、2 回の呼び出しの間で動く値は 4k だけです。
納品クロップに合わせて aspect_ratio を設定する
どの比率も同じピクセル予算から配分されるため、作業しやすい仮の形状ではなく、完成アセットが必要とする形状を選んでください。省略すると aspect_ratio は 1:1 にフォールバックし、これはポスターよりフィードタイルに向いた比率です。
階調を比較する前に seed を固定する
同じプロンプトを seed を固定したまま 2k と 4k の両方で 1 回ずつ送り、その特定のプロンプトで大きな予算が何を加えるかを確認します。Alibaba のドキュメントは、同一の seed でも画像が変わり得ると注記しています。
Idempotency-Key を送り、task id を保持する
このエンドポイントは非同期です。その id をポーリングするか、コールバック URL を登録してください。完成した画像はプラットフォームのストレージから配信されるため、ファイルを再アップロードせずその URL を製品からリンクしてください。

Wan 2.7 Pro の実際の例

4k で仕上げるパッケージモックアップ

素材の表面、材質、光の方向を明記しておくことで、製品レンダーが大きな階調に押し上げられても、ありきたりなスタジオ撮影風に流れずに済みます。

Product photography of a frosted glass perfume bottle with a brushed brass cap, standing on a slab of black marble, soft studio key light from the upper left, a faint reflection of the bottle visible in the marble surface, tight depth of field, no text, no logos

プロンプトに触れずに 2k から 4k へ押し上げたワックスシール
デフォルトの 2k で正しく構図が決まった同じプロンプトは、resolution フィールドだけを変えれば 4k でも再レンダリングされ、大きなサイズでもワックスの質感と紙の目が読み取れる状態を保ちます。
```
Overhead macro shot of a cream stationery envelope sealed with a dark burgundy wax stamp bearing a small compass motif, one loose thread of wax pooled beside the seal, a fountain pen resting diagonally across the corner, warm directional light raking across the paper grain, no text visible
```
出荷する形状のまま生成した縦長のキービジュアル
最初から aspect_ratio を 9:16 に設定しておけば、被写体は公開されるフレームの中に収まります。より横長の生成から後でクロップすると、その階調が確保した予算の一部を無駄にしてしまうためです。
```
Editorial still life photographed from above on deep green velvet, one ripe pomegranate cut in half beside a brass spoon and a scatter of seeds, hard light from the right casting a long shadow, fine water droplets on the fruit, vertical composition with empty space across the upper third, no text, no logos
```

Wan 2.7 Pro API のよくある質問

構図がまだ固まっていない間はデフォルトの 2k で反復し、出荷する回だけ resolution を 4k に切り替えてください。文言は両階調でそのまま通用するため、デフォルト階調で書いた内容が無駄になることはありません。納品するクロップに合わせて aspect_ratio を選んでください。予算は形状に合わせて配分されるため、横長のフレームは幅を得て高さを譲ります。1 つの句ずつ反復する間は seed を固定しておいてください。