Tripo3D

Kullanım Geçmişi

Kullanım Geçmişi

GET /v3/account/usage/history

Çağıran API anahtarının bir zaman aralığında oluşturulan başarılı görevlerini, en yeniden eskiye doğru, her görevin harcadığı kredilerle birlikte listeler. Otomatik mutabakat için tasarlanmıştır: prompt, girdi, çıktı veya indirme bağlantısı döndürülmez.

  • Kapsam, çağıran API anahtarıdır. Birden fazla anahtarı mutabık kılmak için her anahtarla ayrı sorgulayın.
  • Yalnızca başarılı görevler listelenir. Başarısız, süresi dolan veya reddedilen görevler (genellikle iade edilir) dahil değildir; bu nedenle sonuç fatura kayıtlarınızla satır satır eşleştirilemez.
  • Filtreleme görev oluşturma zamanına göre yapılır. Sorgu anında hâlâ çalışan görevler henüz başarılı değildir; bu nedenle en az 30 dakika önce bitmiş aralıkları sorgulayın.
  • Hız sınırı: API anahtarı başına dakikada 60 istek. Sınır aşılırsa Retry-After başlığıyla 429 döner.

İstek Parametreleri

Başlıkları Talep Et

Parametre Tür Gerekli Varsayılan Açıklama
Authorization dize Evet — Bearer {api_key}

Sorgu Parametreleri

Parametre Tür Gerekli Varsayılan Açıklama
start_time dize Evet — Aralık başlangıcı (dahil). Saat dilimi farkı içeren RFC 3339, ör. 2026-10-01T00:00:00Z
end_time dize Evet — Aralık sonu (hariç). Aynı biçim; start_time sonrasında ve en fazla 31 gün sonra
page_size tamsayı Hayır 100 Sayfa başına öğe, 1–100
cursor dize Hayır — Önceki sayfanın next_cursor değeri; ilk sayfada göndermeyin. Sayfalama sırasında start_time ve end_time değerlerini değiştirmeyin

Örnek Talep

curl

Bash
curl -G https://openapi.tripo3d.ai/v3/account/usage/history \
  -H "Authorization: Bearer {api_key}" \
  --data-urlencode "start_time=2026-10-01T00:00:00Z" \
  --data-urlencode "end_time=2026-11-01T00:00:00Z" \
  --data-urlencode "page_size=100"

Python (tüm sayfalar)

Python
import time
import requests

url = "https://openapi.tripo3d.ai/v3/account/usage/history"
headers = {"Authorization": "Bearer {api_key}"}
params = {
    "start_time": "2026-10-01T00:00:00Z",
    "end_time": "2026-11-01T00:00:00Z",
    "page_size": 100,
}
total = 0.0
while True:
    r = requests.get(url, params=params, headers=headers)
    if r.status_code in (429, 503):
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    r.raise_for_status()
    data = r.json()["data"]
    for item in data["items"]:
        total += item["credits_consumed"]
    if not data["has_more"]:
        break
    params["cursor"] = data["next_cursor"]
print(f"credits consumed: {total:.2f}")

Yanıt

Başarılı Yanıt

JSON
{
  "code": 0,
  "status": "success",
  "data": {
    "items": [
      {
        "task_id": "123e4567-e89b-42d3-a456-426614174000",
        "type": "text_to_model",
        "model_version": "v3.0-20250812",
        "status": "success",
        "created_at": "2026-10-31T15:59:58.123456Z",
        "completed_at": "2026-10-31T16:01:12.654321Z",
        "credits_consumed": 30.00
      }
    ],
    "has_more": true,
    "next_cursor": "djE6MTc2MTkyNjM5ODEyMzQ1NjoxMjNlNDU2Ny1lODliLTQyZDMtYTQ1Ni00MjY2MTQxNzQwMDA"
  }
}

Yanıt Alanları

Parametre Tür Açıklama
code tamsayı Durum kodu. 0 başarıyı gösterir
data.items dizi Bu sayfadaki görevler, en yeniden eskiye
data.items[].task_id dize Görev kimliği
data.items[].type dize Görev türü, görev sorgusundaki değerle aynı
data.items[].model_version dize Oluşturma sırasında kaydedilen model sürümü; görev türünde yoksa döndürülmez
data.items[].status dize Her zaman success
data.items[].created_at dize Oluşturma zamanı, UTC’de ISO 8601
data.items[].completed_at dize Tamamlanma zamanı, UTC’de ISO 8601; kaydedilmediyse döndürülmez
data.items[].credits_consumed number Tahsil edilen kredi, görev sorgusundaki credits_consumed ile aynı; tahsilat yoksa 0
data.has_more boolean Başka sayfa olup olmadığı
data.next_cursor dize Sonraki sayfayı almak için cursor olarak gönderin; son sayfada null

Hata Kodları

HTTP Durum Kodu Hata Kodu Açıklama Tavsiye
400 1004 Geçersiz parametre (eksik veya hatalı zaman, 31 günü aşan aralık, geçersiz page_size veya cursor) message içinde belirtilen parametreyi düzeltin
429 1007 Hız sınırı aşıldı Retry-After saniye bekleyip yeniden deneyin
503 1008 Geçici olarak kullanılamıyor Retry-After saniye bekleyip aynı isteği yineleyin
ÖncekiHesapSonrakiHata İşleme