alibaba/z-image-turbo-lora/edit2クレジットから /枚· 画像を編集

Z-Image Turbo LoRA image-to-image は、元画像 1 枚を自前の LoRA 3 つまででスタイル変換します。強度 0〜1(既定 0.8)で元からの変化量を決め、出力は元画像の比率を保ちます。

POST /jobs/createTask でモデル名に alibaba/z-image-turbo-lora/edit を指定すれば呼び出せます。2クレジット/枚から($0.02)。新規アカウントには 30 クレジットが付くので、まず Playground で無料で試せます。

  • 画像を作成
  • 画像を編集
  • 最大1.5K
  • 9種類のアスペクト比
  • 自分のLoRAを読み込める

このガイドは今のところ英語のみです。 →

リクエストパラメーター

パラメーター必須説明
image_urlはい出発点になる画像。
lorasいいえ自分のLoRAを読み込んで、スタイルやキャラクターを固定します。 デフォルト: []
output_formatいいえ結果のファイル形式。 jpeg · png · webp · デフォルト: jpeg
promptはいDescribe the image you want back, not just the change.
resolutionいいえ出力サイズ。大きいほど鮮明で、料金も上がります。 1k · 1.5k · デフォルト: 1k
seedいいえ同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647
strengthいいえ元の素材からどこまで離れてよいか。 ≥ 0 · ≤ 1 · デフォルト: 0.8

料金

料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。

オプションクレジット /枚≈ USD
標準1.8$0.018

タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 2クレジット/枚($0.02)です。

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

Z-Image Turbo LoRA API を 3 ステップで呼び出す

  1. API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
  2. リクエストを送る. POST /jobs/createTask に、model を alibaba/z-image-turbo-lora/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
  3. 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/z-image-turbo-lora/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Z-Image Turbo LoRA API についての質問

Z-Image Turbo LoRA API の料金はいくらですか?

Z-Image Turbo LoRAの最安は画像を編集で、2クレジット($0.02)/枚からです。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのZ-Image Turbo LoRAのモデル名は?

POST /jobs/createTask の model フィールドに 画像を作成は alibaba/z-image-turbo-lora/text-to-image;画像を編集は alibaba/z-image-turbo-lora/edit を指定します。

どの LoRA が使えますか。

Z-Image Turbo 向けに学習したファイルです。Hugging Face には数百件が公開されているので、.safetensors ファイルの直接ダウンロードリンクを渡してください。FLUX、SDXL、Qwen-Image 向けの LoRA は流用できません。

画像から画像の strength は何をしますか。

結果が元画像からどこまで離れてよいかを決めます。既定の 0.8 はレイアウトとポーズを保ったままスタイルを変え、0.6 では変化は控えめ、1 に近い値では元画像はおおまかな目安にとどまります。

複数の LoRA を重ねられますか。

重ねられます。1 リクエストに 3 つまで、それぞれ個別の scale を指定できます。追加する LoRA は 0.5 前後から始めてください。スタイル LoRA を 2 つともフル強度で使うと、たいてい競り合います。

Z-Image Turbo LoRA API の制限は?

解像度:1K · 1.5K;プロンプトの長さ(文字):5,000;アップロードの上限:10 MB。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにZ-Image Turbo LoRAを試せますか?

はい。Playground なら API キーなしで、PopNow のクレジットでZ-Image Turbo LoRAを実行でき、実行ごとに対応するコードが表示されます。

すべての Z-Image モデル

Z-Image Base LoRA は、それ用に学習した LoRA のために、遅いフルのベースモデルを動かします。

Z-Image Turbo LoRA についてさらに