完全なワークフロー例

複数のエンドポイントをつなげたエンドツーエンドの例です。すべてのコマンドで $KEY をあなたの API token に、$HOST を実際のプラットフォームのドメインに置き換えてください。

export KEY="sk-your-api-key"
export HOST="https://api.apimart.ai"

フロー A：基本のテキストから画像（imagine → upscale）

# 1. imagine で 4 枚の画像を生成
curl -sS -X POST "$HOST/v1/midjourney/generations/imagine" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "prompt": "a futuristic city at sunset, photorealistic, cinematic lighting",
    "version": "8.1", "size": "16:9", "speed": "fast", "stylize": 250
  }'
# → {"code":200,"data":[{"task_id":"task_01KQVZAPBW...","status":"submitted"}]}

# 2. SUCCESS になるまでポーリングして照会（約 30〜60s）
curl -sS "$HOST/v1/midjourney/task_01KQVZAPBW..." -H "Authorization: Bearer $KEY"
# → SUCCESS、grid_image_url + 4 枚の image_urls + buttons(U1-U4 / V1-V4 / 🔄) を含む

# 3. upscale で 2 枚目を選択（ローカル合成、ミリ秒単位で SUCCESS）
curl -sS -X POST "$HOST/v1/midjourney/generations/upscale" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"task_id": "task_01KQVZAPBW...", "index": 2}'
# → 照会して単一画像 image_urls[0] を取得

フロー B：参照画像 → 強い変体 → アップスケール

# 1. 参照画像付き imagine
curl -sS -X POST "$HOST/v1/midjourney/generations/imagine" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "prompt": "turn this product into a luxury studio photo",
    "image_urls": ["https://your-cdn.example.com/product.png"],
    "iw": 1.5, "size": "1:1"
  }'

# 2. 結果に対して強い変体を実行
curl -sS -X POST "$HOST/v1/midjourney/generations/high-variation" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"task_id": "task_01XXX...", "index": 1, "speed": "fast"}'

# 3. 変体のいずれかを upscale
curl -sS -X POST "$HOST/v1/midjourney/generations/upscale" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"task_id": "task_02_variant...", "index": 3}'

前提：先に imagine + upscale で単一画像タスクを取得しておく（フロー A 参照）。

# 1. inpaint を送信 → MODAL に入る
curl -sS -X POST "$HOST/v1/midjourney/generations/inpaint" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"task_id": "task_02_upscaled..."}'
# → {"data":[{"task_id":"task_03_inpaint...","status":"modal"}]}
#   status=modal に注意。タスクは mask の補完を待っている。30 分でタイムアウトすると自動 CANCEL + 返金

# 2. フロントエンドで mask を描き（白=リペイント領域、透明=保持）、自分の OSS にアップロードして mask_url を取得（公開ネットワークから到達可能であること）

# 3. modal を送信して完了
curl -sS -X POST "$HOST/v1/midjourney/generations/modal" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "task_id": "task_03_inpaint...",
    "prompt": "replace the selected area with a red leather sofa",
    "mask_url": "https://your-oss.example.com/mask-abc.png"
  }'
# → 同じ task_id、status が submitted に変わる。4. 60〜90s ポーリング後に SUCCESS、4 枚の局部リペイント候補を含む

フロー D：拡張（Zoom Out）

# mask 不要で直接生成（Outpaint / CustomZoom はいずれも MODAL に入らない）
curl -sS -X POST "$HOST/v1/midjourney/generations/zoom" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"task_id": "task_02_upscaled...", "zoom_ratio": 1.5, "speed": "fast"}'

フロー E：画像から動画（i2v）

# 720p 高解像度 + batch=4（4 倍課金）
curl -sS -X POST "$HOST/v1/midjourney/generations/video" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "prompt": "city traffic at night, neon reflections, slow camera dolly",
    "image_urls": ["https://your-cdn.example.com/city.jpg"],
    "video_type": "vid_1.1_i2v_720", "batch_size": 4
  }'
# 実消費 = midjourney@video-720p × 4

