# Introdução ao Tripo API

Tripo3D é uma plataforma de geração 3D com tecnologia AI- que fornece texto para 3D, imagem para 3D, rigging, edição de malha e outros recursos. Com o Tripo API, os desenvolvedores podem integrar a geração de conteúdo 3D de alta qualidade em seus próprios produtos.

> Se você estiver acessando da China, visite o site da China: [developers.tripo3d.com](https://developers.tripo3d.com)

## Base URL

```baseurl
https://openapi.tripo3d.ai/v3
```

## Autenticação

Todas as solicitações API devem incluir um API Key no cabeçalho da solicitação:

```apikey
Authorization: Bearer {api_key}
```

Você pode criar e gerenciar API Keys no [Console Tripo](/en/keys).

## Formato de resposta unificada

### Resposta de sucesso

```json
{
  "code": 0,
  "data": {
    ...
  }
}
```

### Resposta de erro

```json
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}
```

### Campos Comuns

| Parâmetro | Tipo | Descrição |
| :-: | :-: | :-: |
| code | inteiro | Código de status. `0` indica sucesso e qualquer valor diferente de `0` indica um erro |
| data | objeto | Dados de negócios, retornados apenas em caso de sucesso |
| message | cadeia | Descrição do erro, retornada somente em caso de falha |
| suggestion | cadeia | Correção sugerida, retornada somente em caso de falha |

## Padrão de tarefa assíncrona

A maioria dos APIs da geração usa um padrão de tarefa assíncrona:

1. **Criar uma tarefa** - Envie uma solicitação POST para criar uma tarefa e receba um `task_id`
2. **Pesquisa de resultados** - Use `GET /v3/tasks/{task_id}` para consultar o status e o resultado da tarefa

```
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}
```

### Status de tarefas

| Estado | Descrição |
| :-: | :-: |
| `queued` | Na fila |
| `running` | Correndo |
| `success` | Sucesso |
| `failed` | Falha |
| `cancelled` | Cancelado |

## Versão API

Versão atual: **v3**

## Visão geral do terminal

### Geração de modelo 3D

| Ponto final | Descrição |
| :-: | :-: |
| [`POST /v3/generation/text-to-model`](/en/docs/generation-text-to-model) | Gere um modelo 3D a partir de texto |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Gere um modelo 3D a partir de uma imagem |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | Gere um modelo 3D a partir de imagens multivisualização |

### Geração de imagem

| Ponto final | Descrição |
| :-: | :-: |
| [`POST /v3/generation/text-to-image`](/en/docs/generation-text-to-image) | Gerar uma imagem a partir de texto |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Transforme um estilo de imagem |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Gerar imagens multivisualização |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Editar imagens multivisualização |

### Processamento de modelo

| Ponto final | Descrição |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Texturizar um modelo |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Converter formato de modelo |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Segmentação semântica |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Conclusão da malha |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopologia |

### Animação

| Ponto final | Descrição |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Verifique a compatibilidade de rigging |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Montar um modelo |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Redirecionar uma animação |

### Gerenciamento de tarefas

| Ponto final | Descrição |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Consultar uma tarefa |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Consultar tarefas em lote |

### Gerenciamento de arquivos

| Ponto final | Descrição |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Carregar um arquivo |

### Conta

| Ponto final | Descrição |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Consultar saldo da conta |