Tripo3D

変更履歴

変更履歴

Documentation correction (2026-08)

`credits_consumed`, `balance`, and `frozen` are JSON numbers with up to two decimal places (e.g. `48.00`, `41465.00`). Parse them as floating-point or decimal values — do not use integer parsing (`int`, `parseInt`, etc.), which will fail or truncate fractional credits (e.g. VIP discounts).

v3.0 (2026-04)

新しい API アーキテクチャ

  • 専用エンドポイントはユニバーサル POST エンドポイントを置き換えます: POST /v3/generation/text-to-model などの機能固有のエンドポイントは、以前のユニバーサル POST /v2/openapi/task エンドポイントを type フィールドに置き換えます。
  • 統一された {input}-to-{output} 命名規則: すべての生成エンドポイントは、text-to-model、image-to-multiview、multiview-to-model などの直感的な名前を使用します。
  • 統合 input フィールド: 入力タイプを手動で指定する必要がなく、task_id、file_token、または URL からの自動入力ソース推論をサポートします。
  • 冗長な /openapi パスを削除: ベース URL は、/v2/openapi/ から /v3/ に簡素化されました。
  • テキストから画像への変換と画像から画像への変換は専用のエンドポイントに分離されました: text-to-image と image-to-image は単一の API に結合されなくなりました

エンドポイントの変更

v2 エンドポイント v3 エンドポイント
POST /v2/openapi/task タイプ=text_to_model POST /v3/generation/text-to-model
POST /v2/openapi/task タイプ=image_to_model POST /v3/generation/image-to-model
POST /v2/openapi/task タイプ=multiview_to_model POST /v3/generation/multiview-to-model
POST /v2/openapi/task タイプ=text_to_image POST /v3/generation/text-to-image
POST /v2/openapi/task タイプ=generate_image POST /v3/generation/image-to-image
POST /v2/openapi/task タイプ=generate_multiview_image POST /v3/generation/image-to-multiview
POST /v2/openapi/task タイプ=edit_multiview_image POST /v3/generation/edit-multiview
POST /v2/openapi/task タイプ=refine_model POST /v3/models/refine
POST /v2/openapi/task タイプ=convert_model POST /v3/models/convert
POST /v2/openapi/task タイプ=import_model POST /v3/models/import
POST /v2/openapi/task タイプ=stylize_model POST /v3/models/stylize
POST /v2/openapi/task タイプ=texture_model POST /v3/models/texture
POST /v2/openapi/task タイプ=animate_prerigcheck POST /v3/animations/rig-check
POST /v2/openapi/task タイプ=animate_rig POST /v3/animations/rig
POST /v2/openapi/task タイプ=animate_retarget POST /v3/animations/retarget
POST /v2/openapi/task タイプ=mesh_segmentation POST /v3/mesh/segment
POST /v2/openapi/task タイプ=mesh_completion POST /v3/mesh/complete
POST /v2/openapi/task タイプ=highpoly_to_lowpoly POST /v3/mesh/decimate
GET /v2/openapi/task/{task_id} GET /v3/tasks/{task_id}

フィールドの変更

v2 フィールド v3 フィールド
create_time created_at
consumed_credit credits_consumed
file / file_token / url / object inputに統一

新しい機能

  • POST /v3/tasks/list - バッチでタスクをクエリする
  • POST /v3/files/upload-credentials - ファイルを直接アップロードする認証情報を取得する
  • GET /v3/account/usage - クエリの使用状況の詳細