リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
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 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を alibaba/z-image-turbo-lora/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク 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 のために、遅いフルのベースモデルを動かします。


