# Fatturazione
## Sistema di credito
Tripo API utilizza crediti per la fatturazione. Diversi tipi di attività consumano diversi numeri di crediti.
## Modello congelamento del credito/Deduction
| Palcoscenico | Descrizione |
| :-: | :-: |
| Creazione di attività | Congelare i crediti richiesti dal saldo disponibile |
| L'attività riesce | I crediti congelati diventano crediti consumati e vengono formalmente detratti |
| L'attività fallisce | I crediti congelati vengono restituiti al saldo disponibile |
| L'attività è annullata | I crediti congelati vengono restituiti al saldo disponibile |
Le attività non riuscite e annullate non vengono addebitate.
## Interroga il saldo
> **GET** `/v3/account/balance`
### curl
```bash
curl -X GET https://openapi.tripo3d.ai/v3/account/balance \
-H "Authorization: Bearer {api_key}"
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/account/balance"
headers = {
"Authorization": "Bearer {api_key}"
}
response = requests.get(url, headers=headers)
print(response.json())
```
### JavaScript
```javascript
const response = await fetch("https://openapi.tripo3d.ai/v3/account/balance", {
headers: {
"Authorization": "Bearer {api_key}"
}
});
const data = await response.json();
console.log(data);
```
### Esempio di risposta
```json
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
```
| Campo | Digitare | Descrizione |
| :-: | :-: | :-: |
| balance | intero | Saldo del credito disponibile |
| frozen | intero | Crediti congelati, pre-autorizzati per attività in corso |
## Visualizza utilizzo
> **GET** `/v3/account/usage`
### curl
```bash
curl -X GET https://openapi.tripo3d.ai/v3/account/usage \
-H "Authorization: Bearer {api_key}"
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/account/usage"
headers = {
"Authorization": "Bearer {api_key}"
}
response = requests.get(url, headers=headers)
print(response.json())
```
### JavaScript
```javascript
const response = await fetch("https://openapi.tripo3d.ai/v3/account/usage", {
headers: {
"Authorization": "Bearer {api_key}"
}
});
const data = await response.json();
console.log(data);
```
### Esempio di risposta
```json
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"
}
]
}
```
| Campo | Digitare | Descrizione |
| :-: | :-: | :-: |
| task_id | stringa | Identificatore univoco dell'attività |
| type | stringa | Tipo di attività |
| credits_consumed | intero | Crediti consumati |
| created_at | stringa | Ora di creazione, nel formato ISO 8601 |
Fatturazione
Sistema di credito
Tripo API utilizza crediti per la fatturazione. Diversi tipi di attività consumano diversi numeri di crediti.
Modello congelamento del credito/Deduction
| Palcoscenico |
Descrizione |
| Creazione di attività |
Congelare i crediti richiesti dal saldo disponibile |
| L’attività riesce |
I crediti congelati diventano crediti consumati e vengono formalmente detratti |
| L’attività fallisce |
I crediti congelati vengono restituiti al saldo disponibile |
| L’attività è annullata |
I crediti congelati vengono restituiti al saldo disponibile |
Le attività non riuscite e annullate non vengono addebitate.
Interroga il saldo
GET /v3/account/balance
-cmd">curl -X GET https://openapi.tripo3d.ai/v3/account/balance \
-H "Authorization: Bearer {api_key}"
import requests
url = "https://openapi.tripo3d.ai/v3/account/balance"
headers = {
"Authorization": "Bearer {api_key}"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://openapi.tripo3d.ai/v3/account/balance", {
headers: {
"Authorization": "Bearer {api_key}"
}
});
const data = await response.json();
console.log(data);
Esempio di risposta
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
| Campo |
Digitare |
Descrizione |
| balance |
intero |
Saldo del credito disponibile |
| frozen |
intero |
Crediti congelati, pre-autorizzati per attività in corso |
Visualizza utilizzo
GET /v3/account/usage
-cmd">curl -X GET https://openapi.tripo3d.ai/v3/account/usage \
-H "Authorization: Bearer {api_key}"
import requests
url = "https://openapi.tripo3d.ai/v3/account/usage"
headers = {
"Authorization": "Bearer {api_key}"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://openapi.tripo3d.ai/v3/account/usage", {
headers: {
"Authorization": "Bearer {api_key}"
}
});
const data = await response.json();
console.log(data);
Esempio di risposta
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"}
]
}
| Campo |
Digitare |
Descrizione |
| task_id |
stringa |
Identificatore univoco dell’attività |
| type |
stringa |
Tipo di attività |
| credits_consumed |
intero |
Crediti consumati |
| created_at |
stringa |
Ora di creazione, nel formato ISO 8601 |