ドキュメントへ移動
ドキュメント
ダッシュボードを開く
このページの内容

Director編集を送信

tong_director_video_edit_submit

Tongアカウントとクレジットで設定済みの操作を送信し、完了まで追跡します。

POST/v1/tools/tong_director_video_edit_submit/operations

リクエスト例#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_director_video_edit_submit/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "params": {      "id": "aaaaaaaaaaaaaaaaaaaaaaaa"    },    "body": {      "quoteId": "aaaaaaaaaaaaaaaaaaaaaaaa"    }  }}'
設定
curl --version

権限#

自分のアカウントにはサーバー側のAPIキーを、顧客ごとのアカウントにはOAuthを使用します。プロンプトやツール引数にキーを含めないでください。

video_edit:writecredits:spend

リクエスト本文#

RESTはツール引数をinputで囲み、MCPは同じ引数を直接送信します。

paramsobject必須
入れ子のフィールドを表示
idstring必須

24文字の16進数ID。

例"aaaaaaaaaaaaaaaaaaaaaaaa"
bodyobject必須
入れ子のフィールドを表示
quoteIdstring必須

この設定に対して返された見積もりの送信用の値を使用してください。

24文字の16進数ID。

例"aaaaaaaaaaaaaaaaaaaaaaaa"

リクエストヘッダー#

HTTP
Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

各操作に1つのUUIDを割り当て、タイムアウトや再試行時にも再利用します。同じUUIDで異なる入力を送ると拒否されます。

レスポンスフィールド#

受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。

受理済みは保存済みという意味です。操作を取得して実行状況を追跡してください。

JSON
{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "tong_director_video_edit_submit",  "category": "video_editor",  "channel": "api",  "state": "queued",  "status": "accepted",  "stage": "admission",  "dispatch_status": "pending",  "created_at": "2026-10-22T09:00:00.000Z",  "updated_at": "2026-10-22T09:00:00.000Z",  "detail_expires_at": null,  "detail_expired": false,  "timing": {    "dispatch_started_at": null,    "acknowledged_at": null,    "completed_at": null,    "dispatch_acknowledgement_ms": null,    "end_to_end_ms": null  },  "review": null,  "result": null,  "error": null,  "billing": {    "status": "pending",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}
idstring必須

保存された操作の一意のID。

UUID。例：e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

toolstring必須
categorystring必須
channelstring必須
使用できる値"api""mcp"
statestring必須

保存された処理の現在の実行状態。

使用できる値"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"
statusstring必須

操作の追跡に使用する全体のステータス。

使用できる値"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"
stagestring必須

操作の現在のフェーズ。

使用できる値"admission""dispatch""review""generation""reconciliation""complete"
dispatch_statusstring必須

ツールがリクエストを受け付けたかを示します。受信確認は生成の完了を意味しません。

使用できる値"pending""unknown""acknowledged"
created_atstring必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

updated_atstring必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

detail_expires_atstring | null必須

保存された操作詳細の有効期限。nullは現在期限が設定されていないことを示します。

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

detail_expiredboolean必須

保存された操作詳細の有効期限が切れているかを示します。

timingobject必須

この操作を追跡するためのタイムスタンプと経過時間。

入れ子のフィールドを表示
dispatch_started_atstring | null必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

acknowledged_atstring | null必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

completed_atstring | null必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

dispatch_acknowledgement_msnumber | null必須

最小値：0。

end_to_end_msnumber | null必須

最小値：0。

reviewJSON | null必須

人の入力が必要な場合のレビュー情報。それ以外はnull。

resultJSON | null必須

このツールの出力。出力がまだない場合はnull。

errorobject | null必須

操作が失敗した場合の公開エラーコード。それ以外はnull。

入れ子のフィールドを表示
codestring必須
billingobject必須

クレジット使用量とウォレット請求額。出力の準備完了と請求の確定は別の状態です。

入れ子のフィールドを表示
statusstring必須
使用できる値"none""pending""settled""released""reconciling"
usage_creditsstring必須

小数点以下6桁の十進数文字列。例：1.250000。

wallet_debited_creditsstring必須

小数点以下6桁の十進数文字列。例：1.250000。

released_creditsstring任意

小数点以下6桁の十進数文字列。例：1.250000。

refunded_creditsstring任意

小数点以下6桁の十進数文字列。例：1.250000。

unfunded_creditsstring任意

小数点以下6桁の十進数文字列。例：1.250000。

pending_creditsstring任意

小数点以下6桁の十進数文字列。例：1.250000。

tokensobject任意
入れ子のフィールドを表示
inputnumber任意

最小値：0。

outputnumber任意

最小値：0。

cachednumber任意

最小値：0。

cache_writenumber任意

最小値：0。

componentsobject[]任意
入れ子のフィールドを表示
idstring任意
source_idstring必須
toolstring必須
modelstring | null必須
channelstring必須
使用できる値"api""mcp"
credential_idstring必須
kindstring必須
使用できる値"text_pool""reasoning""generation"
usage_creditsstring必須

小数点以下6桁の十進数文字列。例：1.250000。

wallet_debited_creditsstring必須

小数点以下6桁の十進数文字列。例：1.250000。

evidence_atstring任意

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

updated_atstring任意

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

quoteobject任意

見積もりがある場合の設定、価格、送信に使用する値。

入れ子のフィールドを表示
idstring必須

UUID。例：e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

operation_idstring必須

UUID。例：e8aa0a87-6cd9-42eb-975a-b72bf43218c8。

toolstring必須
operationstring | null必須
modelstring | null必須
configurationobject必須
submit_valuestring必須
submit_fieldstring必須
quoted_creditsstring | null必須

小数点以下6桁の十進数文字列。例：1.250000。

expires_atstring | null必須

ISO 8601形式の日時。例：2026-10-22T09:00:00Z。

リクエストとログ受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。クレジットと請求見積額、実際の使用量、精算済みクレジットを確認します。

MCP呼び出し#

JSON
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "tong_director_video_edit_submit",    "arguments": {      "params": {        "id": "aaaaaaaaaaaaaaaaaaaaaaaa"      },      "body": {        "quoteId": "aaaaaaaaaaaaaaaaaaaaaaaa"      }    },    "_meta": {      "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"    }  }}

