はじめに
FLUX.1 Schnell LoRA テキストから画像 は、Black Forest Labs が少ないサンプリングステップで動くよう蒸留した 120 億パラメーターのモデル FLUX.1 [schnell] で、文章のプロンプトから画像を 1 枚作ります。自前の LoRA ファイルを最大 3 つ読み込めます。ウェイトは Apache-2.0 です。FLUX.1 [dev] の LoRA も読み込め、当社のテストではスタイル LoRA が scale 1 で効きました。プラットフォームはプロンプト、ウェイト、画像のいずれにもコンテンツフィルターを加えません。
手元の素材からモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 文章で書いた説明 | FLUX.1 Schnell LoRA テキストから画像 |
| スタイルを変えたい、またはインペイントしたい画像 | FLUX.1 Schnell LoRA 画像編集 |
主な機能とハイライト
FLUX の LoRA を通常の scale で
FLUX.1 [dev] 向けに作られた LoRA がここで読み込まれ、当社のテストでは scale 1 で効きました。イラスト LoRA はフェンシングホールの場面全体をそのスタイルで描き直し、Midjourney 風 LoRA は洗練されたエディトリアルな仕上がりを与えました。
3 つ同時に
1 リクエストに LoRA を最大 3 つ、それぞれ 0〜4 の scale で。当社のテストでは、0.8、0.6、0.3 で 3 つ重ねたリクエストも通常どおり動きました。
9 種類の形
約 100 万画素の 9 種類のアスペクト比を、21:9（1536 x 640）から 9:21 まで。当社のテストでは、どれも指定どおりのサイズで返りました。
ウェイトの有無を問わず規制なし
何もフィルターされません。モデル単体では軽めと中程度のレベルを出力しました。フィルターなしの FLUX.1 [dev] LoRA を使うと、女性にも男性にも強めのレベルを出力しました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、服装、場所、光、レンズを文章で書きます。LoRA のトリガーフレーズは先頭に置いてください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 約 100 万画素の 9 種類の形で、21:9（1536 x 640）から 9:21 まで。既定は 1:1 です。 |
loras | いいえ | FLUX.1 [dev] または FLUX.1 [schnell] 向けに学習した {path, scale} を最大 3 つ。scale は 0〜4 で、既定は 1。 デフォルト値: |
output_format | いいえ | 既定は JPEG で、PNG か WebP も選べます。形式で料金は変わりません。 |
seed | いいえ | LoRA や 1 文を 1 つずつ変える間、画像のセットを比べられる状態に保ちます。seed を指定しなければランダムになります。 |
料金
$0.006 / 枚
1 枚ごとに課金されます。アスペクト比、出力形式、LoRA の読み込みで料金は変わりません。
ユースケース
1 枚あたり低価格のスタイルシリーズ
スタイル LoRA を 1 つ読み込み、トリガーフレーズを先頭に置いて、プロンプトのリストを回します。どの画像も同じルックで、料金も同じ一律です。
大きく回す前の LoRA テスト
FLUX の LoRA、そのトリガー、scale をここで試し、うまくいった設定をより遅いベースに持っていけます。
規制なしの静止画
フィルターなしの LoRA は審査なしで読み込まれ、入力でも出力でも何もフィルターされません。
プロンプトガイドと実践のヒント
ガイダンスもステップ数の指定もない
モデルはそれらなしで動くよう蒸留されているため、このエンドポイントにはどちらもありません。プロンプト、LoRA、その scale で導いてください。
文章で書く
被写体、服装、場所、光、レンズを描写します。名指しした硬い光（「a single hard top light」「chalk dust in the beam」）はよく描かれます。
LoRA は 1 から始める
ここではスタイル LoRA が scale 1 で効きました。同じ seed で scale 0 と比べ、2 枚が一致するならファイルは効いていません。
サインに注意
イラスト LoRA の中には、seed によって隅に小さな描き込みのサインを入れるものがあります。出たら別の seed を試してください。
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": "black-forest-labs/flux-1-schnell-lora/text-to-image",
"input": {
"aspect_ratio": "1:1",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 リファレンスを参照してください。
