クイックスタート
APIキーを作成し、モデルを探して見積もりを取得し、結果を追跡します。
1. APIキーを作成#
サーバー用のキーを作成します。権限は所有アカウントに適用されます。
APIキーを作成キーはサーバーで保管してください。読み取り専用から始め、連携に必要な権限だけ追加します。
export TONG_API_KEY="YOUR_TONG_API_KEY"有料ツールには credits:spend も必要です。削除権限は別に設定します。
2. モデルを探す#
例のモデル ID、参照フィールド、機能リビジョンは最新の検出結果に置き換えてください。参照への対応はモデルとワークフローによって異なります。
curl -X POST 'https://platform.tongai.io/v1/tools/tong_workflows/operations' \ -H "Authorization: Bearer $TONG_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "query": { "operation": "TEXT_TO_VIDEO" } }}'設定
curl --version3. 設定を見積もる#
先に見積もりを取得し、同じモデルと設定で送信します。成功、失敗、またはレビュー待ちになるまで操作を確認します。
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この設定に対して返された見積もりの送信用の値を使用してください。
4. リクエストを送信#
例では公開エンドポイントを使用しています。サンプルIDを自分のIDに置き換えてください。
curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_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": "000000000000000000000001" }, "body": { "quoteId": "fixture-image-quote-token", "prompt": "A quiet street at blue hour", "operation": "TEXT_TO_IMAGE", "inputAssetIds": [], "parameters": { "textToImageModel": "tong_ea55aff4f3b5c8aba3a35569", "ratio": "16:9" } } }}'設定
curl --version各操作に1つのUUIDを割り当て、タイムアウトや再試行時にも再利用します。同じUUIDで異なる入力を送ると拒否されます。
5. 結果を追跡#
受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。
curl 'https://platform.tongai.io/v1/operations/e8aa0a87-6cd9-42eb-975a-b72bf43218c8' \ -H "Authorization: Bearer $TONG_API_KEY"設定
curl --version{ "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8", "tool": "tong_generation_submit", "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" }}