Skip to main content
「プロンプトの長さが ChatGPT と違って、32K に制限されているようです。」この 32K は APIYI が追加したものではありません。OpenAI Images API の公式制限であり、token ではなく文字数でカウントされます。しかし、本当の問題は「32K を送信できるか」ではなく、32K 分の生データをそもそも画像モデルに渡すべきかです。このページでは、この制限の由来、ウェブアプリが無制限に見える理由、長いプロンプトに伴う 2 つのコスト、そして広告クリエイティブのような要件の多い作業向けにプロンプトを整理する方法を説明します。

お客様の質問:ChatGPTにはないのに、なぜAPIの上限は32Kなのですか?

やり取りの内容(匿名化済み):
お客様:あなたのpromptの長さはChatGPTとは異なります。32Kで制限されているようです。 当社:制限はあります。32Kのpromptで画像ジョブを実行する人がいるのでしょうか? お客様:たくさんいます。広告クリエイティブ、パッケージの寸法などです……。それなら自分でcodex cliを呼び出します。 当社:確認ですが、32,000 tokenのpromptですか? お客様:はい。英語で32,000文字は、まったく長くありません。
ここでは、3つの異なる概念が混同されています。まず、それぞれを分けて考えます。 「英語で32,000文字は長くない」というのは文字数についての発言であり、その点は妥当です。しかし、お客様が比較しているChatGPTのWebアプリは、そもそも同じ経路を通っていません。

32K制限の由来

promptフィールドに対する公式の OpenAI 画像 API の制限(/v1/images/generationsおよび/v1/images/editsも同様): 出典:OpenAI API リファレンス、developers.openai.com/api/reference/resources/images/methods/generate
APIYI の公式リレーでは、この制限をさらに厳しくしていません。32,000文字を超えるとプロバイダーは 400 を返します。正確なエラーテキストはプロバイダーによるものであり、このページでは境界を1バイトずつ検証していません。正確な上限を知る必要がある場合は、ご自身のキーで1回呼び出せば確認できます。拒否されたリクエストは課金されません。
文字数は tokens ではありません。 課金とモデルの理解はどちらも tokens 単位で行われ、usage.input_tokens_details.text_tokensは各呼び出しで実際に消費されたテキスト tokens を報告します。同じ32,000文字でも、英語では約8K tokens、中国語では各文字がより多くの tokens に対応し、より多くの情報も含むため、明らかに多くなります。そのため、「32Kの英語は短い」と「32Kの中国語は長い」は、どちらも成り立ちます。

ChatGPTのウェブアプリが無制限に見える理由

満足のいく画像を取得する方法安全性による拒否と同じポイントです。ウェブアプリはエージェントであり、APIは単一のアトミックな呼び出しです
  • 長いドキュメントをChatGPTに貼り付けると、それを読むのは画像モデルではなくチャットモデルです。チャットモデルは内容を読んだうえで、独自の短い画像用promptを作成し、それを使って画像ツールを呼び出します。画像モデルが元の素材を見ることはありません。10,000文字を超える貼り付けは自動的に添付ファイルにも変換されます(OpenAIヘルプセンター、help.openai.com)。このことからも、テキストがチャットモデル向けであることは明らかです。
  • APIでは画像モデルに直接話しかけます。途中で誰かが素材を読んで、代わりに判断を下すことはありません。制限は画像モデル層に属しており、ウェブアプリは画像モデルをその制限にさらしていません。
  • お客様の別れ際の言葉である「自分でcodex CLIを呼び出します」は、正しい直感です。テキストモデルに素材を読ませ、画像用promptを生成させます。これはまさにウェブアプリが裏側で行っていることであり、以下の2段階パイプラインによって実行可能になります。

長いpromptにかかる2つのコスト

