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

ideogram/ideogram-v3/reframe

1. はじめに

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/reframe \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "",
    "resolution": "1152:864 (4:3)"
  }'

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/reframe \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "",
    "resolution": "1152:864 (4:3)"
  }'

ステータスの確認

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",
    "resolution"
  ],
  "properties": {
    "image": {
      "title": "image",
      "description": "",
      "type": "string"
    },
    "resolution": {
      "title": "Aspect Ratio (W:H)",
      "description": "",
      "type": "string",
      "default": "1152:864 (4:3)",
      "enum": [
        "1536:640 (12:5)",
        "1536:576 (8:3)",
        "1536:512 (3:1)",
        "1472:704 (23:11)",
        "1472:640 (23:10)",
        "1472:576 (23:9)",
        "1408:704 (2:1)",
        "1408:640 (11:5)",
        "1408:576 (22:9)",
        "1344:768 (7:4)",
        "1344:704 (21:11)",
        "1344:640 (21:10)",
        "1312:736 (41:23)",
        "1280:800 (8:5)",
        "1280:768 (5:3)",
        "1280:704 (20:11)",
        "1248:832 (3:2)",
        "1216:832 (19:13)",
        "1216:768 (19:12)",
        "1216:704 (19:11)",
        "1152:896 (9:7)",
        "1152:864 (4:3)",
        "1152:832 (18:13)",
        "1152:704 (18:11)",
        "1120:896 (5:4)",
        "1088:960 (17:15)",
        "1088:896 (17:14)",
        "1088:832 (17:13)",
        "1088:768 (17:12)",
        "1024:1024 (1:1)",
        "1024:960 (16:15)",
        "1024:896 (8:7)",
        "1024:832 (16:13)",
        "960:1088 (15:17)",
        "960:1024 (15:16)",
        "960:896 (15:14)",
        "960:832 (15:13)",
        "896:1152 (7:9)",
        "896:1120 (4:5)",
        "896:1088 (14:17)",
        "896:1024 (7:8)",
        "896:960 (14:15)",
        "864:1152 (3:4)",
        "832:1248 (2:3)",
        "832:1216 (13:19)",
        "832:1152 (13:18)",
        "832:1088 (13:17)",
        "832:1024 (13:16)",
        "832:960 (13:15)",
        "800:1280 (5:8)",
        "768:1344 (4:7)",
        "768:1280 (3:5)",
        "768:1216 (12:19)",
        "768:1088 (12:17)",
        "736:1312 (23:41)",
        "704:1472 (11:23)",
        "704:1408 (1:2)",
        "704:1344 (11:21)",
        "704:1280 (11:20)",
        "704:1216 (11:19)",
        "704:1152 (11:18)",
        "640:1536 (5:12)",
        "640:1472 (10:23)",
        "640:1408 (5:11)",
        "640:1344 (10:21)",
        "576:1536 (3:8)",
        "576:1472 (9:23)",
        "576:1408 (9:22)",
        "512:1536 (1:3)"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    },
    "rendering_speed": {
      "title": "Rendering Speed",
      "description": "",
      "type": "string",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ],
      "default": "BALANCED"
    },
    "color_palette": {
      "title": "Color Palette",
      "description": "",
      "type": "object"
    },
    "style": {
      "title": "Style",
      "description": "",
      "type": "object"
    }
  }
}

出力スキーマ

{
  "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/reframe を実行します。受け付ける入出力はモデルのスキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/reframe \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "",
    "resolution": "1152:864 (4:3)"
  }'

3. API リファレンス

リクエストの送信

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v3/reframe \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image": "",
    "resolution": "1152:864 (4:3)"
  }'

ステータスの確認

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",
    "resolution"
  ],
  "properties": {
    "image": {
      "title": "image",
      "description": "",
      "type": "string"
    },
    "resolution": {
      "title": "Aspect Ratio (W:H)",
      "description": "",
      "type": "string",
      "default": "1152:864 (4:3)",
      "enum": [
        "1536:640 (12:5)",
        "1536:576 (8:3)",
        "1536:512 (3:1)",
        "1472:704 (23:11)",
        "1472:640 (23:10)",
        "1472:576 (23:9)",
        "1408:704 (2:1)",
        "1408:640 (11:5)",
        "1408:576 (22:9)",
        "1344:768 (7:4)",
        "1344:704 (21:11)",
        "1344:640 (21:10)",
        "1312:736 (41:23)",
        "1280:800 (8:5)",
        "1280:768 (5:3)",
        "1280:704 (20:11)",
        "1248:832 (3:2)",
        "1216:832 (19:13)",
        "1216:768 (19:12)",
        "1216:704 (19:11)",
        "1152:896 (9:7)",
        "1152:864 (4:3)",
        "1152:832 (18:13)",
        "1152:704 (18:11)",
        "1120:896 (5:4)",
        "1088:960 (17:15)",
        "1088:896 (17:14)",
        "1088:832 (17:13)",
        "1088:768 (17:12)",
        "1024:1024 (1:1)",
        "1024:960 (16:15)",
        "1024:896 (8:7)",
        "1024:832 (16:13)",
        "960:1088 (15:17)",
        "960:1024 (15:16)",
        "960:896 (15:14)",
        "960:832 (15:13)",
        "896:1152 (7:9)",
        "896:1120 (4:5)",
        "896:1088 (14:17)",
        "896:1024 (7:8)",
        "896:960 (14:15)",
        "864:1152 (3:4)",
        "832:1248 (2:3)",
        "832:1216 (13:19)",
        "832:1152 (13:18)",
        "832:1088 (13:17)",
        "832:1024 (13:16)",
        "832:960 (13:15)",
        "800:1280 (5:8)",
        "768:1344 (4:7)",
        "768:1280 (3:5)",
        "768:1216 (12:19)",
        "768:1088 (12:17)",
        "736:1312 (23:41)",
        "704:1472 (11:23)",
        "704:1408 (1:2)",
        "704:1344 (11:21)",
        "704:1280 (11:20)",
        "704:1216 (11:19)",
        "704:1152 (11:18)",
        "640:1536 (5:12)",
        "640:1472 (10:23)",
        "640:1408 (5:11)",
        "640:1344 (10:21)",
        "576:1536 (3:8)",
        "576:1472 (9:23)",
        "576:1408 (9:22)",
        "512:1536 (1:3)"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    },
    "rendering_speed": {
      "title": "Rendering Speed",
      "description": "",
      "type": "string",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ],
      "default": "BALANCED"
    },
    "color_palette": {
      "title": "Color Palette",
      "description": "",
      "type": "object"
    },
    "style": {
      "title": "Style",
      "description": "",
      "type": "object"
    }
  }
}

出力スキーマ

{
  "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.0 | Reframe 画像変換ツール

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ

Ideogram 3.0 | Reframe 画像変換ツール

目次

1. はじめに

2. 認証

3. API リファレンス

リクエストの送信

ステータスの確認

結果の取得

リクエストのキャンセル

4. ファイル入力

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

5. スキーマ

入力スキーマ

出力スキーマ