画像モデル上級者向け更新日
POST/v1/images/generations

API コンソール

POST/v1/images/generations
キーを確認

入力したキーで実際にリクエストを送信し、API の通常料金が適用されます。

Midjourney

リクエスト ID midjourney

プロトコル

認証

リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。

  • Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

POST /v1/images/generations

項目型必須説明
modelstring必須このモデル ID を指定します midjourney.
promptstring必須生成したい画像を説明します。
sizestring任意1536x1024 のように 幅x高さ をピクセル単位で指定します。 既定値 1024x1024.
?asyncstring任意URL のクエリパラメータです。1、true、yes で 202 と task_id を返します。省略時は結果を待ちます。

リクエスト例

API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。

例のメディア URL とアセット ID は、有効な素材に置き換えてください。

Images Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "midjourney",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

画像タスクを照会

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

レスポンスとタスク

HTTP 200 · 同期リクエストの成功

?sync=1 を指定した場合、画像 URL は data[].url から取得できます。created は UNIX 秒、id はタスク ID です。

json
{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 非同期リクエストの受付

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

?async=1 を指定した場合は、同じ API キーで GET /v1/images/tasks/{task_id} をポーリングします。status は pending、completed、failed のいずれかです。完了後は result_url から画像 URL を取得できます。

HTTP 200 · 完了したタスクの取得

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "midjourney",
  "result_url": "https://example.com/generated-image.png"
}

主なエラー

照会結果が failed の場合は error を確認してください。error_detail がある場合は再送前に retryable を確認します。

レスポンス例とエラー

接続ガイド · リクエスト項目、タスクの状態、レスポンス形式は API ガイドを参照してください。

機能と制限

  • text_to_image · 対応
  • image_to_image · 非対応
  • image_editing · 非対応
  • reference_images · 非対応
  • 制限 入力:プロンプトのみ

互換エイリアスと廃止済みリダイレクト

  • mj → midjourney (エイリアス)

モデル機能カタログ · 価格を確認