リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · デフォルト: 1:1 |
loras | いいえ | 自分のLoRAを読み込んで、スタイルやキャラクターを固定します。 デフォルト: [] |
output_format | いいえ | 結果のファイル形式。 jpeg · png · webp · デフォルト: jpeg |
prompt | はい | Describe the subject, composition and lighting. If a LoRA has a trigger word, put it first. |
seed | いいえ | 同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647 |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(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/text-to-image、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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"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 の制限は?
アスペクト比:1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにZ-Image Turbo LoRAを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでZ-Image Turbo LoRAを実行でき、実行ごとに対応するコードが表示されます。
すべての Z-Image モデル
Z-Image Base LoRA は、それ用に学習した LoRA のために、遅いフルのベースモデルを動かします。


