# タスククエリ

`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`、またはその他のタスク固有のアセットが含まれる場合があります。 |
| `credits_consumed` | 整数 | 完了したタスクによって消費されたクレジット。 |
| `created_at` | 文字列 | ISO 8601 作成時間。 |
| `completed_at` | 文字列 | ISO 8601 完了時間 (利用可能な場合)。 |

## ステータスの処理

- `queued` および `running` を未完了の状態として扱います。
- 出力アセットは、`status=success` の後にのみダウンロードしてください。
- `failed` または `cancelled` をユーザーに提示し、入力を変更せずに再試行ループを回避します。