まずコスト、次に結果です。 コスト: gpt-imageファミリーのテキスト入力はtoken単位で課金されます(gpt-image-2.5では100万tokenあたり$5.00。概要の料金表を参照してください)。32,000文字の英語promptは約8K tokenで、1回の呼び出しあたりおよそ$0.04です。中国語ではさらに高くなります。単体では小さな金額ですが、画像の枚数分だけ積み重なり、リトライするたびに再度支払うことになります。promptの90%がシーンの説明ではなく素材そのものである場合、その支出の大部分は何も生みません。 結果: 詳細を増やせば、指示への忠実度が高くなるとは限りません。何百もの要件を一度に画像モデルに提示すると、それらが競合します。本当に重要な厳格な制約(ロゴを歪めない、パッケージのテキストを正確にする、人物の人数など)ほど、埋もれてしまいます。画像promptに関するOpenAI独自のガイダンスでは、まず1〜3個の明確な文から始め、その後に必要な構図、ライティング、厳格な制約を追加するよう推奨しています(openai.com/academy/image-generation)。画像モデルに必要なのは、文字数ではなく、優先順位が明確な情報密度です。 したがって、「プロフェッショナルな広告には多くの要件がある」というのは正しいですが、詳細であることは、長いことと同じではありません高度な画像生成の6つの要素と、画像promptドクタースキルにある「形容詞でpromptを水増ししない」というルールは、同じことを述べています。

2つのステージ:素材をテキストモデルに、プロンプトを画像モデルに

画像ジョブの背後に実際に32K分の素材がある場合、それは通常、ブランドブック、パッケージ仕様書、広告ブリーフ、またはキャラクターバイブルです。その素材はまずテキストモデルに渡し、画像モデル用の1つの凝縮されたプロンプトにまとめます。 凝縮出力のテンプレートでは、6つの要素に加えて、広告に特化した3つのセクションを追加します。
1

素材をそのままテキストモデルに渡す

ブランドブック、仕様書、ブリーフは前処理不要です。テキストモデルのコンテキストは十分に大きいためです。システムプロンプトで、出力テンプレート、文字数上限(2,500文字以下を目標にすると適切です)、および「ハード制約を最初に記載すること」を明記します。
2

プロンプトを長さゲートに通す

len(prompt)を確認します。32,000を超える場合は、テキストモデルにもう一度圧縮させます。凝縮されたプロンプトは通常1~2千文字なので、このステップは安全策です。
3

プロンプトを保存してから、画像モデルを呼び出す

凝縮されたプロンプトを永続化し、生成時にはそれだけを再利用します。リトライ、サイズ変更、モデルの切り替えを行っても、素材を再度読み込んだり、素材分の tokens に対して再び料金を支払ったりする必要はありません。
4

素材が変更されたら、ステージ1だけを再実行する

パッケージのリデザインやブリーフの更新があった場合は、再度凝縮します。生成コードとパラメータは変更しません。
最小実装(OpenAI SDK、両ステージで1つのキーを共有):
凝縮されたプロンプトを生成パラメータとともにアーカイブすることが、この製品ラインで結果を再現するための唯一の信頼できる方法です(GPT-Image ファミリーにはシードがありません)。高度な画像生成のセクション5を参照してください。

長いプロンプトが本当に必要な場合

プロンプトが長くなるケースはいくつかありますが、いずれも32Kには到底及びません。
  • 複数画像の編集:「画像 1 / 画像 2 / 画像 3」のように参照画像を示し、それぞれから何を取り入れるかを記述します。数百文字程度です。
  • 画像内のテキスト:看板、ポスター、パッケージの文言はモデル任せにせず、そのまま正確に指定する必要があります。数十〜数百文字程度です。
  • シリーズで共有する先頭部分:一括処理する画像に共通するスタイル、ライティング、構図のブロックです。1,000文字未満です。
これらを合わせても、通常は2,000〜3,000文字程度です。プロンプトが32Kに近づいている場合は、元の素材がそのまま貼り付けられていないか疑ってください。

クイックリファレンス

  • 32,000文字は公式のOpenAI Images APIの上限です。tokenではなく文字数でカウントされ、/generations/editsで同一です。APIYIの公式リレーがこの上限を厳しくすることはありません。
  • 文字数、token、コンテキストウィンドウはそれぞれ異なるものです。英語の32K文字は約8K tokenで、中国語ではそれ以上になります。テキストモデルのコンテキストウィンドウは、画像モデルのprompt上限とは無関係です。
  • ウェブアプリの「無制限」は錯覚です。チャットモデルが素材を読み取り、画像ツール用の短いpromptを独自に作成します。画像モデルが32Kの制限に直面することはありません。
  • 詳細であることと長いことは別です。テキスト入力はtoken単位で課金され、再試行するたびに再度支払いが発生します。互いに競合する要件を何百個も含めると、厳密な制約が埋もれてしまいます。
  • 2段階で進めます。まずテキストモデルで素材を1K〜3K文字の構造化promptに要約し、厳密な制約を先頭に配置して保存します。その後、生成時にはpromptだけを再利用します。

関連ドキュメント