API キーを取得

Black Forest Labs

FLUX.1をポーズ・深度・線画で制御。自分のLoRAも

black-forest-labs/flux-1-dev-controlnet-lora/text-to-image6クレジットから/枚 · $0.06
  • 最大1.5K
  • 1回に最大4枚
  • 自分のLoRAを読み込める
  • 画像を作成
Atelier night grayscale作例を見る

FLUX.1 Dev ControlNet LoRA について

FLUX.1 Dev ControlNet LoRA は、Black Forest Labs の FLUX.1 [dev] を Shakker Labs の ControlNet Union Pro 2.0 で誘導して画像を生成し、FLUX.1 dev 向けに学習した LoRA ファイルを最大 3 つ読み込めます。制御画像を 1 枚(ポーズのスケルトン、深度マップ、Canny またはソフトエッジの線、グレースケールの写真)送るとレイアウトが決まり、残りはプロンプトで指定します。フィルターはかかりません。

POST /jobs/createTask でモデル名に black-forest-labs/flux-1-dev-controlnet-lora/text-to-image を指定すれば呼び出せます。6クレジット/枚から($0.06)。新規アカウントには 30 クレジットが付くので、まず Playground で無料で試せます。

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

リクエストパラメーター

パラメーター必須説明
control_guidance_endいいえFraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · デフォルト: 0.8
control_guidance_startいいえFraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · デフォルト: 0
control_image_urlはいControl image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio.
control_strengthいいえHow strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · デフォルト: 0.7
guidance_scaleいいえプロンプトにどれだけ忠実に従うか。 ≥ 0 · ≤ 20 · デフォルト: 3.5
lorasいいえ自分のLoRAを読み込んで、スタイルやキャラクターを固定します。 デフォルト: []
num_outputsいいえ一度に作る枚数。 ≥ 1 · ≤ 4 · デフォルト: 1
output_formatいいえ結果のファイル形式。 jpeg · png · webp · デフォルト: jpeg
promptはいDescribe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
resolutionいいえ出力サイズ。大きいほど鮮明で、料金も上がります。 1k · 1.5k · デフォルト: 1k
seedいいえ同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647
stepsいいえステップ数を増やすと細部が増えますが、時間がかかります。 ≥ 1 · ≤ 50 · デフォルト: 28

料金

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

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

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

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

API クイックスタート

FLUX.1 Dev ControlNet LoRA API を 3 ステップで呼び出す

  1. API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
  2. リクエストを送る. POST /jobs/createTask に、model を black-forest-labs/flux-1-dev-controlnet-lora/text-to-image、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": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "num_outputs": 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 タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

FLUX.1 Dev ControlNet LoRA API についての質問

FLUX.1 Dev ControlNet LoRA API の料金はいくらですか?

FLUX.1 Dev ControlNet LoRAは6クレジット($0.06)/枚です。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのFLUX.1 Dev ControlNet LoRAのモデル名は?

POST /jobs/createTask の model フィールドに 画像を作成は black-forest-labs/flux-1-dev-controlnet-lora/text-to-image を指定します。

制御画像とは何ですか。

欲しい構造を示したマップのことです。色分けしたポーズのスケルトン、グレースケールの深度マップ、黒地に白の Canny またはソフトエッジの線、グレースケールの写真が使えます。モデルはそのレイアウトとポーズを写し取り、ほかはすべてプロンプトから取ります。

ポーズや深度は自動で検出してくれますか。

いいえ。マップそのものを送ってください。普通の写真も受け付けますが、グレースケールのマップと同じように画面を縛るため、輪郭や服の形が引き継がれます。

どの LoRA が使えますか。

FLUX.1 dev 向けに学習した LoRA で、.safetensors ファイルへの直接ダウンロードリンクとして渡します。当社のテストでは SDXL の LoRA でリクエストが失敗したため、読み込む前に LoRA のページでベースモデルを確認してください。

生成した画像は商用利用できますか。

Black Forest Labs の FLUX.1 [dev] ライセンスでは、生成した画像を個人、研究、商用の目的で使えます。読み込む各 LoRA のライセンスは作者が定めているので、モデルカードを確認してください。

FLUX.1 Dev ControlNet LoRA API の制限は?

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

コードを書かずにFLUX.1 Dev ControlNet LoRAを試せますか?

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

すべての FLUX モデル

FLUX.1 Dev LoRA にはコントロール画像がなく、自由な構図に向いています。

FLUX.1 Dev ControlNet LoRA についてさらに