生成を見積もる
tong_generation_quote実行前にモデル、入力、設定に一致する見積もりを取得します。
/v1/tools/tong_generation_quote/operationsリクエスト例#
curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_quote/operations' \ -H "Authorization: Bearer $TONG_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \ -d '{ "input": { "body": { "operation": "TEXT_TO_IMAGE", "model": "tong_ea55aff4f3b5c8aba3a35569", "routingParameters": { "ratio": "16:9" } } }}'設定
curl --version権限#
自分のアカウントにはサーバー側のAPIキーを、顧客ごとのアカウントにはOAuthを使用します。プロンプトやツール引数にキーを含めないでください。
generation:writequotes:writeリクエスト本文#
RESTはツール引数をinputで囲み、MCPは同じ引数を直接送信します。
bodyobject必須入れ子のフィールドを表示
operationstring必須選んだモデルに対応するワークフローを選択してください。
"TEXT_TO_IMAGE""IMAGE_EDIT""CHARACTER_RECREATE""CHARACTER_RECREATE_SPICY""TEXT_TO_VIDEO""IMAGE_TO_VIDEO""CHARACTER_TO_VIDEO""CHARACTER_TO_VIDEO_SPICY""FIRST_LAST_TO_VIDEO""TEXT_TO_IMAGE"modelstring必須現在のディスカバリーから公開TongモデルIDを選んでください。
最小文字数：1。
最大文字数：100。
"tong_ea55aff4f3b5c8aba3a35569"resolutionstring | null任意"480p""720p""768p""1080p""2k""4k"quantityinteger任意最小値：1。
最大値：60。
durationSecondsinteger任意最小値：1。
最大値：60。
inputAssetIdsstring[]任意最大項目数：20。
characterProfileIdstring任意24文字の16進数ID。
annotationGuideboolean任意routingParametersobject任意このモデルとワークフローで返された設定を使用し、見積もりと送信時に同じ設定を維持してください。
入れ子のフィールドを表示
directorRequiredReferenceCountinteger任意最小値：1。
最大値：20。
recreateReferenceRolesstring[]任意最大項目数：20。
ratiostring任意"21:9""16:9""4:3""1:1""3:4""9:16""adaptive""16:9"generateAudioboolean任意promptExtendboolean任意seedinteger任意最小値：-1。
最大値：2147483647。
negativePromptstring任意最大文字数：3000。
negativePromptModestring任意"REPLACE"referenceRequestobject任意入れ子のフィールドを表示
ratiostring任意最小文字数：1。
最大文字数：20。
generateAudioboolean任意promptstring必須作成したい結果を説明してください。
最小文字数：1。
最大文字数：20000。
directionobject必須入れ子のフィールドを表示
versionnumber必須1capabilityRevisionstring必須最小文字数：1。
最大文字数：100。
keepVideoSoundboolean任意seedinteger任意最小値：0。
最大値：2147483647。
automaticShotsboolean任意automaticDurationboolean任意outputResolutionstring任意"720p-SR""1080p-SR""1440p-SR"bitratestring任意"standard""high"returnLastFrameboolean任意documentUrlstring任意形式：uri。
最大文字数：2048。
subjectSequenceinteger任意最小値：0。
最大値：999。
subjectsobject[]任意最大項目数：6。
入れ子のフィールドを表示
idstring必須番号付きの被写体ラベルを使用します。例：Subject1。
namestring必須最小文字数：1。
最大文字数：80。
descriptionstring任意最大文字数：500。
assetIdsstring[]必須最小項目数：1。
最大項目数：4。
shotsobject[]任意最小項目数：1。
最大項目数：6。
入れ子のフィールドを表示
idstring必須最小文字数：1。
最大文字数：80。
promptstring必須作成したい結果を説明してください。
最小文字数：1。
最大文字数：1800。
durationSecondsinteger必須最小値：1。
最大値：15。
referencesobject[]必須選択したモデルの参照機能に対応する所有アセットIDを使用してください。
最大項目数：120。
入れ子のフィールドを表示
idstring必須最小文字数：1。
最大文字数：80。
assetIdstring必須承認済みアカウントが所有するアセットの識別子を使用してください。
24文字の16進数ID。
fieldstring必須最小文字数：1。
最大文字数：80。
labelstring必須番号付きの参照ラベルを使用します。例：Image1。
assetIdsstring[]必須最大項目数：120。
filmSceneobject任意入れ子のフィールドを表示
projectIdstring必須承認済みアカウントが所有するプロジェクトの識別子を使用してください。
24文字の16進数ID。
shotIdstring必須文字、数字、アンダースコア、ハイフンを使用します。
最小文字数：1。
最大文字数：120。
revisioninteger必須最小値：0。
最大値：9007199254740991。
filmReferenceobject任意入れ子のフィールドを表示
projectIdstring必須承認済みアカウントが所有するプロジェクトの識別子を使用してください。
24文字の16進数ID。
entityIdstring必須文字、数字、アンダースコア、ハイフンを使用します。
最小文字数：1。
最大文字数：120。
revisioninteger必須最小値：0。
最大値：9007199254740991。
リクエストヘッダー#
Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03各操作に1つのUUIDを割り当て、タイムアウトや再試行時にも再利用します。同じUUIDで異なる入力を送ると拒否されます。
レスポンスフィールド#
受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。
受理済みは保存済みという意味です。操作を取得して実行状況を追跡してください。
{ "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8", "tool": "tong_generation_quote", "category": "generation", "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呼び出し#
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "tong_generation_quote", "arguments": { "body": { "operation": "TEXT_TO_IMAGE", "model": "tong_ea55aff4f3b5c8aba3a35569", "routingParameters": { "ratio": "16:9" } } }, "_meta": { "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03" } }}RESTはツール引数をinputで囲み、MCPは同じ引数を直接送信します。
レスポンス
{ "jsonrpc": "2.0", "id": 1, "result": { "structuredContent": { "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8", "tool": "tong_generation_quote", "category": "generation", "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_generation_quote\",\"category\":\"generation\",\"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_LIMITED | Retry-Afterの待機時間が過ぎてから同じリクエストを再試行してください。 |
503 | 一時的に利用できませんDEPENDENCY_UNAVAILABLE | Retry-After後に同じ意図IDで再試行してください。タイムアウト後は保存済みの操作を確認してください。 |