# Facturation
## Système de crédit
Le Tripo API utilise des crédits pour la facturation. Différents types de tâches consomment différents nombres de crédits.
## Gel du créditModèle /Deduction
| Scène | Descriptif |
| :-: | :-: |
| Création de tâches | Geler les crédits requis du solde disponible |
| La tâche réussit | Les crédits gelés deviennent des crédits consommés et sont formellement déduits |
| La tâche échoue | Les crédits gelés sont restitués au solde disponible |
| La tâche est annulée | Les crédits gelés sont restitués au solde disponible |
Les tâches échouées et annulées ne sont pas facturées.
## Solde de requête
> **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);
```
### Exemple de réponse
```json
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
```
| Champ | Tapez | Descriptif |
| :-: | :-: | :-: |
| balance | entier | Solde créditeur disponible |
| frozen | entier | Crédits gelés, pré-autorisés pour les tâches en cours |
## Afficher l'utilisation
> **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);
```
### Exemple de réponse
```json
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"
}
]
}
```
| Champ | Tapez | Descriptif |
| :-: | :-: | :-: |
| task_id | chaîne | Identifiant unique de la tâche |
| type | chaîne | Type de tâche |
| credits_consumed | entier | Crédits consommés |
| created_at | chaîne | Heure de création, au format ISO 8601 |
Facturation
Système de crédit
Le Tripo API utilise des crédits pour la facturation. Différents types de tâches consomment différents nombres de crédits.
Gel du créditModèle /Deduction
| Scène |
Descriptif |
| Création de tâches |
Geler les crédits requis du solde disponible |
| La tâche réussit |
Les crédits gelés deviennent des crédits consommés et sont formellement déduits |
| La tâche échoue |
Les crédits gelés sont restitués au solde disponible |
| La tâche est annulée |
Les crédits gelés sont restitués au solde disponible |
Les tâches échouées et annulées ne sont pas facturées.
Solde de requête
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);
Exemple de réponse
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
| Champ |
Tapez |
Descriptif |
| balance |
entier |
Solde créditeur disponible |
| frozen |
entier |
Crédits gelés, pré-autorisés pour les tâches en cours |
Afficher l’utilisation
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);
Exemple de réponse
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"}
]
}
| Champ |
Tapez |
Descriptif |
| task_id |
chaîne |
Identifiant unique de la tâche |
| type |
chaîne |
Type de tâche |
| credits_consumed |
entier |
Crédits consommés |
| created_at |
chaîne |
Heure de création, au format ISO 8601 |