imaginevid-ai-generation

ImagineVid AI 生成

機能カタログを使用し、プロバイダ固有のAPIは使わないでください。この公開スキルは、ホストがImagineVidのOAuthリモートMCPを https://imaginevid.io/api/mcp に接続していることを前提としています。OAuthと同意処理はホストに任せ、ユーザーにアクセストークンを貼り付けさせたり、プロンプト内で資格情報を処理させたりしないでください。プロバイダのエンドポイント、コールバックURL、生のプロバイダパラメータ、完全なプライベートアカウント識別子を公開しないでください。

リモートMCPが接続されていない場合は、処理を停止し、ユーザーにホストのOAuthフローで接続するよう依頼してください。任意のAPIエンドポイントを代用しないでください。

ImagineVidについて

ImagineVid は、AI画像、AI動画、AI音楽を生成するためのAIクリエーションプラットフォームです。そのエージェントインターフェースは、5つの安定したエージェントツールを通じて、成長を続けるプロバイダニュートラルな機能カタログを公開しているため、接続されたエージェントはプロバイダ固有のAPIを一つずつハードコーディングすることなく、多くの最新モデルと生成ツールを発見して使用できます。

ワークフロー

1. 発見する。 要求された機能（image、video、music）が既知の場合は、models_list を呼び出します。返された安定した機能 id を選択し、それを後続のツールに capabilityId として渡し、返されたフィールド、デフォルト値、および制約を使用します。カタログが返さなかったモデルや機能をでっち上げないでください。
2. 所有アセットを準備する。 ローカルメディアが必要な場合は、信頼できるホストのアップロード画面、またはImagineVid CLIが既にインストールされている場合はそのCLIのアップロードコマンドを使用します。返された所有者スコープの assetId を保持します。アセットIDはMCPの assetIds フィールドを通じて渡し、ローカルファイルシステムのパス、任意のリモートURL、または大きなBase64ペイロードを決して渡さないでください。
3. 見積もる。 選択した capabilityId、製品 values、および assetIds オブジェクトを別々に指定して generation_quote を呼び出します。作成ステップのために、正確な prompt、values、および assetIds リクエストを保持します。サーバーが返した quotedCredits と正規化されたリクエストを信頼できるものとして扱います。ローカルで価格を計算したり選択したりしないでください。credits_get は、ユーザーが利用可能残高を確認したい場合、またはホストが事前チェックを必要とする場合にのみ使用します。
4. 確認する。 generation_create の前に、選択された機能、重要な値/アセット、および正確な quotedCredits を表示します。その金額の消費について明示的に人間の承認を求めます。生成してほしいという漠然としたリクエストは、クレジットの確認とはみなしません。サーバーが quote_changed を報告した場合は、新しい見積もりを表示して再度確認します。
5. 一度だけ作成する。 generation_create を呼び出す前に、安定した clientRequestId を生成します。見積もりに使用したのと同じ capabilityId、prompt、values、および assetIds を送信し、確認済みの見積もりと等しい confirmedCredits を追加します。そのリクエストに対して正確に一度だけ送信します。同じIDを再利用できるのは、まったく同じリクエストを再実行する場合のみです。異なる入力には、新たに見積もられたリクエストと新しいIDが必要です。タイムアウト、ネットワークのあいまいさ、またはプロバイダのタイムアウト後に再試行しないでください。
6. ポーリングする。 返された所有 generationId を使用して、間隔を増やしながら generation_get を呼び出します。返されたステータス、安全なエラー、および結果のURL/メタデータのみを報告します。ツールが返さなかったモデル、出力、または成功を主張しないでください。submission_unknown は特別なあいまいな結果として扱います。再度作成せず、永続的なIDが利用可能な場合はポーリングを続けます。

ガードレール

• submission_unknown は、プロバイダがその一回の送信を受け入れた可能性があることを意味します。再試行せず、返金もしないでください。永続的な生成IDが返された場合はポーリングを続け、それ以外の場合はオペレーターのフォローアップのためにあいまいさを報告します。
• insufficient_credits はワークフローを停止します。再試行したり、静的にダウングレードしたり、ローカルで計算した価格を提案したりしないでください。
• unauthorized と forbidden_scope は、ユーザーが認証するか、必要なスコープを付与する必要があります。セッションcookieや別のユーザーの資格情報で回避しないでください。
• invalid_input、capability_not_found、asset_not_found、asset_expired は、リクエストの修正または新しい所有アセットのアップロードが必要です。プロバイダのURLを代用しないでください。
• idempotency_conflict は、リクエストIDが異なる入力で使用されたことを意味します。既存のリクエストを上書きしないでください。修正されたリクエストを新しい安定したIDで再度見積もってください。
• プロバイダの障害は、重複が安全であることの証明にはなりません。安全なサーバーエラーを表示し、人間が承認した新しい試行を待ちます。

正確なリクエスト/レスポンスフィールドと安定したエラー語彙については、references/tool-contract.md を参照してください。このリファレンスはワイヤーコントラクトの補助であり、ライブ機能カタログの代わりにはなりません。