これはGoogleのGemini画像APIですか?
いいえ。Gemini画像エンドポイントを探して到着した場合は、まず誰が何を提供しているかを明確にしてください。GeminiはGoogleのモデルファミリーであり、Googleは独自の開発者製品を通じて画像生成を提供しています。それらの製品でできることは、Google経由、Googleのアカウント、キー、利用規約でアクセスします。
このサイトは別のものです。これはホストされたテキストAPIで、独立したプロバイダーが実行する単一のオープンウェイトモデルが、合法的な成人利用に対してコンテンツ拒否なしで回答するようにチューニングされています。Geminiの再販売元ではなく、リクエストをGoogleにルーティングせず、Googleやその他のモデルベンダーからの推薦もありません。ドメイン名に画像生成が含まれているのは、多くの訪問者が画像の生成ではなくプロンプトのヘルプを探しに来るためであり、ここで画像が生成されるからではありません。
実際に得られるもの
スコープは意図的に狭く、数分で評価しやすいようになっています。
- プロトコル: OpenAI互換。ベースURLとキーを変更するだけで、任意のOpenAI SDKまたはクライアントが動作します。
- ベースURL:
https://api.imagegenapi.com/v1 - モデルID:
uncensored - メソッド:
POST /v1/chat/completionsおよびGET /v1/models - 機能: SSEを介したストリーミング、ツール呼び出し、JSON モード、および透過サンプリングパラメータ(
temperature、top_p、stop、seed、ペナルティ)。 - コンテキストウィンドウ: 100,000トークン(プロンプトと補完を含む)。
含まれていないもの:画像生成、画像入力、オーディオ、ビデオ、埋め込み、ファインチューニング。上記リストにない機能は欠如していると想定してください。リクエスト形式とエラーコードはドキュメントページをご覧ください。
第三者と公式:見分け方
この混乱は市場全体で一般的であるため、名前が大手ベンダーのもののように聞こえるAPIに遭遇した際は、簡単なチェックリストが役立ちます。
- ドメインと利用規約を確認する。 公式APIはベンダー独自のドメインと規約の下にあります。第三者サービスはそれを明記するか、少なくとも独自の運営者を名乗ります。
- モデルリストを確認する。 ここでは、
GET /v1/modelsが単一モデルuncensoredを返します。ルーターは複数のベンダーモデル名をリストします。 - 約束された内容を読む。 「本物だが、より安価」といった主張は疑うに値します。信頼できるサービスは、どの機能が欠けているかを伝えます。
- テストする。 ワークロードを移動する前に、無料トライアルでいくつかのリクエストを送信してください。
このサイトでは、答えは明確です:独立したプロバイダ、単一のオープンウェイトモデル、テキストのみ。他の解釈は誤りとして扱ってください。モデルの正体は動作で確認できますが、特定のベンダーの製品であると主張することを期待すべきではありません。
テキストと画像ツールの合理的な組み合わせ
画像モデルはプロンプトによって駆動され、良いプロンプトの作成は主にテキストタスクです。一般的なワークフローは2つのステップに分かれます:言語モデルに詳細なプロンプトの生成を依頼し、そのプロンプトを選択した画像サービス(Googleやその他)に貼り付けまたはパイプラインで渡すこと。ここでテキストモデルはステップ1を担当します。
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
temperature=0.7,
messages=[
{"role": "system", "content": "Turn a short idea into a detailed prompt for a text-to-image model. Include subject, setting, lighting, color palette and mood. One paragraph."},
{"role": "user", "content": "A smuggler's market inside a hollowed-out whale skeleton, neon lanterns."},
],
)
print(resp.choices[0].message.content)
パイプラインでは、次のステージがフィールドを読み込めるようにJSONを依頼します。公式のopenaiパッケージを使用したNode.jsでの例は以下の通りです:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.imagegenapi.com/v1",
apiKey: process.env.API_KEY,
});
const res = await client.chat.completions.create({
model: "uncensored",
response_format: { type: "json_object" },
messages: [
{ role: "user", content: "Return JSON with keys prompt and style for: a whale-skeleton night market." },
],
});
const out = JSON.parse(res.choices[0].message.content);
console.log(out.prompt);
これらのスニペットに関するいくつかの注意。システムメッセージが主要な役割を果たすため、そこに時間を費やしてください。APIキーは環境変数に含め、ソース管理には含めないでください。また、429エラーが発生した場合は、ループを全速力で回すのではなく、待機して再試行してください。ループが速すぎると、1分あたりの割り当てをより早く使い切ってしまうためです。同じコードは、他のOpenAI互換ホストでも変更なしで実行可能であり、これが共有プロトコルの利点です:ベースURLとモデル名を変更するだけでプロバイダを切り替えられます。
合法的な成人利用に限定する方針は、リクエストするコンテンツに適用されることを覚えておいてください。フィクション、ロールプレイ、コンパニオンアプリが典型的な用途であり、未成年者を含む性的コンテンツは例外なくブロックされます。
画像モデルに適したプロンプトの作成
テキストステップの価値の大部分は、モデル自体ではなく、あなたが与える指示から来ます。いくつかの習慣により、出力の使いやすさが大幅に向上します。
モデルに固定されたレシピを与える
望む部分の順序を指定してください:まず主題、次に背景、次に光、次にパレット、次にスタイル。画像モデルは初期の単語により多くの重みを付ける傾向があるため、安定した順序により実行間で結果を比較可能に保ちます。非常に長いプロンプトは主要な主題を薄め、改善につながらないことが多いので、単語数制限を追加してください。
除外するものを明記する
一部の画像ツールは別のネガティブプロンプトを受け取りますが、無視するものもあります。テキストモデルに2つの部分を別々のJSONフィールドとして返させ、ツールが第2のフィールドを使用しない場合はそれを除外します。これは長い段落を手動で編集するよりも簡単です。
同じ会話内で反復する
messages リストに以前のメッセージを保持し、変更を依頼します:より暖かい光、より広いアングル、より少ないキャラクターなど。コンテキストウィンドウは100,000トークンなので、長い編集セッションでも収まります。小さな編集にはtemperatureを下げ、新しいアイデアには上げます。
いくつかのシードをテストする
同じメッセージと設定で同じ seed を渡すと、実行ごとに出力が近くなります。システムメッセージなど一度に一つだけ変更し、どの変更が結果を改善したかを確認できます。この規律は、無駄な画像生成を減らすことで、どの価格プランよりも多くのコスト削減につながります。
テキストステップのコスト
料金は前払いクレジットから、入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50で、サブスクリプションはありません。拒否または失敗したリクエストは課金されません。1,000件のプロンプト作成呼び出しのバッチを例にとります。各呼び出しは入力400トークン、出力250トークンです。
- 1回あたりの入力:400 / 1,000,000 x $0.15 = $0.00006。
- 1回あたりの出力:250 / 1,000,000 x $0.50 = $0.000125。
- 1回あたり:$0.000185。
- 1,000回あたり:$0.185。
これはバッチで18.5セントです。画像プロバイダの1枚あたりの価格と比較してください(それらの価格ページで確認すべきです)。通常、プロンプト作成ステップの方が安価であることがわかります。
クレジットでのスタート
新規ユーザーは、Googleまたはメールアドレスとパスワードでサインアップ後、API キーページ でワンクリックして$0.50の無料トライアルクレジットを受け取ることができます。支払い不要で、7日間有効です。その後、暗号資産(TRC20上のUSDTまたはBase上のUSDC)で$20から$500までの任意の整数額でチャージできます。ボーナスは$50以上で+5%、$100以上で+10%、$200以上で+15%、クレジットは期限切れになりません。詳細は価格表をご覧ください。
計画を立てるための制限
完全なキーは8つの同時リクエストと1分あたり300リクエストを許可します。試用キーは同時リクエスト2件、1分あたり60リクエストまでです。最初の制限を超えると、コードrate_limited でHTTP 429が発生し、2番目の制限を超えるとコードconcurrency で429が発生し、一時的な過負荷はRetry-After: 5 ヘッダーで429を返します。ストリーミングリクエストはストリームが終了するまでスロットを保持するため、不要なストリームは閉じてください。
レスポンスヘッダーにはX-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests および X-RateLimit-Limit-Concurrency が含まれます。すべてのエラーにリクエストIDをログに記録してください。これはサポート から支援を受ける最速の方法です。最大ボディサイズは8 MBです。
必要なものがネイティブなGemini画像呼び出しであれば、Googleにアクセスして現在のドキュメントをお読みください。OpenAIプロトコルを話す無検閲テキストモデルで、合法的な成人用途のためのプロンプト、ストーリー、キャラクターの対話を書く必要がある場合、これはそのために作られています。
