ideogram/p-image-ideogram の API リファレンスです。Comfy Router が Ideogram から提供しています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK を使用しており(pip install comfy-sdk、npm install @comfyorg/sdk)、cURL スニペットは同じ呼び出しを生の HTTP で行うものです。
モデル ID: ideogram/p-image-ideogram
エンドポイント: POST https://api.comfy.org/v2/models/ideogram/p-image-ideogram
- Wait for the result
- Queue and collect later
スキーマ
入力
string
WxH 形式のアスペクト比。サポートされる値: 1x3、3x1、1x2、2x1、9x16、16x9、10x16、16x10、2x3、3x2、3x4、4x3、4x5、5x4、1x1。デフォルトは 1x1。
boolean
生成後の著作権検出(Hive による類似性およびロゴのチェック)をオプトインします。
string
必須
画像生成用のプロンプト。自然言語、または Ideogram 4.0 の JSON 構造化プロンプトのいずれかです。
string
プロンプトのアップサンプリングモード。サポートされる値は AUTO、ON、OFF です。デフォルトは AUTO。
string
生成品質レベル。サポートされる値は VERY_LOW、LOW、MEDIUM、HIGH です。デフォルトは MEDIUM。
string
出力解像度。サポートされる値は 1K と 2K です。デフォルトは 1K。
integer
再現可能な生成のためのシード値
GET /v2/models/ideogram/p-image-ideogram/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。
出力
string (date-time)
生成が作成されたタイムスタンプ。形式:
date-timeobject[]
生成済み画像情報の配列。
boolean
画像が安全であると見なされるかどうかを示します。
string
この画像の生成に使用されたプロンプト。
string
生成済み画像の解像度(例: ‘1024x1024’)。
integer
この生成に使用されたシード値。
string
生成に使用されたスタイルタイプ(例: ‘REALISTIC’、‘ANIME’)。
string
生成済み画像への URL。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。