mcpField
A
atlas-cloud

atlas-cloud

github.com/calesthioクリエイティブ・メディア73.0k663 回インストール1 日前に更新
リポジトリ

atlas-cloud について

OpenMontageで画像・動画制作をAtlas Cloud経由で実行するためのスキルです。対応モデルのルート、入力処理、実行前チェック、結果の由来を説明し、失敗時はプロバイダーを切り替えずに報告します。

主な機能

  1. 01Atlasの画像・動画ルート
  2. 02モデルカタログと操作の確認
  3. 03画像・メディア参照入力
  4. 04予測のポーリングと出力取得
  5. 05結果の由来とコスト見積もり

活用シーン

  1. 01Atlas Cloud経由で制作を実行
  2. 02カタログ対応モデルの操作選択
  3. 03画像・動画の参照入力を送信
  4. 04生成物と呼び出し情報の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/calesthio/openmontage --skill atlas-cloud

インストール後、Claude Code で/atlas-cloudを入力して読み込まれたか確認します。

詳細

Atlas Cloud

完全な制作ワークフローを実行するには、image_selector または video_selector にルーティングします。ユーザーが Atlas Cloud または正確な Atlas モデルを指定した場合は、atlas_image または atlas_video を直接呼び出します。Atlas へのリクエストを、ベンダーの直接エンドポイントに置き換えてはいけません。

ATLASCLOUD_API_KEY を設定します。互換性のため、エイリアス ATLAS_CLOUD_API_KEY と ATLAS_API_KEY も使用できます。

有料呼び出しの前に毎回確認すること

  1. tool.get_info()["model_catalog"] を読み取ります。検索コレクションから利用可能なモデルを推測したり、タスクサフィックスを作り出したりしてはいけません。
  2. カタログでサポートされている正確なモデル ID と操作を選択します。
  3. 送信前に、Atlas ツール、プロバイダー、正確なモデル、リクエスト数、推定コストを伝えます。
  4. 便利な場合はローカルパスを入力に使用します。ツールが Atlas 経由でアップロードします。
  5. 出力をアクティブな projects/<project-id>/ ツリー内に保存し、内容を確認します。

動画ルート

ファミリー操作正確なルートに関する注意事項
Seedance 2.5テキスト、画像、参照bytedance/seedance-2.5/{text,image,reference}-to-video。画像モードでは image と任意の last_image を使用します。参照モードでは最大 30 枚の画像、10 本の動画、10 個の音声（音声のみを含む）を受け付けます。4～30 秒。$0.134/秒
Seedance 2.0テキスト、画像、参照bytedance/seedance-2.0/{text,image,reference}-to-video。4～15 秒。$0.112/秒
Gemini Omni Flashテキスト、画像、参照、動画編集標準ルートでは google/gemini-omni-flash/... を使用します。テキスト、画像、参照のみ、開発者向けルートがあります。標準の画像モードでは image を 1 つ使用し、標準の参照モードでは images を使用します。開発者向けの参照モードでは、video_clips オブジェクトを 1 つ指定する必要があります。
MiniMax H3テキスト、画像、参照minimax/h3/{text,image,reference}-to-video。画像モードでは任意の end_image を使用できます。参照モードでは refers オブジェクトが必要です。4～15 秒。768P/2K。$0.10/秒

OpenMontage の標準フィールドを使用します。

tool.execute({
    "prompt": "...",
    "model": "minimax/h3/reference-to-video",
    "operation": "reference_to_video",
    "duration": 10,
    "resolution": "2K",
    "reference_images": ["projects/demo/character.png"],
    "reference_audios": ["projects/demo/performance.wav"],
    "output_path": "projects/demo/h3.mp4",
})

Gemini の開発者向け参照動画では、url、start、ends を含む video_clips オブジェクトを渡します。H3 では、呼び出し元が正規化済みの reference_images、reference_videos、reference_audios を渡せます。ツールがこれらを refers に変換します。

長さ、解像度、アスペクト比を黙って制限してはいけません。無効な値の場合は、サポートされている選択肢をエラーに含め、課金前に失敗させる必要があります。

画像ルート

ファミリー操作正確なルートに関する注意事項
Seedream 5.0 Pro生成、編集、分解bytedance/seedream-v5.0-pro/text-to-image、/edit、/layer-decomposition。編集では最大 10 枚の画像を受け付けます。サイズには WIDTH*HEIGHT を使用します
Seedream 5.0 Lite編集bytedance/seedream-v5.0-lite/edit。稼働中の Lite テキストから画像へのルートが存在するとは想定しないでください。最大 14 枚の画像を受け付けます
GPT Image 2生成、編集openai/gpt-image-2/text-to-image、/edit。サイズには WIDTHxHEIGHT を使用します。編集では最大 10 枚の画像を受け付けます
Nano Banana 2生成、編集google/nano-banana-2/text-to-image、/edit。アスペクト比と 1k/2k/4k の解像度を使用します。編集では最大 14 枚の画像を受け付けます

generation_mode に generate、edit、または decompose を設定します。ソース画像は image_path、image_paths、image_url、または image_urls で指定できます。

tool.execute({
    "prompt": "Replace the packaging with matte cobalt glass; preserve the logo",
    "model": "google/nano-banana-2/edit",
    "generation_mode": "edit",
    "image_paths": ["projects/campaign/source.png"],
    "resolution": "2k",
    "output_path": "projects/campaign/revised.png",
})

結果と失敗時の契約

両ツールは Atlas に送信し、返された予測 ID をポーリングして、すべての出力をダウンロードします。また、プロバイダー、正確なモデル、予測 ID、送信したパラメーター、ソース URL、成果物パス、推定コストを含む ToolResult の来歴情報を返します。キーの欠落、未サポートのルート、無効な列挙値、メディア入力の欠落、予測の失敗、タイムアウト、ダウンロードの失敗が発生した場合は、プロバイダーを切り替えずに失敗結果を返す必要があります。

バッチの見積もりまたは実行の直前に、機械可読なモデルページ（Accept: text/markdown）で最新の料金とスキーマを確認します。

コメント

Markdown 対応