mcpField
C
civitai-orchestration

civitai-orchestration

github.com/civitaiデータ・データベース7.3k60 回インストール今日更新
リポジトリ

civitai-orchestration について

Civitai Orchestration API を検索するスキルです。ワークフロー、ジョブ、生成結果を調べる用途に向け、タグやメタデータ、日付で絞り込み、画像や動画などの出力を表示またはダウンロードできます。

主な機能

  1. 01ユーザーまたは ID でワークフローを検索
  2. 02タグとメタデータで絞り込み
  3. 03ページネーションと日付範囲検索
  4. 04ワークフロー、ジョブ、ステップの詳細を確認
  5. 05生成結果の表示またはダウンロード

活用シーン

  1. 01ユーザーの最近の生成ワークフローを探す
  2. 02ジョブの状態やスキャン結果を調査
  3. 03特定プロジェクトのワークフローを絞り込む
  4. 04ワークフローの画像や動画をダウンロード

インストール

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

$npx skills add https://github.com/civitai/civitai --skill civitai-orchestration

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

同梱ファイル.env.examplecivitai-client.js

詳細

Civitai Orchestration

Civitai Orchestration API を操作して、ワークフローの検索、ジョブの詳細の表示、生成結果の取得を行います。

クイックスタート

# Query workflows for a specific user
node .claude/skills/civitai-orchestration/civitai-client.js user 12345

# Get a specific workflow by ID
node .claude/skills/civitai-orchestration/civitai-client.js workflow <workflowId>

# Get job details with scan results (hive_csam_score, etc.)
node .claude/skills/civitai-orchestration/civitai-client.js job <jobId>

# Get step details from a workflow
node .claude/skills/civitai-orchestration/civitai-client.js step <workflowId> <stepName>

# Download result images/videos from a workflow
node .claude/skills/civitai-orchestration/civitai-client.js results <workflowId>

検索とフィルタリング

ユーザー ID で検索
# Get workflows for user 12345
node civitai-client.js user 12345

# With options
node civitai-client.js user 12345 --take=5 --excludeFailed
ワークフロー ID で検索
# Direct lookup by workflow ID
node civitai-client.js workflow 0-019be44b-181e-7a7e-ab1b-b58dc7610dca
日付範囲で検索

注： 日付によるフィルタリングの機能は、API のアクセスレベルによって制限される場合があります。

# Workflows from the last 7 days
node civitai-client.js workflows --from=2024-01-15 --to=2024-01-22

# Workflows from a specific day
node civitai-client.js workflows --from=2024-01-20 --to=2024-01-20

# Dates are assumed to be UTC. Add Z suffix for explicit UTC:
node civitai-client.js workflows --from=2024-01-20T06:00:00Z --to=2024-01-20T12:00:00Z

代替方法： --oldest を使って古い順にワークフローを取得し、その後ページネーションします：

# Get oldest workflows first
node civitai-client.js workflows --oldest --take=50
タグで検索

タグはワークフローの作成時に設定します。一般的なタグのパターン：

# Filter by a specific tag
node civitai-client.js workflows --tag=user:12345

# Note: Multiple tags can be specified (AND logic)
node civitai-client.js workflows --tag=project:myproject --tag=type:image
メタデータで検索

--query オプションでワークフローのメタデータを検索します：

# Search metadata for a string
node civitai-client.js workflows --query="portrait"
ステータスで検索

API では失敗したワークフローを除外できますが、特定のステータスによるフィルタリングには対応していません：

# Exclude failed/canceled workflows (get only succeeded/processing)
node civitai-client.js workflows --excludeFailed

# Include all statuses (default behavior)
node civitai-client.js workflows

注： 特定のステータスを見つけるには、ワークフローを取得してクライアント側でフィルタリングするか、より適切にフィルタリングできるよう、ワークフローの作成時にメタデータやタグを使用してください。

ページネーション
# Get 50 results
node civitai-client.js workflows --take=50

# Get next page using cursor from previous response
node civitai-client.js workflows --take=20 --cursor=<nextCursor>
複合フィルター
# Successful workflows for a specific tag, excluding failures
node civitai-client.js workflows \
  --tag=user:12345 \
  --excludeFailed \
  --take=50

# Get workflows with metadata search
node civitai-client.js workflows \
  --query="portrait" \
  --excludeFailed \
  --take=20

コマンドリファレンス

test

API 接続をテストし、認証情報を検証します。

node civitai-client.js test
user

Civitai ユーザー ID を指定して、そのユーザーのワークフローを検索します。

node civitai-client.js user <userId> [options]

オプション：

オプション説明
--take=<n>結果の件数（API の上限により最大 10 件）
--tag=<tag>タグでフィルタリング
--query=<text>ワークフローのメタデータを検索
--excludeFailed失敗またはキャンセルされたワークフローを除外
--oldest古い順に並べ替え
workflows

オプションのフィルターを指定して、ワークフローの一覧表示と検索を行います。

node civitai-client.js workflows [options]

オプション：

