Skip to main content
Ideogram 4.0 の API リファレンス。Ideogram 4.0 は Ideogram のテキストから画像へのモデルで、生成済み画像内に読みやすいテキストを描画します。

クイックスタート

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

スキーマ

入力

生成後の著作権検出(Hive による類似性チェックとロゴチェック)を有効にします。
object
構造化された V4 プロンプト。Magic Prompt を無効化し、そのまま使用されます。text_prompt または json_prompt のいずれか一方のみを指定してください。
string
デフォルト:"\"DEFAULT\""
生成速度と品質のトレードオフを制御するレンダリング速度の設定指定可能な値: DEFAULTTURBOQUALITY
string
WIDTHxHEIGHT 形式の出力解像度。省略すると、モデルがアスペクト比を選択します。サポートされる 2K の値: 2048x2048, 1440x2880, 2880x1440, 1664x2496, 2496x1664, 1792x2240, 2240x1792, 1440x2560, 2560x1440, 1600x2560, 2560x1600, 1728x2304, 2304x1728, 1296x3168, 3168x1296, 1152x2944, 2944x1152, 1248x3328, 3328x1248, 1280x3072, 3072x1280。
string
自然言語のプロンプト。Magic Prompt が自動的に有効になります。text_prompt または json_prompt のいずれか一方のみを指定してください。
Router が GET /v2/models/ideogram/ideogram-v4/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するのと同じドキュメントです。

出力

string (date-time)
生成が作成されたタイムスタンプ。フォーマット: date-time
object[]
生成された画像情報の配列。
boolean
画像が安全であると見なされるかどうかを示します。
string
この画像の生成に使用されたプロンプト。
string
生成された画像の解像度(例: ‘1024x1024’)。
integer
この生成に使用されたシード値。
string
生成に使用されたスタイルタイプ(例: ‘REALISTIC’、‘ANIME’)。
string
生成された画像への URL。

入力

出力

URL は一時的なものです。画像を保持する必要がある場合は、速やかにダウンロードしてください。

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。