Completamento della parte mesh
# Completamento della parte mesh
> **POST** `/v3/mesh/complete`
Completa le parti della mesh segmentata e ripara le regioni mancanti.
## Richiedi parametri
### Richiedi intestazioni
| Parametro | Digitare | Obbligatorio | Predefinito | Descrizione |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | stringa | Sì | — | `application/json` |
| Authorization | stringa | Sì | — | `Bearer {api_key}` |
### Richiedi corpo
| Parametro | Digitare | Obbligatorio | Predefinito | Descrizione |
| :-: | :-: | :-: | :-: | :-: |
| input | stringa | Sì | — | task_id di un'attività `mesh/segment`, che inizia con `task_` |
| model | stringa | No | `v1.0-20250506` | Versione del modello di completamento (unica versione attuale) |
| part_names | stringa[] | No | Tutte le parti | Elenco dei nomi delle parti da completare. Se omesso, tutte le parti sono completate |
| completion_mode | stringa | No | `ai_completion` | Modalità di completamento: `ai_completion` (completamento basato su diffusione IA, predefinito) o `quick_cap` (tappo rapido senza IA) |
## Richiedi esempi
### Completamento IA (predefinito)
#### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"part_names": ["head", "body"]
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/mesh/complete"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"part_names": ["head", "body"]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/mesh/complete";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
part_names: ["head", "body"]
})
});
const data = await response.json();
console.log(data);
```
### Tappo rapido
#### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"completion_mode": "quick_cap"
}'
```
#### Python
```python
payload = {
"input": "task_abc123",
"completion_mode": "quick_cap"
}
```
#### JavaScript
```javascript
body: JSON.stringify({
input: "task_abc123",
completion_mode: "quick_cap"
})
```
## Risposta
### Risposta riuscita
```json
{
"code": 0,
"data": {
"task_id": "task_def456"
}
}
```
### Campi di risposta
| Parametro | Digitare | Descrizione |
| :-: | :-: | :-: |
| code | intero | Codice di stato. `0` indica successo |
| data.task_id | stringa | Identificatore univoco dell'attività utilizzato per interrogare l'avanzamento e il risultato del completamento |
## Codici di errore
| HTTP Codice di stato | Codice errore | Descrizione | Raccomandazione |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Limite di generazione superato | Ridurre la frequenza delle richieste e riprovare più tardi |
| 400 | 2002 | Parametro di richiesta non supportato | Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori |
| 400 | 2006 | Tipo di attività di origine di input non valido | Confermare che task_id corrisponda a un'attività `mesh/segment` |
| 400 | 2007 | Lo stato dell'attività di origine non ha esito positivo | Attendi il completamento dell'attività di origine prima di iniziare il completamento |
| 403 | 2010 | Crediti insufficienti | Ricaricare i crediti e riprovare |
Completamento della parte mesh
POST /v3/mesh/complete
Completa le parti della mesh segmentata e ripara le regioni mancanti.
Richiedi parametri
Richiedi intestazioni
| Parametro |
Digitare |
Obbligatorio |
Predefinito |
Descrizione |
| Content-Type |
stringa |
Sì |
— |
application/json |
| Authorization |
stringa |
Sì |
— |
Bearer {api_key} |
Richiedi corpo
| Parametro |
Digitare |
Obbligatorio |
Predefinito |
Descrizione |
| input |
stringa |
Sì |
— |
task_id di un’attività mesh/segment, che inizia con task_ |
| model |
stringa |
No |
v1.0-20250506 |
Versione del modello di completamento (unica versione attuale) |
| part_names |
stringa[] |
No |
Tutte le parti |
Elenco dei nomi delle parti da completare. Se omesso, tutte le parti sono completate |
| completion_mode |
stringa |
No |
ai_completion |
Modalità di completamento: ai_completion (completamento basato su diffusione IA, predefinito) o quick_cap (tappo rapido senza IA) |
Richiedi esempi
Completamento IA (predefinito)
-cmd">curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"part_names": ["head", "body"]
}'
import requests
url = "https://openapi.tripo3d.ai/v3/mesh/complete"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"part_names": ["head", "body"]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/mesh/complete";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
part_names: ["head", "body"]
})
});
const data = await response.json();
console.log(data);
Tappo rapido
-cmd">curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"completion_mode": "quick_cap"}'
payload = {
"input": "task_abc123",
"completion_mode": "quick_cap"
}
body: JSON.stringify({
input: "task_abc123",
completion_mode: "quick_cap"
})
Risposta
Risposta riuscita
{
"code": 0,
"data": {
"task_id": "task_def456"}
}
Campi di risposta
| Parametro |
Digitare |
Descrizione |
| code |
intero |
Codice di stato. 0 indica successo |
| data.task_id |
stringa |
Identificatore univoco dell’attività utilizzato per interrogare l’avanzamento e il risultato del completamento |
Codici di errore
| HTTP Codice di stato |
Codice errore |
Descrizione |
Raccomandazione |
| 429 |
2000 |
Limite di generazione superato |
Ridurre la frequenza delle richieste e riprovare più tardi |
| 400 |
2002 |
Parametro di richiesta non supportato |
Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori |
| 400 |
2006 |
Tipo di attività di origine di input non valido |
Confermare che task_id corrisponda a un’attività mesh/segment |
| 400 |
2007 |
Lo stato dell’attività di origine non ha esito positivo |
Attendi il completamento dell’attività di origine prima di iniziare il completamento |
| 403 |
2010 |
Crediti insufficienti |
Ricaricare i crediti e riprovare |