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

ショットを選択

tong_director_shot_select

このワークフローの選択結果またはレビュー判断を保存します。

POST/v1/tools/tong_director_shot_select/operations

リクエスト例#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_director_shot_select/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",      "shotId": "aaaa"    },    "body": {      "revision": 0,      "versionId": "aaaa"    }  }}'
設定
curl --version

権限#

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

films:write

リクエスト本文#

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

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

24文字の16進数ID。

例"aaaaaaaaaaaaaaaaaaaaaaaa"
shotIdstring必須

文字、数字、アンダースコア、ハイフンを使用します。

最小文字数：1。

最大文字数：120。

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

最小値：0。

最大値：9007199254740991。

例0
versionIdstring必須

文字、数字、アンダースコア、ハイフンを使用します。

最小文字数：1。

最大文字数：120。

例"aaaa"

リクエストヘッダー#

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_shot_select",  "category": "director",  "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_shot_select",    "arguments": {      "params": {        "id": "aaaaaaaaaaaaaaaaaaaaaaaa",        "shotId": "aaaa"      },      "body": {        "revision": 0,        "versionId": "aaaa"      }    },    "_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_shot_select",      "category": "director",      "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_shot_select\",\"category\":\"director\",\"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プロジェクト一覧新たな生成を開始せず、選択した所有リソースや現在の状態を取得します。Directorプロジェクトを取得新たな生成を開始せず、選択した所有リソースや現在の状態を取得します。動画を添付選択した識別子で所有リソースをこのワークフローに添付します。下書きを作成以下のフィールドでTongアカウントにリソースを作成し保存します。脚本を保存以下のフィールドで選択した所有リソースを更新します。