Pure Tokens 画像生成
固定の Pure Tokens Images API のみを呼び出します：https://api.puretokensx.com/v1/images/generations。編集は、正確なモデルプロファイルが宣言されている場合にのみ /v1/images/generations または /v1/images/edits を呼び出します。毎回完全な固定 URL を使用し、設定済みの Base URL をリクエスト先として使用したり、プロバイダ名をチェックしたりしません。
現在のホストは、その既存の認証 HTTPS/API 機能を使用し、現在 Pure Tokens 接続に一致する認証情報でリクエストを完了します。認証情報は、この固定リクエストのためにメモリ内でのみ使用できます。サードパーティの CC Switch や手動ホスト設定がこの接続のソースになります。キー、ベース URL、リクエストヘッダー、完全なホスト設定、生のレスポンス、ユーザーメディアを表示、要求、保存、記録、または報告してはなりません。Node、MCP、プロキシ、サイドカー、独立したアップロード、代替エンドポイントを使用してはなりません。
オンデマンドで資料を読み込む
すべてのリクエストで全モデルと全例外シナリオをロードしないでください。以下の順序で最小限読み込みます：
- 最初に
references/model-index.jsonを読み込みます：デフォルトモデルまたは一意のエイリアスを解析し、正確なプロファイルパスを取得します。 - 選択されたモデルの
references/profiles/<model>.jsonのみを読み込みます：パラメータ、制約、操作、ライフサイクルを確認します。インデックスにない正確なモデルでは、コアのテキストから画像へのフィールドのみ許可されます。ユーザーが追加パラメータ、参照画像、または編集を要求した場合にのみ、オンデマンドでリアルタイムカタログを照会します。 - 通常のコア POST は、このスキル、インデックス、および選択されたプロファイルに基づいて実行できます。レスポンスを受信した後、ポーリング/配信に入るとき、または編集などの非コア操作を構築するときに、
references/execution-contract.jsonとreferences/task-receipt.jsonを読み込みます。 - 対応する例外、あいまいさ、拒否、添付ファイル、配信の問題が発生した場合にのみ、
references/behavior-scenarios.jsonの該当するシナリオを読み込みます。
モデルとリクエスト
- 通常のテキストから画像へのデフォルトは
gpt-image-2です。image2がその唯一のエイリアスです。ユーザーが一意のエイリアスを指定した場合は、インデックスマッピングを使用します。0 個または複数の候補がある場合は、正確な ID をリストしてユーザーに選択を促します。ユーザーが正確な ID を指定した場合はその ID を保持し、通常のコアリクエストでは、権限や機能を確認するためにカタログを事前に読み込んではなりません。 - 通常のリクエストは
POST /v1/images/generationsを 1 回だけ送信し、常にmodel、prompt、async: trueを含めます。正確なプロファイルで宣言されている場合にのみ、n、size、image_size、aspect_ratio、width、height、strength、またはその他のオプションフィールドと値を含めます。 - 1 回のユーザーリクエストで作成できる有料タスクは 1 つだけで、決して分割しません。
nはプロファイルで明示的に許可されている必要があります。それ以外の場合は、1 回に 1 枚のみサポートされるか、その数量をサポートするモデルをユーザーに選択するよう説明します。 200cm × 230cmなどの物理的な寸法は API に渡せません。物理的な寸法を正確に保証できないことを説明し、プロファイルで実際に宣言されているピクセル寸法、セマンティック寸法、またはアスペクト比のオプションをリストします。widthとheightがペアで宣言されている場合は、片方が欠けていると処理を停止します。複数のサイズ表現が同時に指定された場合は、プロファイルの優先順位に従って 1 つだけ送信します。- ユーザーが現在のモデルについて明示的に尋ねた場合、必要なパラメータ/操作がローカルプロファイルにない場合、添付ファイルのトランスポートが互換性がない場合、または API がモデル/パラメータ/機能のために拒否した後に説明が必要な場合にのみ、
GET https://api.puretokensx.com/v1/media/modelsを 1 回読み込みます。カタログの読み取りに失敗しても、本来有効なコアのテキストから画像への処理を妨げたり、自動再試行をトリガーしたりしてはなりません。
参照画像と編集
- ユーザーが画像を添付したが用途を説明していない場合は、それが視覚的な参照か編集対象の画像かを尋ねます。推測してはいけません。
- 公開画像については、ユーザーが明示的に提供した準拠した
https://URL のみを受け入れ、プロファイルで宣言されたフィールドとトランスポートにのみ配置できます。URL をダウンロード、調査、再保存、書き換え、または生成してはいけません。 - ローカル画像の参照または編集は、選択されたプロファイルの
image_editマルチパート操作で明示的にサポートされている必要があり、そのパス、フィールド、数量、およびmultipart_fileトランスポートを厳密に使用します。現在の添付ファイルのみをこの Images API リクエストとともに送信します。R2 にアップロードしたり、独立したアップロードインターフェースを呼び出したり、ファイル ID を生成したり、添付ファイルの内容をプロンプトに書き換えたり、静かにテキストから画像へダウングレードしたりしてはいけません。 - 参照画像のプロンプトは「参照」の意図を維持します。編集プロンプトは「何を変更し、何を保持するか」を明確にします。マスク、透明な背景、宣言されていない複数の参照画像、その他の宣言されていない拡張は、課金前に停止し、制限事項を説明します。
非同期タスクと配信
- 新しいリクエストごとに最大 1 回の POST です。POST が開始された可能性があるが、解析可能な結果やタスク ID がない場合、結果は「不明」として報告します。再試行せず、モデルを変更せず、未作成、未課金、または返金済みとは主張しません。タスク ID がない場合、後続の新しいリクエストはユーザーの明示的な確認を得る必要があります。
- タスク ID は、宣言されたトップレベルのフィールドまたはトップレベルの
task_id/idからのみ取得します。同じhttps://api.puretokensx.com/v1/images/{task_id}のみを照会し、成功後はcontent?index=0..n-1の順序で配信します。URL、ステータステキスト、HTML、SVG は成功した配信ではありません。 - 各ポーリングウィンドウで最大 6 回のステータス読み取り、最大 120 秒。通常の待機間隔は 3、6、12、24、30 秒です。429 エラーの場合は、有効な
Retry-Afterが現在の予算内にある場合にのみ同じタスクを続行します。バックグラウンドポーリング、同時ステータス読み取り、自動再試行はありません。 - ホストが実際にネイティブ画像バイトまたは添付ファイルを配信した場合にのみ成功を報告します。画像を 1 枚ずつ配信し、プリフェッチ、再読み取り、ユーザーメディアのキャッシュは行いません。成功後は現在の応答を終了します。
失敗レシート
ホストが POST 前に、ネットワーク、承認、添付ファイルの転送、またはネイティブバイトの配信機能によってブロックされた場合、failure_phase: validation を返し、Images API が実行されなかったことを明確にし、設定の原因を推測しません。その他の失敗は、execution-contract.json と一致する動作シナリオに従って安全なレシートを出力します。API が実際に返した HTTP ステータスと公開エラーコードのみを報告します。生のレスポンス、内部 URL、スタックトレース、認証情報、リクエスト内容、ユーザーメディアを公開してはなりません。