# メッシュデシメーション
> **POST** `/v3/mesh/decimate`
モデルのポリ数を減らし、高ポリモデルを低ポリモデルに変換します。
## リクエストパラメータ
### リクエストヘッダー
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | 文字列 | はい | — | `application/json` |
| Authorization | 文字列 | はい | — | `Bearer {api_key}` |
### リクエストボディ
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| input | 文字列 | はい | — | モデルソース。 `task_` で始まる task_id または `file_` で始まる file_token を受け入れます |
| model | 文字列 | いいえ | 最新バージョン | デシメーションモデルのバージョン |
| face_limit | 整数 | いいえ | アダプティブ | ターゲットのポリ数、範囲は 1000 ~ 20000 |
| quad | ブール値 | いいえ | `false` | クワッドメッシュを出力する |
| part_names | 文字列[] | いいえ | — | 間引く部品名のリスト |
| bake | ブール値 | いいえ | `true` | ローポリモデルにテクスチャをベイクする |
## リクエスト例
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/mesh/decimate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"face_limit": 5000,
"quad": false,
"bake": true
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/mesh/decimate"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"face_limit": 5000,
"quad": False,
"bake": True
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/mesh/decimate";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
face_limit: 5000,
quad: false,
bake: true
})
});
const data = await response.json();
console.log(data);
```
## 応答
### 成功した応答
```json
{
"code": 0,
"data": {
"task_id": "task_def456"
}
}
```
### 応答フィールド
| パラメータ | 種類 | 説明 |
| :-: | :-: | :-: |
| code | 整数 | ステータスコード。 `0` は成功を示します |
| data.task_id | 文字列 | デシメーションの進行状況と結果をポーリングするために使用される一意のタスク識別子 |
## エラーコード
| HTTP ステータスコード | エラーコード | 説明 | おすすめ |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | 世代制限を超えました | リクエスト率を下げて後で再試行してください |
| 400 | 2002 | サポートされていないリクエストパラメータです | リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 | 2006 | 入力ソースのタスクタイプが無効です | task_id が 3D モデル タスクに対応していることを確認します |
| 400 | 2007 | ソースタスクのステータスが成功ではありません | デシメーションを開始する前にソースタスクが完了するまで待機してください |
| 403 | 2010 | クレジットが不十分です | クレジットをリチャージして再試行してください |
メッシュデシメーション
POST /v3/mesh/decimate
モデルのポリ数を減らし、高ポリモデルを低ポリモデルに変換します。
リクエストパラメータ
リクエストヘッダー
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| Content-Type |
文字列 |
はい |
— |
application/json |
| Authorization |
文字列 |
はい |
— |
Bearer {api_key} |
リクエストボディ
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| input |
文字列 |
はい |
— |
モデルソース。 task_ で始まる task_id または file_ で始まる file_token を受け入れます |
| model |
文字列 |
いいえ |
最新バージョン |
デシメーションモデルのバージョン |
| face_limit |
整数 |
いいえ |
アダプティブ |
ターゲットのポリ数、範囲は 1000 ~ 20000 |
| quad |
ブール値 |
いいえ |
false |
クワッドメッシュを出力する |
| part_names |
文字列[] |
いいえ |
— |
間引く部品名のリスト |
| bake |
ブール値 |
いいえ |
true |
ローポリモデルにテクスチャをベイクする |
リクエスト例
-cmd">curl -X POST https://openapi.tripo3d.ai/v3/mesh/decimate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"face_limit": 5000,
"quad": false,
"bake": true
}'
import requests
url = "https://openapi.tripo3d.ai/v3/mesh/decimate"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"face_limit": 5000,
"quad": False,
"bake": True
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/mesh/decimate";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
face_limit: 5000,
quad: false,
bake: true
})
});
const data = await response.json();
console.log(data);
応答
成功した応答
{
"code": 0,
"data": {
"task_id": "task_def456"}
}
応答フィールド
| パラメータ |
種類 |
説明 |
| code |
整数 |
ステータスコード。 0 は成功を示します |
| data.task_id |
文字列 |
デシメーションの進行状況と結果をポーリングするために使用される一意のタスク識別子 |
エラーコード
| HTTP ステータスコード |
エラーコード |
説明 |
おすすめ |
| 429 |
2000 |
世代制限を超えました |
リクエスト率を下げて後で再試行してください |
| 400 |
2002 |
サポートされていないリクエストパラメータです |
リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 |
2006 |
入力ソースのタスクタイプが無効です |
task_id が 3D モデル タスクに対応していることを確認します |
| 400 |
2007 |
ソースタスクのステータスが成功ではありません |
デシメーションを開始する前にソースタスクが完了するまで待機してください |
| 403 |
2010 |
クレジットが不十分です |
クレジットをリチャージして再試行してください |