# モデルのインポート
> **POST** `/v3/models/import`
外部 3D モデル ファイルを Tripo プラットフォームにインポートします。
> 表示されているタスク ID は例です。API が返した実際の ID に置き換えてください。
## リクエストパラメータ
### リクエストヘッダー
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | 文字列 | はい | - | `application/json` |
| Authorization | 文字列 | はい | - | `Bearer {api_key}` |
### リクエストボディ
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| input | 文字列 | はい | - | モデルファイルのソース。 `file_` で始まる file_token または `http(s)://` で始まる URL を受け入れます。サポートされている形式: GLB、GLTF、FBX、OBJ、STL、最大 150 MB |
## リクエスト例
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/models/import \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "file_abc123"
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/models/import"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "file_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/models/import";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "file_abc123"
})
});
const data = await response.json();
console.log(data);
```
## 応答
### 成功した応答
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### 応答フィールド
| パラメータ | 種類 | 説明 |
| :-: | :-: | :-: |
| code | 整数 | ステータスコード。 `0` は成功を示します |
| data.task_id | 文字列 | 生成の進行状況と結果をクエリするために使用される一意のタスク識別子 |
### タスク結果フィールド
`status=success` の後、`GET /v3/tasks/{task_id}` は `data.output` に次のフィールドを返します:
| パラメータ | 種類 | 説明 |
| :-: | :-: | :-: |
| model_url | string | インポートされたモデルのダウンロード URL |
| rendered_image_url | string | レンダリングされたプレビュー画像の URL |
| normalize_scale | number | インポートしたモデルを正規化した際に適用された均一スケール係数:`正規化後のサイズ = 正規化前のサイズ × normalize_scale`。`1.0` はスケールされていないことを示しますが、平行移動は行われている場合があります。正規化後のサイズをこの係数で割ると正規化前のサイズに戻せます。プラットフォームの出力は正規化後の結果のままです。モデルのインポート、およびモデル入力が `file_token` または URL のモデル後処理タスク(リギング、テクスチャ、形式変換など。先にモデルをインポートします)がこのフィールドを返します。入力が `task_id` のタスク、およびこのフィールド追加前に作成されたタスクでは返されません |
| normalize_translation | number[] | インポートしたモデルを正規化した際に適用された平行移動ベクトル。形式は `[tx, ty, tz]`(3 つの数値)。`normalize_scale` と組み合わせて使用します:`正規化後の座標 = 正規化前の座標 × normalize_scale + normalize_translation`、`正規化前の座標 = (正規化後の座標 - normalize_translation) / normalize_scale`。インポート処理がこの値を提供する場合にのみ返され、返すタスクは `normalize_scale` と同じです。入力が `task_id` のタスク、およびこのフィールド追加前に作成されたタスクでは返されません |
## エラーコード
| HTTP ステータスコード | エラーコード | 説明 | おすすめ |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | 世代制限を超えました | リクエスト率を下げて後で再試行してください |
| 400 | 1004 | サポートされていないリクエストパラメータ | リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 | 2006 | 入力ソースのタスクタイプが無効です | 入力ファイル形式がサポートされていることを確認します |
| 400 | 2007 | ソースタスクが正常に完了しませんでした | ファイルのアップロードが完了したことを確認する |
| 403 | 2010 | クレジットが不十分です | クレジットを補充して再試行してください |
モデルのインポート
POST /v3/models/import
外部 3D モデル ファイルを Tripo プラットフォームにインポートします。
表示されているタスク ID は例です。API が返した実際の ID に置き換えてください。
リクエストパラメータ
リクエストヘッダー
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| Content-Type |
文字列 |
はい |
- |
application/json |
| Authorization |
文字列 |
はい |
- |
Bearer {api_key} |
リクエストボディ
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| input |
文字列 |
はい |
- |
モデルファイルのソース。 file_ で始まる file_token または http(s):// で始まる URL を受け入れます。サポートされている形式: GLB、GLTF、FBX、OBJ、STL、最大 150 MB |
リクエスト例
curl -X POST https://openapi.tripo3d.ai/v3/models/import \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "file_abc123"
}'
import requests
url = "https://openapi.tripo3d.ai/v3/models/import"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "file_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/models/import";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "file_abc123"
})
});
const data = await response.json();
console.log(data);
応答
成功した応答
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
応答フィールド
| パラメータ |
種類 |
説明 |
| code |
整数 |
ステータスコード。 0 は成功を示します |
| data.task_id |
文字列 |
生成の進行状況と結果をクエリするために使用される一意のタスク識別子 |
タスク結果フィールド
status=success の後、GET /v3/tasks/{task_id} は data.output に次のフィールドを返します:
| パラメータ |
種類 |
説明 |
| model_url |
string |
インポートされたモデルのダウンロード URL |
| rendered_image_url |
string |
レンダリングされたプレビュー画像の URL |
| normalize_scale |
number |
インポートしたモデルを正規化した際に適用された均一スケール係数:正規化後のサイズ = 正規化前のサイズ × normalize_scale。1.0 はスケールされていないことを示しますが、平行移動は行われている場合があります。正規化後のサイズをこの係数で割ると正規化前のサイズに戻せます。プラットフォームの出力は正規化後の結果のままです。モデルのインポート、およびモデル入力が file_token または URL のモデル後処理タスク(リギング、テクスチャ、形式変換など。先にモデルをインポートします)がこのフィールドを返します。入力が task_id のタスク、およびこのフィールド追加前に作成されたタスクでは返されません |
| normalize_translation |
number[] |
インポートしたモデルを正規化した際に適用された平行移動ベクトル。形式は [tx, ty, tz](3 つの数値)。normalize_scale と組み合わせて使用します:正規化後の座標 = 正規化前の座標 × normalize_scale + normalize_translation、正規化前の座標 = (正規化後の座標 - normalize_translation) / normalize_scale。インポート処理がこの値を提供する場合にのみ返され、返すタスクは normalize_scale と同じです。入力が task_id のタスク、およびこのフィールド追加前に作成されたタスクでは返されません |
エラーコード
| HTTP ステータスコード |
エラーコード |
説明 |
おすすめ |
| 429 |
2000 |
世代制限を超えました |
リクエスト率を下げて後で再試行してください |
| 400 |
1004 |
サポートされていないリクエストパラメータ |
リクエストボディのパラメータ名と値の範囲を確認してください |
| 400 |
2006 |
入力ソースのタスクタイプが無効です |
入力ファイル形式がサポートされていることを確認します |
| 400 |
2007 |
ソースタスクが正常に完了しませんでした |
ファイルのアップロードが完了したことを確認する |
| 403 |
2010 |
クレジットが不十分です |
クレジットを補充して再試行してください |