# タスククエリ `task_id` によって 1 つの非同期 Tripo タスクのステータス、進行状況、出力をクエリします。 すべての生成、メッシュ処理、リギング、アニメーション、ファイル インポート、および変換エンドポイントは、`task_id` を返します。このエンドポイントを使用して、タスクが `success`、`failed`、または `cancelled` に達するまでポーリングします。 ## エンドポイント ```http GET /v3/tasks/{task_id} ``` ## パスパラメータ | 名前 | 種類 | 必須 | 説明 | | --- | --- | --- | --- | | `task_id` | 文字列 | 必須 | タスク作成エンドポイントによって返される一意のタスク識別子。通常は `task_` で始まります。 | ## リクエスト例 ```bash curl -s \ -H "Authorization: Bearer YOUR_API_KEY" \ https://openapi.tripo3d.ai/v3/tasks/task_abc123 ``` ## 応答フィールド | フィールド | 種類 | 説明 | | --- | --- | --- | | `task_id` | 文字列 | 一意のタスク識別子。 | | `type` | 文字列 | タスク タイプ (`text_to_model`、`image_to_model`、`rig`、`convert` など)。 | | `status` | 文字列 | `queued`、`running`、`success`、`failed`、または `cancelled` のいずれか。 | | `progress` | 整数 | タスクの進行状況は `0` から `100` です。 | | `output` | オブジェクト | `status=success` の場合に設定されます。 `model_url`、`rendered_image_url`、またはその他のタスク固有のアセットが含まれる場合があります。 モデルのインポート、およびモデル入力が `file_token` または URL のモデル後処理タスク（リギング、テクスチャ、形式変換など）は `normalize_scale`（number）も返します：インポートしたモデルを正規化した際に適用されたスケール係数です（`最終サイズ = 元のサイズ × normalize_scale`。`1.0` はスケールなし）。 | | `credits_consumed` | number | 完了したタスクによって消費されたクレジット。 | | `created_at` | 文字列 | ISO 8601 作成時間。 | | `completed_at` | 文字列 | ISO 8601 完了時間 (利用可能な場合)。 | ## ステータスの処理 - `queued` および `running` を未完了の状態として扱います。 - 出力アセットは、`status=success` の後にのみダウンロードしてください。 - `failed` または `cancelled` をユーザーに提示し、入力を変更せずに再試行ループを回避します。

GET /v3/tasks/{task_id}

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123