短い答え
image gen api openaiというフレーズは2つの異なる意味を持ち、これらを区別することが重要です。1つはOpenAI自身の画像生成サービスで、これはOpenAIに属しており、OpenAIアカウントを使用してアクセスします。もう1つは既存のSDKやツールが動作し続けるようにOpenAIのリクエスト形式を模倣するあらゆるサービスです。このサイトは2番目のタイプであり、テキストのみを対象としています。
ここで提供されるのは、ホストされた無検閲テキストLLM APIです。OpenAI互換クライアントを以下のBase URLに設定し、モデルを uncensored に指定すると、チャット補完が返されます。画像は返りません。画像、音声、動画の生成、埋め込み、ファインチューニングは提供されず、これらもこのサイトのページで説明されている範囲では予定されていません。
互換性と非互換性
「互換性」という言葉はマーケティングで誇張されることが多いため、正確な仕様を示します。Base URLはhttps://api.imagegenapi.com/v1、認証はAuthorization: Bearer <key>で、2つのメソッドが存在します。
| エンドポイント | ここで利用可能 | 注記 |
|---|---|---|
POST /v1/chat/completions | はい | ストリーミング、ツール呼び出し、JSONモード |
GET /v1/models | はい | uncensored を一覧表示 |
| 画像生成エンドポイント | なし | テキストのみサービス |
| 埋め込み、音声、ファインチューニング | なし | 提供不可 |
このBase URLで画像パスを呼び出すと、画像ではなくエラーが返ります。上記2つのメソッド以外のOpenAI機能も同様です。ご存知のサンプリング制御は動作します:temperature、top_p、stop、seedおよびペナルティはそのまま渡され、応答はプロンプトと完了を合わせた100,000トークンのウィンドウ全体を使用できます。
アイデンティティについても明確にします。uncensoredの背後にあるモデルは、独立したプロバイダが運用する単一のオープンウェイトモデルです。これはOpenAIのAPIではなく、OpenAIモデルのプロキシでもなく、OpenAIと提携していません。当サイトのGPT画像APIと無検閲テキストページでは、画像モデル名の観点からこの区別を扱っています。
なぜこの質問が上がるのか
このようなページにたどり着くのには、もっともな理由があります。画像ツールはテキストプロンプトで駆動され、テキストプロンプトは言語モデルによって作成され、多くの言語モデルゲートウェイは同じリクエスト形式を共有します。そのため、1つのAPIが両方を行うという自然な推測が生まれます。
実際には、これら2つの作業は別々のシステムであり、別々のキー、別々の価格、別々のルールを持っています。画像サービスはプロンプトを受け取り画像を返します。テキストサービスはメッセージを受け取りテキストを返します。それらを繋ぐのはあなた、またはあなたが書くスクリプトです。このように見ると、「このAPIは画像を生成するか」という質問は、「このAPIは既存の画像モデルにより良いプロンプトを書けるか」という有用な質問に変わります。
これは実際のユースケースであり、無検閲テキストモデルが重要な役割を果たす場所です。汎用アシスタントは、大人向けのフィクション、物語設定の暴力、ダークな美学など、成熟したテーマに触れるプロンプトリクエストを書き換えたり、柔らかくしたり、拒否したりすることがあります。合法的な成人向けリクエストを拒否せずに回答するように調整されたモデルは、通常、指示どおりタスクを遂行します。ただし、未成年者を含む性的コンテンツは、いかなる形式でも禁止されています。
テキストAPIで画像プロンプトを作成する
以下は動作する小さな例です。モデルに詳細なプロンプトを依頼し、その後お好みの画像生成ツールに貼り付けます。このコードは、公式のOpenAI Python SDKを使用してこのBase URLに対して実行されます。
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)
コマンドラインからの同じ呼び出し:
curl https://api.imagegenapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'
出力を扱いやすくする
画像生成モデルは受け付ける内容が異なるため、システムメッセージで結果を制御してください。固定された構造、単語数制限、避けるべき事項のリストを指示します。パイプライン内でプロンプトが必要な場合は、response_formatをtype json_objectに設定してJSONをリクエストし、promptやnegativeなどのキーを指定してください。その後、それを解析して画像クライアントにフィールドを渡します。seedを設定し、低いtemperatureにすると、文章の推敲時に出力の再現性が高まります。
実際の数値を用いたバッチワークフロー
1,000シーンのプロンプトを生成すると仮定します。各リクエストは約300トークン(指示と短いシーンノート)を送信し、約200トークンのプロンプトを受信します。価格は、入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50です。
- 1リクエスト、入力:300 / 1,000,000 x $0.15 = $0.000045。
- 1リクエスト、出力:200 / 1,000,000 x $0.50 = $0.0001。
- 1リクエスト合計:$0.000145。
- 1,000リクエスト:1,000 x $0.000145 = $0.145。
したがって、1,000件のプロンプトは約14.5セントの費用がかかります。テキスト生成の工程は通常、画像生成そのものよりも費用の小さな部分です。画像生成の価格は、そのプロバイダーに確認してください。完全なキーでは8件の同時リクエストと1分あたり300件のリクエストが許可され、小さなワーカープールで1,000件のリクエストは数分で処理できます。HTTP 429エラーが発生した場合は待機してください。Retry-After: 5 ヘッダーが、一時的な過負荷時に待機すべき時間を示します。
これらはすべて、支払いなしで試すことができます。サインアップ後、APIキーのページ でワンクリックで有効期限7日の$0.50の無料トライアルクレジットを受け取れます。長期的には、$20〜$500のチャージが暗号資産(TRC20上のUSDTまたはBase上のUSDC)で可能で、ボーナスティアの詳細は価格表をご覧ください。
避けるべき間違い
OpenAI形式のエンドポイントを画像用途で使用しようとする際、いくつかのエラーが頻繁に発生します。
- 画像パスを呼び出して画像を期待する。 ここでは文書化された2つのメソッドのみが存在します。再試行するのではなく、エラーボディを確認してください。再試行しても結果は変わりません。
- テキストモデルに「描画」を依頼する。 ASCIIアート、説明、または謝罪を返すことがあります。画像が欲しい場合は、モデルが作成したプロンプトを実際の画像生成ツールに送信してください。
- モデルリストをスキップする。 素早い
GET /v1/models呼び出しで、キーが動作し、唯一のモデルがuncensoredであることを確認できます。コストはかかりません。 - 429応答を無視する。 試用キーでは同時2リクエストまでなので、10ワーカーのループではすぐに失敗します。ワーカー数を制限するか、短い待機を追加してください。
- 非常に大きなボディを送信する。 1リクエストあたりの制限は8 MBです。プロンプト作成呼び出しは非常に小さいため、通常問題になりませんが、貼り付けたドキュメントでこれに達する可能性があります。
これらのいずれも修正は難しくなく、大きなツールに接続する前に10行のテストスクリプトを実行するのが最も早い解決策です。
別のサービスが適している場合
選択には実用的になりましょう。画像そのものが必要であれば、画像プロバイダーが必要です。OpenAIはその一つですが、提供内容の詳細は最新のドキュメントと価格表をご確認ください。唯一の目的がメインストリームのクリーンなプロンプトであれば、標準的なアシスタントで十分であり、このサービスは不要です。
テキスト処理がボトルネックとなる場合に、このAPIが最適です。使用しているアシスタントがプロンプトリクエストを拒否したり弱めたりする場合、予測可能なトークン単価で大量のプロンプトが必要な場合、またはクライアントコードを書き換えずに合法的な成人利用の小説、ロールプレイ、コンパニオンツール向けにOpenAI互換のエンドポイントを使いたい場合に適しています。パラメータの詳細については、ドキュメントのリクエスト形式とエラーコードをご覧ください。
もう一つの実用的な注意点:このAPIに送信されたプロンプトは学習に使用されません。ただし、ホストされたサービスはあなたのマシン外にあるとみなし、ウェブフォームに貼り付けるべきではない秘密情報は送信しないでください。
