`POST /v1/images/generations`

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

リクエスト例#

curl -X POST 'https://platform.tongai.io/v1/images/generations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "quote_id": "example",  "media_conversation_id": "aaaaaaaaaaaaaaaaaaaaaaaa",  "prompt": "A quiet street at blue hour",  "parameters": {}}'

設定

curl --version

認証#

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

generation:writecredits:spend

パラメーター#

Idempotency-Keystring必須

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

リクエスト本文#

application/json

quote_idstring必須

文字、数字、ハイフンを使用します。

最小文字数：1。

最大文字数：120。

media_conversation_idstring必須

24文字の16進数ID。

promptstring必須

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

最小文字数：1。

最大文字数：32000。

input_asset_idsstring[]任意

最大項目数：30。

既定値：[]。

parametersobject必須

workspace_project_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では接続ユーザーが自分のクレジットを使えます。エラーとレート制限エラーを理解し、安全に再試行して、失敗した生成を復旧します。リクエストとログ受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。