Ideogram 画像生成 API ドキュメント

概要

このAPIを使用することで、様々なパラメータやモデルを用いて画像を生成することができます。APIエンドポイントはJSON形式のペイロードを含むPOSTリクエストを受け付けます。

公式ドキュメント

ベースURL

https://api.ideogram.ai/generate

認証

リクエストヘッダーにAPIキーを含める必要があります：

Api-Key: <あなたのAPIキー>

リクエスト構造

基本的なリクエスト例

curl -X POST https://api.ideogram.ai/generate \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "image_request": {
    "prompt": "穏やかな熱帯のビーチシーン...",
    "aspect_ratio": "ASPECT_10_16",
    "model": "V_2",
    "magic_prompt_option": "AUTO"
  }
}'

必須パラメータ

オプションパラメータ

アスペクト比と解像度

利用可能なアスペクト比：
– ASPECT_1_1（1:1）
– ASPECT_16_9（16:9）
– ASPECT_9_16（9:16）
– その他…

モデルとスタイル設定

利用可能なモデル：
– V_1
– V_1_TURBO
– V_2
– V_2_TURBO

利用可能なスタイル：
– AUTO（自動）
– GENERAL（一般）
– REALISTIC（リアル）
– DESIGN（デザイン）
– RENDER_3D（3Dレンダリング）
– ANIME（アニメ）

カラーパレット設定

color_paletteパラメータは以下の2つの形式のいずれかで指定できます：

1. プリセットベースの設定：

{
  "name": "プリセット名"
}

利用可能なプリセット：
– EMBER（エンバー）
– FRESH（フレッシュ）
– JUNGLE（ジャングル）
– MAGIC（マジック）
– MELON（メロン）
– MOSAIC（モザイク）
– PASTEL（パステル）
– ULTRAMARINE（ウルトラマリン）

1. カスタムカラー設定：

{
  "members": [
    {
      "color_hex": "#RRGGBB",
      "color_weight": 0.5
    }
  ]
}

• color_hex：16進数カラーコード（形式：#RRGGBB）
• color_weight：オプションの重み（0.05から1.0の間）

その他の生成設定

レスポンス形式

{
  "created": "2000-01-23T04:56:07Z",
  "data": [
    {
      "prompt": "穏やかな熱帯のビーチシーン...",
      "resolution": "1024x1024",
      "is_image_safe": true,
      "seed": 12345,
      "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
      "style_type": "REALISTIC"
    }
  ]
}

レスポンスフィールド