Ideogram Ideogram 3.0 API | 料金とドキュメント

ideogram/ideogram-v3/remix

プロンプトで画像をリミックスし、画像の重み、アスペクト比、シード、速度などを設定します。

1. はじめに

RunComfy の API で ideogram/ideogram-v3/remix を実行します。受け付ける入出力はモデルのスキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/remix \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png",
    "prompt": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
  }'

2. 認証

環境変数 YOUR_API_TOKEN に API キーを設定してください（プロフィールでキー管理）。すべてのリクエストの Authorization ヘッダーに Bearer トークンとして付与： Authorization: Bearer $YOUR_API_TOKEN。

3. API リファレンス

リクエストの送信

非同期の生成ジョブを送信すると、すぐに request_id と、ステータス確認・結果取得・キャンセル用の URL が返ります。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/remix \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png",
    "prompt": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
  }'

ステータスの確認

request_id の現在の状態を取得します（"in_queue"、"in_progress"、"completed"、"cancelled"）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

結果の取得

指定した request_id の最終出力とメタデータを取得します。ジョブが未完了の場合は現在の状態が返るため、ポーリングを続けられます。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

リクエストのキャンセル

request_id でキュー中のジョブをキャンセルします。実行中のジョブはキャンセルできません。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. ファイル入力

ホスト済みファイル（URL）

公開到達可能な HTTPS URL を指定してください。サーバー側からの取得が可能で、ログイン不要であること、レート制限やボット遮断がないことを確認してください。目安：画像 ≤ 50 MB（約 4K）、動画 ≤ 100 MB（720p で約 2～5 分）。非公開アセットは安定した URL またはプリサイン URL を推奨します。

5. スキーマ

入力スキーマ

{
  "type": "object",
  "title": "入力スキーマ",
  "required": [
    "image",
    "prompt"
  ],
  "properties": {
    "image": {
      "title": "画像",
      "description": "リミックスに使用する必須の元画像です。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png"
    },
    "prompt": {
      "title": "プロンプト",
      "description": "加えたい変更を記述する必須項目です。",
      "type": "string",
      "default": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
    },
    "image_weight": {
      "title": "画像の重み",
      "description": "1～100の整数で設定します。初期値は50です。",
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "default": 50
    },
    "seed": {
      "title": "シード",
      "description": "0～2147483647の整数です。初期値は`44863417`です。",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "default": 44863417
    },
    "aspect_ratio": {
      "title": "アスペクト比（幅：高さ）",
      "description": "`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`Custom`から選択します。初期値は`16:9`です。",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "Custom"
      ],
      "default": "16:9"
    },
    "rendering_speed": {
      "title": "レンダリング速度",
      "description": "`TURBO`、`BALANCED`、`QUALITY`から選択します。初期値は`BALANCED`です。",
      "type": "string",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ],
      "default": "BALANCED"
    },
    "magic_prompt": {
      "title": "プロンプト拡張",
      "description": "`AUTO`、`ON`、`OFF`から選択します。初期値は`ON`です。",
      "type": "string",
      "default": "ON",
      "enum": [
        "AUTO",
        "ON",
        "OFF"
      ]
    },
    "negative_prompt": {
      "title": "ネガティブプロンプト",
      "description": "避けたい要素を任意で記述します。",
      "type": "string",
      "default": ""
    },
    "color_palette": {
      "title": "カラーパレット",
      "description": "カラーパレットを設定します。初期値は`Ember`です。",
      "type": "object",
      "default": {
        "name": "Ember"
      }
    },
    "style": {
      "title": "スタイル",
      "description": "スタイルを設定します。初期タイプは`Auto`です。",
      "type": "object",
      "default": {
        "style_type": "Auto"
      }
    }
  }
}

