確認日2026-11-10 · API版2026-11-09 · Markdownを読む
認証とプロダクトキー
AiVideoEditor の UI、REST API、MCP アダプタはワークスペースのサービスを共有しています。API クライアントは
プロダクトキーを使用します。SNS の OAuth トークンやデータベース資格情報ではありません。正しいワークスペースに
サインインした後、/app/developers でキーを作成してください。平文の pk_v1_… キーは一度だけコピーし、
シークレットマネージャーまたは保護されたローカル環境に保管してください。AiVideoEditor はハッシュと表示用プレフィックスを保持します。
キーの送信
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
デプロイされたオリジンには HTTPS を使用してください。資格情報を URL、ソース管理、 チャットプロンプト、スクリーンショット、ログに入れないでください。ストレージへの直接アップロードでは返された 署名付き URL とヘッダーを使用します。AiVideoEditor のベアラーキーをストレージに転送しないでください。
スコープとアカウントアクセス
| スコープ | 機能 |
|---|---|
accounts:read | アカウント、機能 (capability)、TikTok 設定の確認 |
media:write | アップロードの予約、確定、管理 |
posts:read | 投稿の一覧表示、下書きの検証、ステータスの観察 |
posts:write | 下書きの作成と編集 |
posts:publish | 配信の公開、予約、キャンセル、再試行 |
usage:read | ワークスペースの使用状況とプラン情報の読み取り |
webhooks:manage | ウェブフックエンドポイントの登録、一覧表示、削除 |
スコープは正確な名前であり、階層ではありません。統合に必要なスコープのみを付与してください。
キーはアクセス可能なアカウント ID を制限することもできます。ワークスペースのメンバーシップ、実効
ロール、アカウント制限、プランの状態は引き続き適用されます。posts:publish を
持つキーが下書きの書き込みアクセスを自動的に得ることはありません。
デフォルトのキースコープセットには posts:publish と webhooks:manage は含まれません。下書き専用の
エージェントは、送信する権限を持たないまま、レビュー用の作業を準備できます。キーが
他のキーを作成したり請求を変更したりすることはできません。
失効と復旧
漏洩したキーは開発者 UI で失効させてください。まず保留中ジョブの件数を確認してください:
失効すると未送信の作業は requires_action として一時停止されます。下書きは削除されません。
適切なアクセス権を持つ代替キーを作成し、再開する前に保留中の作業を確認してください。
失効によって、すでに外部に送信された投稿を取り戻せるとは想定しないでください。
401 は資格情報がないか無効であることを意味します。403 は認証された
主体に権限またはアカウントアクセスがないことを意味します。いずれのレスポンスも
繰り返し再試行しても解決しません。エラーと復旧 を参照してください。