Ristrutturazione del modello
# Ristrutturazione del modello
> **POST** `/v3/models/texture`
Rigenera le mappe texture per un modello esistente.
## 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ì | - | Fonte del modello. Accetta uno task_id che inizia con `task_`, uno file_token che inizia con `file_` o uno URL che inizia con `http(s)://` |
| model | stringa | No | Ultima versione | Versione modello AI |
| texture_seed | intero | No | Casuale | Seme casuale per la generazione di texture |
| texture_quality | stringa | No | `standard` | Qualità della trama. Valori disponibili: `standard`, `detailed`, `extreme` |
| pbr | booleano | No | `true` | Abilita materiali PBR |
## Richiedi esempi
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/models/texture \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"texture_quality": "detailed",
"pbr": true
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/models/texture"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"texture_quality": "detailed",
"pbr": True
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/models/texture";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
texture_quality: "detailed",
pbr: true
})
});
const data = await response.json();
console.log(data);
```
## 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 i risultati della generazione |
## 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 | Parametri di richiesta non supportati | 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 il tipo di attività per `task_id` sia corretto |
| 400 | 2007 | L'attività di origine non è stata completata correttamente | Attendi il completamento dell'attività di origine prima di iniziare la ristrutturazione |
| 403 | 2010 | Crediti insufficienti | Ricaricare i crediti e riprovare |
Ristrutturazione del modello
POST /v3/models/texture
Rigenera le mappe texture per un modello esistente.
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ì |
- |
Fonte del modello. Accetta uno task_id che inizia con task_, uno file_token che inizia con file_ o uno URL che inizia con http(s):// |
| model |
stringa |
No |
Ultima versione |
Versione modello AI |
| texture_seed |
intero |
No |
Casuale |
Seme casuale per la generazione di texture |
| texture_quality |
stringa |
No |
standard |
Qualità della trama. Valori disponibili: standard, detailed, extreme |
| pbr |
booleano |
No |
true |
Abilita materiali PBR |
Richiedi esempi
-cmd">curl -X POST https://openapi.tripo3d.ai/v3/models/texture \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"texture_quality": "detailed",
"pbr": true
}'
import requests
url = "https://openapi.tripo3d.ai/v3/models/texture"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"texture_quality": "detailed",
"pbr": True
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/models/texture";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
texture_quality: "detailed",
pbr: true
})
});
const data = await response.json();
console.log(data);
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 i risultati della generazione |
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 |
Parametri di richiesta non supportati |
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 il tipo di attività per task_id sia corretto |
| 400 |
2007 |
L’attività di origine non è stata completata correttamente |
Attendi il completamento dell’attività di origine prima di iniziare la ristrutturazione |
| 403 |
2010 |
Crediti insufficienti |
Ricaricare i crediti e riprovare |