known-errors

既知のエラー

現在有効な MCP ツールのスキーマと、返された構造化エラーを信頼してください。現在のマニフェストと異なる場合は、記憶している古いペイロードで再試行しないでください。

変更の拒否

• 同じトラックで重複する場合は、書き込みを強行したり、競合する項目を黙って削除したりしないでください。コンテンツが順次配置かレイヤー配置かを判断し、適切であれば利用可能なトラックを選ぶか、どちらの項目を優先するか確認してください。
• トラックのロックまたは古い ID によるエラーが発生した場合は、該当するタイムラインの範囲を更新し、現在の ID と状態のみを使って再試行してください。
• 検証エラーが発生した場合は、拒否されたフィールドまたはトランザクションの形式のみを変更し、無関係なプロジェクトの状態は保持してください。

インポートとメディア

• ホストされるプラグインの画面では、asset-import アダプターと import_media を使用してください。利用できない場合に、バックエンド専用の push_asset や download_media の呼び出しで代用しないでください。
• メディアの変換に失敗した場合は、ヘルパーから構造化された再試行手順が提示されていれば、それに従ってください。提示されていない場合は、未対応のソースであることを説明し、対応する形式のファイルを求めてください。同じエディターのインポート手順を繰り返さないでください。
• バイトデータに依存する操作の前にのみ、アップロードの完了を待ってください。既知のアセット ID があれば、バイトデータのアップロード中でも、メタデータやタイムラインへの配置に使用できます。

生成とモーショングラフィックス

• 現在のホストで表示されている生成ツールのみを使用してください。Codex と Claude Code のプラグインでは、create_motion_graphic_from_code を使ってモーショングラフィックスを直接作成します。組み込みの ChatCut Agent では、submit_motion_graphic が表示される場合があります。
• 元のプロバイダーまたはコンテンツポリシーによるエラーを保持してください。同じ内容で繰り返し再試行してクレジットを消費したり、モデルを黙って切り替えたりしないでください。

検証とエクスポート

• 変更が成功しても、見た目の確認ができたことにはなりません。結果を目視する必要がある場合は、verification を読み込んでください。
• レンダージョブには track_export を使用してください。ローカルエクスポートの失敗だけを理由にクラウドへ切り替えないでください。報告されたブラウザーまたはタイムラインの問題を修正し、ローカルで再試行してください。ローカルエクスポートがブロックされた場合、または完了したのにファイルが見つからない場合は、export のフォールバック順に従ってください。クラウドを使うのはユーザーの同意がある場合のみとし、ChatCut Desktop を使うのはクラウドでは実行できない場合のみです。クラウドレンダーでアセットを読み込めない場合は、ユーザーの許可がある場合に限り、asset-import を通じてリモートでの準備を解決するか、制約を報告してください。

認証またはプロジェクトへのアクセスに関するエラーが発生した場合は、コードやインフラストラクチャのデバッグを試みる前に、プロジェクト ID が正確であること、およびエディターとプラグインが同じ ChatCut アカウントを使用していることを確認してください。