`POST /v1/assistant/runs`

このHTTPエンドポイントに記載されたフィールドと権限を使用してください。

リクエスト例#

curl -X POST 'https://platform.tongai.io/v1/assistant/runs' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "message": "A quiet street at blue hour"}'

設定

curl --version

認証#

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

assistant:runcredits:spend

パラメーター#

Idempotency-Keystring必須

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

リクエスト本文#

application/json

messagestring必須

作成したい結果を説明してください。

最小文字数：1。

最大文字数：32000。

attachmentsstring[]任意

選択したモデルの参照機能に対応する所有アセットIDを使用してください。

最大項目数：30。

既定値：[]。

reference_bindingsobject[]任意

最大項目数：30。

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

labelstring必須

番号付きの参照ラベルを使用します。例：Image1。

assetIdstring必須

承認済みアカウントが所有するアセットの識別子を使用してください。

24文字の16進数ID。

modestring任意

ガイド付き実行はTongでの確認を待ち、自動実行は続行します。どちらも進行に応じて課金され、残高不足で一時停止します。

使用できる値"guided""automatic"

既定値："guided"。

conversation_idstring任意

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

model_preferencesobject任意

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

imagestring | null必須

文字、数字、アンダースコア、ピリオド、コロン、スラッシュ、ハイフンを使用します。

最小文字数：1。

最大文字数：150。

videostring | null必須

文字、数字、アンダースコア、ピリオド、コロン、スラッシュ、ハイフンを使用します。

最小文字数：1。

最大文字数：150。

sourceobject任意

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

kindstring必須

使用できる値"director""text"

idstring必須

24文字の16進数ID。

レスポンススキーマ#

レスポンス

JSON

{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "example",  "category": "example",  "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": "2026-10-22T09:00:00.000Z",  "detail_expired": false,  "timing": {    "dispatch_started_at": "2026-10-22T09:00:00.000Z",    "acknowledged_at": "2026-10-22T09:00:00.000Z",    "completed_at": "2026-10-22T09:00:00.000Z",    "dispatch_acknowledgement_ms": 0,    "end_to_end_ms": 0  },  "review": null,  "result": null,  "error": {    "code": "example"  },  "billing": {    "status": "none",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}

`HTTP 202`

application/json

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。

エラーと制限#

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で再試行してください。タイムアウト後は保存済みの操作を確認してください。

認証APIキーの利用料金は所有アカウントに請求されます。OAuthでは接続ユーザーが自分のクレジットを使えます。エラーとレート制限エラーを理解し、安全に再試行して、失敗した生成を復旧します。リクエストとログ受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。