# 開始・終了フレームの transition（end_url を指定すると自動的に start_end に昇格）
curl -sS -X POST "$HOST/v1/midjourney/generations/video" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "prompt": "transition smoothly from sunrise to sunset",
    "image_urls": ["https://your-cdn.example.com/sunrise.jpg"],
    "end_url": "https://your-cdn.example.com/sunset.jpg",
    "video_type": "vid_1.1_i2v_720"
  }'

汎用ツール：Python クライアントのラッパー

import time
import httpx

API_KEY = "sk-..."
HOST = "https://api.apimart.ai"

class MjClient:
    def __init__(self):
        self.client = httpx.Client(
            base_url=HOST,
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        )

    def imagine(self, prompt, **params):
        r = self.client.post("/v1/midjourney/generations/imagine",
                             json={"prompt": prompt, **params})
        return r.json()["data"][0]["task_id"]

    def upscale(self, task_id, index):
        r = self.client.post("/v1/midjourney/generations/upscale",
                             json={"task_id": task_id, "index": index})
        return r.json()["data"][0]["task_id"]

    def query(self, task_id):
        return self.client.get(f"/v1/midjourney/{task_id}").json()

    def wait(self, task_id, timeout=180):
        deadline = time.time() + timeout
        while time.time() < deadline:
            t = self.query(task_id)
            if t["status"] in ("SUCCESS", "FAILURE"):
                return t
            if t["status"] == "MODAL":
                raise RuntimeError(f"task {task_id} は /modal が必要")
            time.sleep(3)
        raise TimeoutError(task_id)


mj = MjClient()
imagine_id = mj.imagine("a cat", version="8.1", speed="fast", size="16:9")
mj.wait(imagine_id)
upscale_id = mj.upscale(imagine_id, 2)
print(mj.wait(upscale_id)["image_urls"][0])

汎用ツール：TypeScript ラッパー

const API_KEY = "sk-...";
const HOST = "https://api.apimart.ai";

async function mj(path: string, body: any) {
  const r = await fetch(`${HOST}${path}`, {
    method: "POST",
    headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  return r.json();
}

async function query(id: string) {
  const r = await fetch(`${HOST}/v1/midjourney/${id}`, {
    headers: { "Authorization": `Bearer ${API_KEY}` },
  });
  return r.json();
}

async function waitTask(id: string, timeoutMs = 180_000) {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const t = await query(id);
    if (t.status === "SUCCESS" || t.status === "FAILURE") return t;
    if (t.status === "MODAL") throw new Error(`/modal が必要: ${id}`);
    await new Promise((r) => setTimeout(r, 3000));
  }
  throw new Error(`タイムアウト: ${id}`);
}

const r = await mj("/v1/midjourney/generations/imagine",
                   { prompt: "a cat", version: "8.1", speed: "fast" });
const result = await waitTask(r.data[0].task_id);
console.log(result.image_urls);

ステートマシン

submit → NOT_START(0%) → SUBMITTED(5-30%) → IN_PROGRESS(~99%) → SUCCESS(100%)
                                                              ↘ FAILURE(100%) → 自動返金
inpaint / CustomZoom → MODAL(15%) ──POST /modal {mask_url, prompt}──▶ SUBMITTED → ...
                          └ 30min タイムアウト → CANCEL + 返金

​フロー A：基本のテキストから画像（imagine → upscale）

​フロー B：参照画像 → 強い変体 → アップスケール

​フロー C：局部リペイント（inpaint + modal の 2 ステップ）

​フロー D：拡張（Zoom Out）

​フロー E：画像から動画（i2v）

​汎用ツール：Python クライアントのラッパー

​汎用ツール：TypeScript ラッパー

​ステートマシン

フロー A：基本のテキストから画像（imagine → upscale）

フロー B：参照画像 → 強い変体 → アップスケール

フロー C：局部リペイント（inpaint + modal の 2 ステップ）

フロー D：拡張（Zoom Out）

フロー E：画像から動画（i2v）

汎用ツール：Python クライアントのラッパー

汎用ツール：TypeScript ラッパー

ステートマシン