JA ▾
API キーを取得

Flux APIキー:その正体とテキストAPIの位置づけ

Flux APIキーは画像生成サービスの認証情報であり、当サイトでは販売していません。当サイトが販売するのは、画像モデルに渡すプロンプトを作成・拡張できるホスト型テキストLLM API用の別のキーです。

更新

2つの別々のキー:1つは画像フレーム用、もう1つはチャット用。2つの別々のAPI

主要ポイント

  • Flux画像サービスのAPIキーとテキストLLM APIのAPIキーは別物で、それぞれ別のプロバイダから発行されます。
  • このサイトはテキストのみ対応で、画像・音声・動画の生成は行いません。また、画像モデルベンダーが運営しているわけではありません。
  • プロンプト作成はテキストタスクでありトークン課金のため、画像キーと併用してテキストキーが役立ちます。
  • OpenAI互換クライアントのBase URLとAPIキーを変更するだけで利用を開始でき、試用クレジットで最初のテストが可能です。

Fluxキーとして通常意味されるもの

Fluxはテキストから画像を生成するモデルファミリーの名前です。検索ボックスにflux api keyと入力する人は、通常、コードが画像モデルをホストするサービスにプロンプトを送信し、画像を取得するための認証情報を求めています。その認証情報は、選択した画像エンドポイントを運営する会社から発行されます。それはアカウント、請求、利用規約に紐付いています。

このフレーズはわずかに異なる方法で使用されることがあり、キーを貼り付ける前にそれらを整理しておくと役立ちます:

  • Fluxモデルを提供する画像ホストからのキーで、画像を返すリクエストで使用されます。
  • ローカルまたはセルフホスト環境用のキーで、トークンを自分で生成し、何もマシン外に出ません。
  • パイプライン内の他のツール用のキー(例:プロンプトを作成するテキストモデル)。プロジェクト名がFluxであるため、Fluxと呼ばれているだけです。

最初の2つは画像を生成します。3つ目がこのサイトの基盤です。私たちはホストされたOpenAI互換のLLM APIを実行しており、ここで取得したキーはこのAPIに対してのみ機能し、他のものに対しては機能しません。

画像キーがチャットモデルを呼び出せない理由

2種類のキーは見た目が似ており、どちらもAuthorizationヘッダーで送信する長い文字列ですが、異なる扉を開きます。画像プロバイダのキーは画像プロバイダによって検証されます。チャットエンドポイントに送信すると認証エラーになり、逆もまた同様です:当サイトからのキーを画像ホストに送信するとエラーが返されます。

リクエストボディも異なります。画像呼び出しには通常、プロンプト、寸法、シード、画像の数が含まれます。チャット呼び出しには、ロール付きメッセージのリストが含まれ、テキストを返します。共通のスキーマがないため、それらの間で変換するものは何もありません。画像ホストに対して機能するスクリプトがある場合は、そのスクリプトとキーをそのまま維持してください。テキスト呼び出しをその前に別のステップとして追加します。

このサービスが行わないこと

期待値を明確にするため:ここでのAPIはテキストのみです。画像、音声、動画の生成は行わず、埋め込みの作成もファインチューニングの提供もありません。任意のモデルベンダの公式APIではなく、ベンダ間のルーターでもありません。合法的な成人向け利用でコンテンツ拒否なしで回答するよう調整された1つのオープンウェイトモデルを提供し、独立したプロバイダが運営しています。渡すモデルIDはuncensoredです。

画像キーの隣でテキストAPIが果たす役割

プロンプトの作成が明らかな接点です。画像モデルは、特定の構造化された説明(被写体、設定、レンズ、照明、色、ムード)に良く応答します。ほとんどの人はそれらを直接記述し、悪い結果の後でそれを書き直します。テキストモデルは下書きを作成したり、3語のアイデアを完全な説明に展開したり、あなたがコーヒーを取りに行く間にテーマに関する20種類のバリエーションを生成したりできます。

よく適合するいくつかのタスク:

  • 拡張。 システムメッセージで1回設定したスタイルで、短いアイデアを詳細なプロンプトに変換します。
  • バリエーション。 1つの被写体について10の異なるアプローチをリクエストし、スクリプトでループ処理できるJSONリストとして返します。
  • クリーンアップ。 カスタマーが書いた雑なプロンプトを、画像モデルがより扱いやすい形に書き直します。
  • スクリプトとキャプション。 画像の隣に配置されるナレーション、ショットリスト、またはキャプションを作成します。

ここで使用するモデルはデフォルトで拒否しないため、他のホストモデルがしばしば拒否するフィクション、キャラクターデザイン、大人向けのテーマに適しています。ただし、利用が合法であり、成人が対象であることが条件です。どこでも適用される1つの厳格な制限があります:未成年者を含む性的コンテンツは禁止です。そのようなリクエストは、いかなる形でもサポートするものではありません。

1分以内の最初の呼び出し

ベースURLとキーを入れ替えれば、任意のOpenAI SDKまたはHTTPクライアントが機能します。チャットのエンドポイントはPOST /v1/chat/completionsで、GET /v1/modelsはモデルをリストします。以下にcurlとPythonでの同じリクエストを示します。

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

