Image 提供： Black Forest Labs

Flux 2 Dev API

実験用に公開された Flux 2 のウェイト。

Flux 2 Dev を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。

APIキーを取得 Apiframe Studioで使う Flux 2 Dev APIドキュメントを見る

model: "flux-2-dev"

Flux 2 Dev photorealistic hero banner of a hiking backpack on a mossy rock in morning mist with soft natural light

Flux 2 Dev の特長

1:1, 3:4, 4:3 を含む 5 種類のアスペクト比に対応。
画像から画像への編集と参照画像に対応。
高速処理 — 1回の生成あたり平均約10秒。
Black Forest Labs のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。

Flux 2 Dev で作成

Apiframeの Flux 2 Dev API で生成した出力例です。

Flux 2 Dev three product renders of the same sneaker in white, black, and red with a consistent angle and lighting — Three product renders of the same sneaker in white, black, and red, consistent angle and lighting.

Flux 2 Dev 3D concept art frame of a futuristic train station interior with warm lighting and detailed reflections — A 3D concept art frame of a futuristic train station interior, warm lighting, detailed reflections.

Flux 2 Dev cozy reading nook with a velvet armchair, a stack of books, and a warm lamp in late afternoon light — A cozy reading nook with a velvet armchair, a stack of books, and a warm lamp, late afternoon light.

Flux 2 Dev ad creative for a cold brew can on crushed ice with condensation droplets and bright studio lighting — An ad creative for a cold brew can on crushed ice, condensation droplets, bright studio lighting.

Flux 2 Dev consistent mascot shown waving, sitting at a desk, and giving a thumbs up in a unified style — Using these reference images of our mascot, show it waving, sitting at a desk, and giving a thumbs up, in a consistent style.

概要

エンドポイント: POST /v2/images/generate
モデルID: flux-2-dev
パラメータキー: fluxParams
モダリティ: 画像
プロバイダー: Black Forest Labs
平均完了時間: ~10s

機能

アスペクト比1:1, 3:4, 4:3, 9:16, 16:9

画像入力対応

平均時間~10秒

クイックスタート

APIキーを添えて POST /v2/images/generate に1回リクエストを送るだけで Flux 2 Dev による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "flux-2-dev",
        "fluxParams": {
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "steps": 28,
            "guidance": 3
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "flux-2-dev",
        "fluxParams": {
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "steps": 28,
            "guidance": 3
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "flux-2-dev",
    "fluxParams": {
      "image_prompt": "https://example.com/input.jpg",
      "image_prompt_strength": 0.5,
      "steps": 28,
      "guidance": 3
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

レスポンスとジョブのライフサイクル

生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする（または webhook_url を指定する）と、result フィールドに出力URLが格納されます。

1. 送信レスポンス (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 結果をポーリング

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

入力スキーマ

Flux 2 Dev エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
prompt	string	必須	—	—	生成する内容のテキスト説明。
model	string	必須	"flux-2-dev"	"flux-2-dev"	このエンドポイントのモデル識別子。
fluxParams.image_prompt	string (URL)	任意	—	—	Reference image (URL)
fluxParams.image_prompt_strength	number	任意	0.5	min 0, max 1, step 0.05	How closely to follow the reference image (0–1).
fluxParams.steps	number	任意	28	min 1, max 50, step 1	Steps
fluxParams.guidance	number	任意	3	min 1.5, max 10, step 0.1	How strictly to follow the prompt.
fluxParams.output_format	string	任意	"jpg"	"jpg", "png", "webp"	Output format
fluxParams.output_quality	number	任意	90	min 0, max 100, step 1	Output quality
fluxParams.prompt_upsampling	boolean	任意	false	—	Let the model rewrite your prompt for better quality.
fluxParams.go_fast	boolean	任意	false	—	Go fast
fluxParams.seed	number	任意	—	step 1	Reuse a number to reproduce the same result.

よくある質問

Flux 2 Dev APIに関するよくある質問をまとめました。

Flux 2 Dev の API はありますか？

はい。Apiframe は単一の REST エンドポイント（`POST /v2/images/generate`、`model: "flux-2-dev"`）で Flux 2 Dev を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Black Forest Labs の個別アカウントは不要です。

Flux 2 Dev API の料金はいくらですか？

Flux 2 Dev は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。

Flux 2 Dev API はどのように呼び出しますか？

`X-API-Key` と、`model: "flux-2-dev"` を含む JSON ボディを添えて `/v2/images/generate` に POST リクエストを送ります。レスポンスで返る `jobId` を `GET /v2/jobs/{id}` でポーリングするか、Webhook で結果を受け取ります。

Flux 2 Dev はどんなパラメータに対応していますか？

Flux 2 Dev は、共通の `prompt`・`webhook_url` に加えて、`fluxParams` の下にネストされた 9 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。

解決しませんでしたか？

サポートに問い合わせる Discordに参加

Flux 2 Dev API で開発を始めよう

APIキーを取得すれば数分で Flux 2 Dev を統合できます — 従量課金。

無料クレジットですぐに開始

すべてのモデルを1つのAPIで

Webhook・SDK・冪等性に対応

プロバイダーのアカウント不要

無料で始めるドキュメントを見る

ご質問はありますか？ Discordに参加または営業に問い合わせる。