Skip to main content
ideogram/p-image-ideogram の API リファレンスです。Comfy Router が Ideogram から提供しています。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK を使用しており(pip install comfy-sdknpm install @comfyorg/sdk)、cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 モデル ID: ideogram/p-image-ideogram エンドポイント: POST https://api.comfy.org/v2/models/ideogram/p-image-ideogram

スキーマ

入力

string
WxH 形式のアスペクト比。サポートされる値: 1x3、3x1、1x2、2x1、9x16、16x9、10x16、16x10、2x3、3x2、3x4、4x3、4x5、5x4、1x1。デフォルトは 1x1。
生成後の著作権検出(Hive による類似性およびロゴのチェック)をオプトインします。
string
必須
画像生成用のプロンプト。自然言語、または Ideogram 4.0 の JSON 構造化プロンプトのいずれかです。
string
プロンプトのアップサンプリングモード。サポートされる値は AUTO、ON、OFF です。デフォルトは AUTO。
string
生成品質レベル。サポートされる値は VERY_LOW、LOW、MEDIUM、HIGH です。デフォルトは MEDIUM。
string
出力解像度。サポートされる値は 1K と 2K です。デフォルトは 1K。
integer
再現可能な生成のためのシード値
Router が GET /v2/models/ideogram/p-image-ideogram/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

string (date-time)
生成が作成されたタイムスタンプ。形式: date-time
object[]
生成済み画像情報の配列。
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 が現在対応していないことと、代替手段。