# Faturalandırma
## Kredi Sistemi
Tripo API, faturalandırma için kredi kullanır. Farklı görev türleri farklı sayıda kredi tüketir.
## Kredi Dondurma/Deduction Modeli
| Sahne | Açıklama |
| :-: | :-: |
| Görev oluşturma | Mevcut bakiyeden gerekli kredileri dondurun |
| Görev başarılı oldu | Dondurulmuş krediler tüketilen kredilere dönüşür ve resmi olarak düşülür |
| Görev başarısız oluyor | Dondurulan krediler mevcut bakiyeye iade edilir |
| Görev iptal edildi | Dondurulan krediler mevcut bakiyeye iade edilir |
Başarısız olan ve iptal edilen görevlerden ücret alınmaz.
## Sorgu Bakiyesi
> **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);
```
### Yanıt Örneği
```json
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
```
| Alan | Tür | Açıklama |
| :-: | :-: | :-: |
| balance | tamsayı | Mevcut kredi bakiyesi |
| frozen | tamsayı | Devam eden görevler için ön yetkilendirilmiş dondurulmuş krediler |
## Kullanımı Görüntüle
> **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);
```
### Yanıt Örneği
```json
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"
}
]
}
```
| Alan | Tür | Açıklama |
| :-: | :-: | :-: |
| task_id | dize | Benzersiz görev tanımlayıcı |
| type | dize | Görev türü |
| credits_consumed | tamsayı | Tüketilen krediler |
| created_at | dize | Oluşturma zamanı, ISO 8601 formatında |
Faturalandırma
Kredi Sistemi
Tripo API, faturalandırma için kredi kullanır. Farklı görev türleri farklı sayıda kredi tüketir.
Kredi Dondurma/Deduction Modeli
| Sahne |
Açıklama |
| Görev oluşturma |
Mevcut bakiyeden gerekli kredileri dondurun |
| Görev başarılı oldu |
Dondurulmuş krediler tüketilen kredilere dönüşür ve resmi olarak düşülür |
| Görev başarısız oluyor |
Dondurulan krediler mevcut bakiyeye iade edilir |
| Görev iptal edildi |
Dondurulan krediler mevcut bakiyeye iade edilir |
Başarısız olan ve iptal edilen görevlerden ücret alınmaz.
Sorgu Bakiyesi
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);
Yanıt Örneği
{
"code": 0,
"data": {
"balance": 10000,
"frozen": 200
}
}
| Alan |
Tür |
Açıklama |
| balance |
tamsayı |
Mevcut kredi bakiyesi |
| frozen |
tamsayı |
Devam eden görevler için ön yetkilendirilmiş dondurulmuş krediler |
Kullanımı Görüntüle
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);
Yanıt Örneği
{
"code": 0,
"data": [
{
"task_id": "task_abc123",
"type": "text_to_model",
"credits_consumed": 100,
"created_at": "2026-01-01T00:00:00Z"}
]
}
| Alan |
Tür |
Açıklama |
| task_id |
dize |
Benzersiz görev tanımlayıcı |
| type |
dize |
Görev türü |
| credits_consumed |
tamsayı |
Tüketilen krediler |
| created_at |
dize |
Oluşturma zamanı, ISO 8601 formatında |