確認日2026-11-11 · API版2026-11-09 · Markdownを読む
公開と予約
AiVideoEditor の投稿は、バージョン管理された下書きと、選択されたアカウントごとの独立した配信から 構成されます。下書きの保存は寛容です。保存に成功しても、すべての宛先が 公開可能であることは確定しません。
投稿の準備
- 意図したキーで
/api/v1/accountsと/api/v1/capabilitiesを読み取ります。 - 必要な メディア をアップロードして確定します。
POST /api/v1/postsで下書きを作成するか、PATCH /api/v1/posts/{id}で編集します。 編集時には現在のexpectedVersionを指定し、返されたバージョンを保持してください。- 必要に応じて、宛先フォーマットとアカウントごとの明示的なバリアント上書きを設定します。 リクエストフィールドは API リファレンス に定義されています。
POST /api/v1/posts/{id}/validateで検証します。HTTP 200 にはvalid: falseが含まれる場合があります。提出前にすべての問題を確認してください。無効なアカウントが オーディエンスから黙って取り除かれることはありません。
今すぐ公開、または後で
POST /posts/{id}/publish は現在の下書きを提出します。POST /posts/{id}/schedule
は scheduledAt、timezone、expectedVersion を必要とします。予約する時刻
は未来で、かつ 90 日以内でなければなりません。UTC の ISO タイムスタンプと別の IANA
表示タイムゾーンを保存し、送信前に夏時間の曖昧さを解決してください。
新しいミューテーションごとに個別の Idempotency-Key を使用してください。送信前にそのキーと正確な
リクエストボディを保持します。タイムアウトの後は、同じキーで同一のリクエストを
再生します。意図的に新しい操作を要求する場合にのみキーを変更してください。古い下書きの編集や予約は revision_conflict を返します。盲目的に上書きするのではなく、
最新のコンテンツを再読み取りして確認してください。
202 レスポンスは配送の受付を意味します。公開の証拠ではありません。
配信 ID を記録し、GET /posts/{id} または署名付きのカスタマーウェブフックを観察してください。
遅延を増やしながらの上限付きポーリングを使用し、最終結果または人間
へのハンドオフで停止してください。無限にループしないでください。
宛先ごとの結果
配信は独立して確定します。ある宛先は公開され、別の宛先は
再接続や同意を必要とする場合があります。各状態と、存在する場合はネイティブ投稿リンクを表示してください。
再試行は POST /deliveries/{id}/retry を使って、適格な既知の失敗に対してのみ行います。
失敗した宛先を復旧するために、成功した宛先を再作成してはなりません。不明な
外部の結果には、新たな提出ではなく照合またはレビューが必要です。
作業が安全に未処理のままのうちに、POST /deliveries/{id}/cancel でキャンセルします。
too_late_to_cancel は提出が安全なキャンセル範囲を超えて進んだことを意味します。
外部の投稿が削除されたことを意味するわけではありません。
TikTok の人間によるレビュー
/accounts/{id}/tiktok/settings を読み取って、現在のクリエイター設定と利用可能な
プライバシー選択を確認します。設定の読み取りや下書きの保存は同意の提供にはなりません。
consent_required には、認証済みコンポーザーへの安全な requiresAction ハンドオフが含まれます。
権限のある人が正確な動画、SNS用キャプション、宛先を確認し、そこで必要な選択を
明示的に確定します。プロダクトキーや MCP ツール
が人の代わりに確定することはできません。コンテンツや同一性の変更には新たなレビューが必要です。
ハンドオフはそれ自体ではメンバーシップやアクセスを一切与えません。
コンポーザーの操作
メディアを追加 でファイルをアップロードするか、既存のライブラリ項目を選択します。SNS用キャプションは、コンテンツをカスタマイズ がアカウント固有のバリアントを作成するまで共有されます。絵文字とハッシュタグのツールは、カーソル位置に通常のテキストを挿入します。
投稿オプション は、選択したアカウントの設定をまとめています。必須の選択は表示されたままになり、任意のグループは折りたたまれたままになります。変更はそのアカウントにのみ適用されます。プレビュー は、保存や提出を行わずに、未完成の下書きを含む実効的な下書きを表示します。ネイティブプラットフォームでの表示は異なる場合があります。
予約済みのカバーとサムネイルには、プライベートなアセット参照を使用してください。公開 URL の代替手段は、配信時点で到達可能である必要があります。字幕の内容は、一時的なローカルファイルに依存するのではなく、不変の設定とともに保存されます。LinkedIn のドキュメントアップロードは現在 PDF を受け付けます。署名検証が実装されるまで、Office 形式は制限されたままです。
正規の操作と統合の制限については 機能リファレンス を参照してください。新しいフォーマットと確認の動作には、デプロイ前に対応するデータベース移行が必要です。