# リガビリティチェック
> **POST** `/v3/animations/rig-check`
モデルがリグ可能かどうかを確認し、推奨されるリグ タイプを返します。
## リクエストパラメータ
### リクエストヘッダー
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | 文字列 | はい | — | `application/json` |
| Authorization | 文字列 | はい | — | `Bearer {api_key}` |
### リクエストボディ
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| input | 文字列 | はい | — | モデルソース。 `task_` で始まる task_id、`file_` で始まる file_token、または **GLB** モデル ファイルへのパブリックにアクセス可能な URL を受け入れます。 **GLB** 形式のみがサポートされています (最大 150 MB)。 |
## リクエスト例
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/animations/rig-check \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123"
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/animations/rig-check"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/animations/rig-check";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123"
})
});
const data = await response.json();
console.log(data);
```
## 応答
### 成功した応答
```json
{
"code": 0,
"data": {
"task_id": "task_def456"
}
}
```
### タスク完了後の出力
```json
{
"riggable": true,
"rig_type": "biped"
}
```
### 応答フィールド
| パラメータ | 種類 | 説明 |
| :-: | :-: | :-: |
| code | 整数 | ステータスコード。 `0` は成功を示します |
| data.task_id | 文字列 | リガビリティ チェックの進行状況と結果をポーリングするために使用される一意のタスク ID |
### 出力フィールド
| パラメータ | 種類 | 説明 |
| :-: | :-: | :-: |
| riggable | ブール値 | モデルがリガブルかどうか |
| rig_type | 文字列 | 推奨リグタイプ。可能な値: `biped` (二足動物)、`quadruped` (四足動物)、`hexapod` (六足動物)、`octopod` (八足動物)、`avian` (鳥類)、`serpentine` (蛇紋岩)、`aquatic` (水生動物) |
## エラーコード
| HTTP ステータスコード | エラーコード | 説明 | おすすめ |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | 世代制限を超えました | リクエスト率を下げて後で再試行してください |
| 400 | 2002 | サポートされていないリクエストパラメータです | リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 | 2006 | 入力ソースのタスクタイプが無効です | task_id が 3D モデル タスクに対応していることを確認します |
| 400 | 2007 | ソースタスクのステータスが成功ではありません | ソースタスクが完了するまで待ってからチェックを開始してください |
| 403 | 2010 | クレジットが不十分です | クレジットをリチャージして再試行してください |
リガビリティチェック
POST /v3/animations/rig-check
モデルがリグ可能かどうかを確認し、推奨されるリグ タイプを返します。
リクエストパラメータ
リクエストヘッダー
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| Content-Type |
文字列 |
はい |
— |
application/json |
| Authorization |
文字列 |
はい |
— |
Bearer {api_key} |
リクエストボディ
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| input |
文字列 |
はい |
— |
モデルソース。 task_ で始まる task_id、file_ で始まる file_token、または GLB モデル ファイルへのパブリックにアクセス可能な URL を受け入れます。 GLB 形式のみがサポートされています (最大 150 MB)。 |
リクエスト例
-cmd">curl -X POST https://openapi.tripo3d.ai/v3/animations/rig class="hl-flag">-check \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123"}'
import requests
url = "https://openapi.tripo3d.ai/v3/animations/rig-check"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/animations/rig-check";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123"
})
});
const data = await response.json();
console.log(data);
応答
成功した応答
{
"code": 0,
"data": {
"task_id": "task_def456"}
}
タスク完了後の出力
{
"riggable": true,
"rig_type": "biped"}
応答フィールド
| パラメータ |
種類 |
説明 |
| code |
整数 |
ステータスコード。 0 は成功を示します |
| data.task_id |
文字列 |
リガビリティ チェックの進行状況と結果をポーリングするために使用される一意のタスク ID |
出力フィールド
| パラメータ |
種類 |
説明 |
| riggable |
ブール値 |
モデルがリガブルかどうか |
| rig_type |
文字列 |
推奨リグタイプ。可能な値: biped (二足動物)、quadruped (四足動物)、hexapod (六足動物)、octopod (八足動物)、avian (鳥類)、serpentine (蛇紋岩)、aquatic (水生動物) |
エラーコード
| HTTP ステータスコード |
エラーコード |
説明 |
おすすめ |
| 429 |
2000 |
世代制限を超えました |
リクエスト率を下げて後で再試行してください |
| 400 |
2002 |
サポートされていないリクエストパラメータです |
リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 |
2006 |
入力ソースのタスクタイプが無効です |
task_id が 3D モデル タスクに対応していることを確認します |
| 400 |
2007 |
ソースタスクのステータスが成功ではありません |
ソースタスクが完了するまで待ってからチェックを開始してください |
| 403 |
2010 |
クレジットが不十分です |
クレジットをリチャージして再試行してください |