Tripo Texture
既存の 3D モデル用の PBR テクスチャリング。
既存の 3D モデルの PBR テクスチャを生成または再生成します。モデルは task_id、アップロードしたファイル、または URL で渡し、テキスト、単一画像、または複数視点の画像で結果をガイドできます。テクスチャ v3.5 では、ライティング制御 (delight)、高速モード、より正確なジオメトリとの位置合わせが加わり、視点間での結果の一貫性も高まりました。v3.5 は明示的に指定する必要があります。テクスチャエンドポイントでは model を、生成エンドポイントでは texture_version を使用してください。指定しない場合はデフォルトの v3.0 が使用されます。アップグレードは新しいタスクにのみ適用され、既存のモデルやテクスチャは変更されません。
- ライティング制御 (delight、デフォルトでオン): 写実的なゲームではオンのままにすると、Unity、Unreal、Godot のライティング下でもクリーンなベースカラーが得られます。レンダリング、VFX、CG ではオフにすると、スタイライズされたライティングを保持できます
- 高速モード: texture_quality=fast で、消費クレジットは standard と同じ
- ジオメトリとの位置合わせを改善: ディテールが本来の位置に正しく配置され、視点間の一貫性も向上
- テキスト、スタイル画像、単一画像、または 2〜4 視点の画像でガイド可能。PBR、パーツ単位のリテクスチャリング、8K に対応
価格設定
価格はタスクのタイプと特定のパラメータに基づいて決定されます。標準テクスチャを生成したり、プレミアム トポロジ オプションを使用したりすると、追加コストが発生します。
| 品質 | クレジット |
|---|---|
| 高速 (fast) | 10 |
| 標準 (standard) | 10 |
| HD (detailed) | 20 |
| 8K (extreme) | 30 |
fast にはテクスチャ v3.5-20260815 が必要です。その他のテクスチャバージョンではエラー 1004 が返され、standard にフォールバックすることはありません
生成タスク内でテクスチャリングする場合、テクスチャ付きの出力はジオメトリのみより 10 クレジット多くかかります。HD ではさらに 10、8K ではさらに 20 クレジットが加算されます
エンドポイント
以下のエンドポイント カードのいずれかをクリックすると、API の詳細なドキュメントとコード例に直接ジャンプします。
パラメータ
レート制限
レート制限により、並列リクエストに特定の上限を設けることで、API への公平かつ信頼性の高いアクセスが確保されます。これらの制限がどのくらい高く設定されるかは、使用量レベルによって決まります。
| カテゴリ | 同時実行の制限 |
|---|---|
| モデル処理 (フォーマット変換と共有) | 5 件の並列タスク |
スナップショット
スナップショットを使用すると、モデルの特定のバージョンをロックして、パフォーマンスと動作の一貫性を保つことができます。
| v3.5-20260815 | 最新: ライティング制御と高速モードに対応。明示的な指定が必要 |
| v3.0-20250812 | デフォルト。v3.0 / v3.1 で生成されたモデル向け |
| v2.5-20250123 | v2.5 で生成されたモデル向け |