返ってくる文字列はすべて画像サービスに渡し、そのサービスの独自のキーを使用します。2つは互いに接触しません。ストリーミング、ツール呼び出し、JSONモードを含むパラメータの完全なリストについては、APIドキュメントを参照してください。

両方のキーが必要ですか?

構築しているものによります。以下の表は迅速な判断に役立ちます。

あなたの目標画像キーテキストキー
自分で書いたプロンプトから画像を生成はいなし
モデルが作成または拡張したプロンプトから画像を生成はいはい
ストーリー、会話、スクリプトのみを作成なしはい
成人向けのチャットまたはロールプレイアプリを構築なしはい
数百のプロンプト変種を一括生成オプションはい

自分のプロンプトのみを入力し、それに満足している場合、テキストキーはほとんど追加価値を持ちません。午後中プロンプトを書き直している場合や、ボリュームが必要な場合は、コストに見合う価値をすぐに生み出します。また、メディアステップの前にテキストステップという同じアイデアに従うビデオワークフローでのテキストLLMの使用に関する短いウォークスルーもあります。

キーを混同することで生じるミス

2つのサービス環境でのほとんどの問題は、何を探すかを知っていれば、小さく見つけやすいものです。

  • 誤ったベースURL。 クライアントがまだ古いホストを指している場合、新しいキーは拒否されます。ベースURLが/v1で終わっていることと、上記の例と一致していることを確認してください。
  • モデル名が間違っています。ここで使用できるモデルIDはuncensoredのみです。画像モデルの名前を指定するとエラーが返されます。このAPIにはそのようなモデルが存在しないためです。
  • 1つの環境変数内のキー。 各サービスに独自の変数を与えます(例:TEXT_API_KEYとIMAGE_API_KEY)。1つの名前を共有すると、キーが誤ったホストに送信される原因になります。
  • 返信に画像を期待する。 返信はchoices[0].message.contentのプレーンテキストです。画像が必要な場合、そのテキストを2回目の呼び出しとして画像サービスに送信する必要があります。
  • 429を無視する。 8つの同時リクエストを超えるバーストは、エラーコードconcurrencyで429を返し、1分あたり300リクエストを超えるとrate_limitedになります。少し待機して再試行してください。ストリーミングリクエストはストリームが終了するまでスロットを保持するため、読み込まなくなったストリームは閉じてください。

トライアルキーの上限は低くなります:同時リクエスト2、1分あたり60。これは手動でプロンプト作成ステップをテストするには十分ですが、大量のバッチはチャージされたキーを待つ必要があります。

プロンプト作成のコスト

課金はトークン単位で前払い制です:入力トークン100万トークンあたり$0.15、出力トークン1Mあたり$0.50で、サブスクリプションはありません。プロンプトジョブは小さく、金額も少額になります。システムメッセージとアイデア(入力)が600トークン、拡張されたプロンプト(出力)が250トークンのリクエストを例に取ります。入力のコストは600 / 1,000,000 x $0.15 = $0.00009です。出力のコストは250 / 1,000,000 x $0.50 = $0.000125です。1つのリクエストで$0.000215がかかります。

したがって、1,000件のそのようなリクエストのバッチは約$0.215かかります。サインアップ後にキーページでワンクリックで受け取ることができる$0.50の無料トライアルクレジットは、それらの約2,300件をカバーします(0.50 / 0.000215)。カードは必要なく、7日間有効です。失敗または拒否されたリクエストには課金されず、後で追加したクレジットは期限切れになりません。詳細は料金ページにあります。

テキストキーの取得

Google、またはメールとパスワードでサインアップし、APIキーページを開きます。まずテストしたい場合は、そこで無料トライアルクレジットを受け取ってください。有料のチャージは$20から$500までの任意の整数額で実行され、$50以上で+5%、$100以上で+10%、$200以上で+15%のボーナスが付与されます。暗号資産(TRC20上のUSDT、Base上のUSDC)で支払うことができます。

キーをクライアント側のコードや公開リポジトリに含めないでください。送信されたプロンプトはトレーニングに使用されませんが、キーが漏洩するとクレジットが消費されます。完全なキーは8件の同時リクエストと1分あたり300件のリクエストを許可するため、プロンプトバッチは追加作業なしで並列実行できます。

質問と回答

このキーを使ってFluxで画像を生成できますか?

いいえ。このキーはこのサイトのテキストAPI専用です。画像生成には、画像モデルをホストするプロバイダからのキーが必要です。

これは公式のFlux APIですか?

いいえ。これは独立したホスト型のOpenAI互換テキストAPIで、1つのモデル(名前:uncensored)のみを使用しています。画像モデルベンダーによって運営されているわけではなく、それらのサービスも再販売していません。

テキストモデルは私の画像ツールのためのプロンプトを作成できますか?

はい。システムメッセージでプロンプトをリクエストし、返信テキストを取得して画像サービスに貼り付けまたは送信してください。2つのサービスは独立したままです。

試すためにカードが必要ですか?

いいえ。新規ユーザーは、キーページでワンクリックで$0.50の無料トライアルクレジットを請求でき、カード不要で7日間有効です。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得