オプション説明
--tag=<tag>タグでフィルタリング（複数指定可能）
--query=<text>ワークフローのメタデータを検索
--excludeFailed失敗またはキャンセルされたワークフローを除外
--oldest古い順に並べ替え
--take=<n>結果の件数（デフォルト：20）
--cursor=<cursor>ページネーションカーソル
--from=<date>開始日（サポートが制限される場合があります）
--to=<date>終了日（サポートが制限される場合があります）
workflow

特定のワークフローの詳細を取得します。

node civitai-client.js workflow <workflowId> [--wait]

オプション：

オプション説明
--wait完了まで待機／ポーリングします（タイムアウトあり）
job

イベントコンテキストのスキャン結果を含む、特定のジョブの詳細を取得します。

これはコンテンツモデレーションの結果を調査する際に便利です。lastEvent.context には、hive_csam_score や hive_vlm_summary などのスコアが含まれます。

node civitai-client.js job <jobId> [--raw]

オプション：

オプション説明
--raw整形済みの概要ではなく、生の JSON を出力

出力例：

Job Summary:
  ID: 58de87d7-d594-4d71-ae43-dd8fc1bcbd23
  Type: TextToImageV2
  Workflow ID: 8484131-20260121222126332

Prompt Classification: sexual, young, scan

Results (2 blob(s)):
  - JNFDW54JNTATNW42HACYCWSQP0.jpeg (available: true)

Last Event:
  Type: Succeeded
  Provider: ValdiAI

Event Context (scan results, metrics):
  ** hive_csam_score: 0.00 %, 0.00 %
  ** hive_vlm_summary: X, No_Child
step

ワークフロー内の特定のステップの詳細を取得します。

node civitai-client.js step <workflowId> <stepName>
results

ワークフローの結果（画像／動画）をダウンロードまたは表示します。

node civitai-client.js results <workflowId> [--download] [--dir=<path>]

オプション：

オプション説明
--download結果ファイルをダウンロード
--dir=<path>ダウンロード先のディレクトリ（デフォルト：./civitai-downloads）
blob

オプションで NSFW コンテンツを処理しながら、ID を指定して blob（画像／動画）を取得します。

node civitai-client.js blob <blobId> [--download] [--nsfw]

環境変数

.claude/skills/civitai-orchestration/.env に保存されています：

CIVITAI_API_TOKEN=your_bearer_token
CIVITAI_API_URL=https://orchestration.civitai.com

API リファレンス

ワークフローのクエリパラメーター

ワークフローのエンドポイントでは、次のクエリパラメーターを使用できます：

  • tags - フィルタリングするタグの配列
  • query - ワークフローのメタデータを検索
  • fromDate / toDate - 日付範囲（ISO 8601）。サポートが制限される場合があります
  • cursor - ページネーションカーソル
  • take - 結果の件数（デフォルト：100）
  • excludeFailed - 失敗／期限切れ／キャンセルされたワークフローを除外（ブール値）
  • ascending - 古い順に並べ替え（ブール値）
ワークフローのステータス
ステータス説明
preparingワークフローを準備中
scheduled実行がスケジュール済み
processing実行中
succeeded正常に完了
failedエラーにより失敗
canceledキャンセル済み
expiredタイムアウト
deleted削除済み
ステップタイプ（レシピ）

遭遇する可能性のある画像／動画生成ステップ：

  • textToImage - テキストから画像を生成
  • imageGen - 汎用的な画像生成
  • videoGen - 動画生成
  • videoEnhancement - 動画のアップスケール／画質向上
  • videoFrameExtraction - 動画からフレームを抽出
  • videoUpscaler - 動画をアップスケール
  • videoInterpolation - フレーム補間
  • convertImage - 画像形式を変換
  • comfy - ComfyUI ワークフローの実行
  • preprocessImage - 画像に対する ControlNet 前処理（出力は画像の blob）
  • preprocessVideo - 動画に対する ControlNet 前処理（出力は VideoBlob の blob）
  • aceStepAudio - 音声生成。blob は AudioBlob、カバー画像モードでは VideoBlob です
  • miniMaxMusic3 - 音楽生成

例

ユーザーの最近の画像生成を確認する
# Get user 12345's recent workflows
node civitai-client.js user 12345

# Exclude failed jobs
node civitai-client.js user 12345 --excludeFailed
ワークフローを取得して結果を表示する
# Get workflow details
node civitai-client.js workflow abc123-def456

# View/download results
node civitai-client.js results abc123-def456 --download --dir=./my-images
ワークフローをページネーションする
# First page
node civitai-client.js workflows --take=10

# Next page (use cursor from previous response)
node civitai-client.js workflows --take=10 --cursor=<nextCursor>

エラー処理

エラーコード意味
401トークンが無効または期限切れです。CIVITAI_API_TOKEN を確認してください
404ワークフロー／ジョブが見つかりません
429レート制限に達しました。再試行する前にお待ちください
422パラメーターが無効です

出力

user コマンドは、次の情報を含むワークフローの概要を表示します：

  • ワークフロー ID、ステータス、タイムスタンプ
  • ステップタイプ（textToImage、videoGen、comfy など）
  • テキストから画像を生成する際のプロンプト

未加工の JSON 出力には、workflow コマンドを使用します：

node civitai-client.js workflow <workflowId>

コメント

Markdown 対応