RESTはツール引数をinputで囲み、MCPは同じ引数を直接送信します。

レスポンス

JSON
{  "jsonrpc": "2.0",  "id": 1,  "result": {    "structuredContent": {      "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",      "tool": "tong_director_video_edit_submit",      "category": "video_editor",      "channel": "mcp",      "state": "queued",      "status": "accepted",      "stage": "admission",      "dispatch_status": "pending",      "created_at": "2026-10-22T09:00:00.000Z",      "updated_at": "2026-10-22T09:00:00.000Z",      "detail_expires_at": null,      "detail_expired": false,      "timing": {        "dispatch_started_at": null,        "acknowledged_at": null,        "completed_at": null,        "dispatch_acknowledgement_ms": null,        "end_to_end_ms": null      },      "review": null,      "result": null,      "error": null,      "billing": {        "status": "pending",        "usage_credits": "0.000000",        "wallet_debited_credits": "0.000000"      }    },    "content": [      {        "type": "text",        "text": "{\"id\":\"e8aa0a87-6cd9-42eb-975a-b72bf43218c8\",\"tool\":\"tong_director_video_edit_submit\",\"category\":\"video_editor\",\"channel\":\"mcp\",\"state\":\"queued\",\"status\":\"accepted\",\"stage\":\"admission\",\"dispatch_status\":\"pending\",\"created_at\":\"2026-10-22T09:00:00.000Z\",\"updated_at\":\"2026-10-22T09:00:00.000Z\",\"detail_expires_at\":null,\"detail_expired\":false,\"timing\":{\"dispatch_started_at\":null,\"acknowledged_at\":null,\"completed_at\":null,\"dispatch_acknowledgement_ms\":null,\"end_to_end_ms\":null},\"review\":null,\"result\":null,\"error\":null,\"billing\":{\"status\":\"pending\",\"usage_credits\":\"0.000000\",\"wallet_debited_credits\":\"0.000000\"}}"      }    ]  }}

エラーと制限#

HTTPエラー復旧
400無効なリクエストREQUEST_INVALID再試行する前に、エラーで示されたフィールドを修正してください。
401無効な認証情報CREDENTIAL_INVALID認証情報の有効期限と失効状態を確認してください。
402クレジット不足INSUFFICIENT_CREDITS認証情報を所有するアカウントにクレジットを追加し、保存済みの作業を続行してください。
403権限がありませんSCOPE_REQUIRED必要なスコープとリソースへのアクセス権を持つ認証情報を使用してください。
404リソースを利用できませんRESOURCE_UNAVAILABLEリソースIDと、承認済みアカウントの所有物であることを確認してください。
409意図IDの競合IDEMPOTENCY_CONFLICT意図IDは元のリクエストにのみ再使用し、別の操作には新しいUUIDを使用してください。
429レート制限に達しましたRATE_LIMITEDRetry-Afterの待機時間が過ぎてから同じリクエストを再試行してください。
503一時的に利用できませんDEPENDENCY_UNAVAILABLERetry-After後に同じ意図IDで再試行してください。タイムアウト後は保存済みの操作を確認してください。
エラーとレート制限エラーを理解し、安全に再試行して、失敗した生成を復旧します。冪等性各操作に1つのUUIDを割り当て、タイムアウトや再試行時にも再利用します。同じUUIDで異なる入力を送ると拒否されます。
Director編集を見積もる実行前にモデル、入力、設定に一致する見積もりを取得します。元動画を準備このワークフローの次の手順に向けて所有するソースを準備します。選択範囲を見積もる実行前にモデル、入力、設定に一致する見積もりを取得します。動画編集を見積もる実行前にモデル、入力、設定に一致する見積もりを取得します。編集経路を見積もる実行前にモデル、入力、設定に一致する見積もりを取得します。選択フレームを取得新たな生成を開始せず、選択した所有リソースや現在の状態を取得します。