出力スキーマ

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "単一画像 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "単一動画 URL"
      },
      "images": {
        "type": "array",
        "description": "複数画像 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "複数動画 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfyは最高の ComfyUI プラットフォームです。次のものを提供しています: ComfyUIオンライン環境とサービス、および ComfyUIワークフロー魅力的なビジュアルが特徴です。 RunComfyはまた提供します AI Models, アーティストが最新のAIツールを活用して素晴らしいアートを作成できるようにする。

1. はじめに

RunComfy の API で ideogram/ideogram-v3/remix を実行します。受け付ける入出力はモデルのスキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/remix \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png",
    "prompt": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
  }'

3. API リファレンス

リクエストの送信

非同期の生成ジョブを送信すると、すぐに request_id と、ステータス確認・結果取得・キャンセル用の URL が返ります。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/remix \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png",
    "prompt": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
  }'

ステータスの確認

request_id の現在の状態を取得します（"in_queue"、"in_progress"、"completed"、"cancelled"）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

結果の取得

指定した request_id の最終出力とメタデータを取得します。ジョブが未完了の場合は現在の状態が返るため、ポーリングを続けられます。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

リクエストのキャンセル

request_id でキュー中のジョブをキャンセルします。実行中のジョブはキャンセルできません。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

{
  "type": "object",
  "title": "入力スキーマ",
  "required": [
    "image",
    "prompt"
  ],
  "properties": {
    "image": {
      "title": "画像",
      "description": "リミックスに使用する必須の元画像です。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7018/media-files/usecase2-1-input.png"
    },
    "prompt": {
      "title": "プロンプト",
      "description": "加えたい変更を記述する必須項目です。",
      "type": "string",
      "default": "Transform into a dystopian archive: dim blue-green glow from light panels, same composition but with metal shelving, flickering neon signs outside the window, the cat starrisng at a surveillance drone"
    },
    "image_weight": {
      "title": "画像の重み",
      "description": "1～100の整数で設定します。初期値は50です。",
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "default": 50
    },
    "seed": {
      "title": "シード",
      "description": "0～2147483647の整数です。初期値は`44863417`です。",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "default": 44863417
    },
    "aspect_ratio": {
      "title": "アスペクト比（幅：高さ）",
      "description": "`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`Custom`から選択します。初期値は`16:9`です。",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "Custom"
      ],
      "default": "16:9"
    },
    "rendering_speed": {
      "title": "レンダリング速度",
      "description": "`TURBO`、`BALANCED`、`QUALITY`から選択します。初期値は`BALANCED`です。",
      "type": "string",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ],
      "default": "BALANCED"
    },
    "magic_prompt": {
      "title": "プロンプト拡張",
      "description": "`AUTO`、`ON`、`OFF`から選択します。初期値は`ON`です。",
      "type": "string",
      "default": "ON",
      "enum": [
        "AUTO",
        "ON",
        "OFF"
      ]
    },
    "negative_prompt": {
      "title": "ネガティブプロンプト",
      "description": "避けたい要素を任意で記述します。",
      "type": "string",
      "default": ""
    },
    "color_palette": {
      "title": "カラーパレット",
      "description": "カラーパレットを設定します。初期値は`Ember`です。",
      "type": "object",
      "default": {
        "name": "Ember"
      }
    },
    "style": {
      "title": "スタイル",
      "description": "スタイルを設定します。初期タイプは`Auto`です。",
      "type": "object",
      "default": {
        "style_type": "Auto"
      }
    }
  }
}

出力スキーマ

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "単一画像 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "単一動画 URL"
      },
      "images": {
        "type": "array",
        "description": "複数画像 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "複数動画 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

プロンプトで画像をリミックスし、画像の重み、アスペクト比、シード、速度などを設定します。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

プロンプトで画像をリミックスし、画像の重み、アスペクト比、シード、速度などを設定します。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

Ideogram 3 Remix：画像の重みとアスペクト比を設定 | RunComfy

プロンプトで画像をリミックスし、画像の重み、アスペクト比、シード、速度などを設定します。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ

Ideogram 3 Remix：画像の重みとアスペクト比を設定 | RunComfy

プロンプトで画像をリミックスし、画像の重み、アスペクト比、シード、速度などを設定します。

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

ホスト済みファイル（URL）

5. スキーマ

入力スキーマ

出力スキーマ