Tripo3D

Registro de alterações

Registro de alterações

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)

Nova arquitetura API

  • Endpoints dedicados substituem o endpoint universal POST: endpoints específicos de capacidade, como POST /v3/generation/text-to-model, substituem o endpoint universal anterior POST /v2/openapi/task por um campo type
  • Convenção de nomenclatura unificada {input}-to-{output}: todos os endpoints de geração usam nomes intuitivos, como text-to-model, image-to-multiview e multiview-to-model
  • Campo input unificado: suporta inferência automática de fonte de entrada de task_id, file_token ou URL, sem exigir que você especifique manualmente o tipo de entrada
  • Removido o caminho /openapi redundante: O URL básico foi simplificado de /v2/openapi/ para /v3/
  • Texto para imagem e imagem para imagem são separados em endpoints dedicados: text-to-image e image-to-image não são mais combinados em um único API

Alterações de endpoint

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

Mudanças de campo

Campo v2 Campo v3
create_time created_at
consumed_credit credits_consumed
file / file_token / url / object Unificado como input

Novas capacidades

  • POST /v3/tasks/list - Tarefas de consulta em lote
  • POST /v3/files/upload-credentials - Obtenha credenciais de upload direto de arquivos
  • GET /v3/account/usage – Consultar detalhes de uso