mj_turbo_inpaint

mj-turbo-inpaint の技術仕様

mj-turbo-inpaint とは？

mj-turbo-inpaint は、迅速な画像編集に特化したMidjourneyスタイルのインペインティングモデル／ワークフローに対するCometAPIのプラットフォーム識別子です。公開されているMidjourneyのドキュメントでは、エディター体験の一部としてインペインティングが説明されており、ユーザーが領域を消去または選択して、その領域のみを新しいプロンプトから再生成し、画像の残りを維持します。Midjourneyは、通常のFastモードよりも大幅に高速に画像を生成するよう設計されたTurboモードについてもドキュメント化しており、GPUコストは高くなります。

Midjourney自体は広く利用可能な公式の公開APIを提供していないため、サードパーティの統合では一般的に中間APIを通じてMidjourney連携の操作が公開されます。公開されたサードパーティのMidjourney APIドキュメントでも、インペインティングのサポートと別個のTurboルーティングが明示されており、これはCometAPIのモデル命名パターン mj-turbo-inpaint と整合します。これらの情報に基づき、このモデルIDは、純粋なテキストから画像への生成モデルではなく、局所的な画像編集のためのTurbo速度のMidjourney互換インペインティングエンドポイントと理解されるべきです。

実務では、既存画像の大部分を維持しながら特定の領域のみを選択的に変更したい場合に mj-turbo-inpaint を使用します。例えば、オブジェクトの置換、衣装の変更、顔アクセサリーの調整、背景領域の精緻化、不要な画像要素の修復などです。この解釈は、Midjourneyのエディター／インペインティングの挙動とサードパーティAPIにおけるTurboインペインティングの記述からの推測です。

mj-turbo-inpaint の主な機能

• 局所的な画像編集: 選択した部分のみを再生成し、元のフレーミングやスタイル、未編集領域を保持するインペインティングワークフロー向けに設計。
• プロンプト誘導の変更: 編集領域内に何を表示するかを自然言語で指示でき、制御されたクリエイティブな変更に適合。
• ターボ速度の実行: MidjourneyのTurboモードは、標準のFastモードより高速なGPUプールを用いることが文書化されており、低レイテンシの編集ワークフローに位置づけ。
• クリエイティブな反復支援: インペインティングとTurboの組み合わせにより、コンセプト開発、アセットの洗練、デザインレビューのサイクルで、領域別のバリエーションを素早く試行可能。
• 修復と置換タスクに有用: 目障りな要素の除去、オブジェクトの入れ替え、背景の更新、構図の修正を、画像全体を再生成せずに実施。
• アグリゲーター適合のアクセス: CometAPIは統一されたOpenAI互換インターフェースを提供するため、mj-turbo-inpaint は他の画像・言語モデルと同一の統合パターンで利用可能。

mj-turbo-inpaint へのアクセスと統合方法

ステップ1: APIキーの登録

CometAPIアカウントに登録し、ダッシュボードでAPIキーを生成します。CometAPIはモデルカタログに対して統一資格情報を使用し、公開ドキュメントではOpenAI互換と説明されているため、mj-turbo-inpaint を含む対応モデルで同じキー形式が使用されます。キーは安全に保管し、クライアント側コードでの露出を避けてください。

ステップ2: mj-turbo-inpaint APIへのリクエスト送信

クライアントをCometAPIのOpenAI互換ベースURLに向け、モデル識別子として mj-turbo-inpaint を用いてリクエストを送信します。CometAPIの公開ドキュメントでは、互換クライアントのベースURLとして https://api.cometapi.com/v1 が示されています。画像ワークフローでは、CometAPIのモデル記事にOpenAIスタイルの画像エンドポイント /v1/images/generations や /v1/images/edits が参照されます。インペインティングモデルである mj-turbo-inpaint には、editsスタイルのワークフローパターンが該当します。

import os
import requests

url = "https://api.cometapi.com/v1/images/edits"
headers = {
    "Authorization": f"Bearer {os.environ['COMETAPI_KEY']}",
}

files = {
    "image": open("input.png", "rb"),
    # Include a mask file as required by your workflow if supported
    # "mask": open("mask.png", "rb"),
}

data = {
    "model": "mj-turbo-inpaint",
    "prompt": "Replace the selected area with a polished silver helmet, cinematic lighting, realistic detail"
}

response = requests.post(url, headers=headers, files=files, data=data, timeout=300)
print(response.json())

ステップ3: 結果の取得と検証

JSONレスポンスを解析し、返された画像URLまたはエンコードされた出力を取得して、編集領域がプロンプトに沿っていること、未編集領域が元の画像と一貫していることを検証します。運用環境では、受け取るファイルタイプ、解像度、レイテンシ、非同期ジョブのメタデータを検証してください。ワークフローが精密なマスクや領域制御に依存する場合は、複数のマスクとプロンプトでテストし、mj-turbo-inpaint がパイプライン内でどのように動作するかを確認します。CometAPIの統一APIアプローチにより、この検証ステップは他の対応モデルと同じ統合スタック内で容易に自動化できます。