Krediler API

Endpoint maliyetlerini sorgulayın ve kredi bakiyenizi programatik olarak kontrol edin.

Kullanım Senaryoları
Bütçe planlaması

Kredi harcamalarınızı yönetmek için API çağrılarından önce maliyetleri hesaplayın.

Dashboard entegrasyonu

Kendi yönetim panelinizde gerçek zamanlı bakiye ve maliyet bilgilerini gösterin.

Akıllı otomasyon

Toplu işlerden önce bakiyeyi kontrol ederek çalışma sırasında kredi tükenmesini önleyin.

99.9 % Çalışma Süresi
Yanıt
20 req/s
0 Kredi / istek

Look up endpoint cost


POST https://api.yeb.to/v1/credits/cost
ParametreTürZorunluAçıklama
api_key string evet Your API key
endpoint string isteğe bağlı Single endpoint key, e.g. youtube/channel/audit
endpoints array isteğe bağlı Array of up to 50 endpoint keys (use instead of endpoint)

Örnek

curl -X POST https://api.yeb.to/v1/credits/cost \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "endpoint": "youtube/channel/audit"
}'

Yanıt Örneği

{
  "endpoint": "youtube/channel/audit",
  "credits": 0.01,
  "credits_spent": 0.0001,
  "credits_left": 142.5,
  "response_code": 200,
  "response_time_ms": 12
}
{"error":"Provide \"endpoint\" (string) or \"endpoints\" (array).","code":422}

Yanıt Kodları

KodAçıklama
200 Successİstek başarıyla işlendi.
400 Bad RequestGiriş doğrulama başarısız.
401 UnauthorizedEksik / yanlış API anahtarı.
403 ForbiddenAnahtar etkin değil veya izin verilmiyor.
429 Rate LimitÇok fazla istek.
500 Server ErrorBeklenmeyen hata.

Look up cost

credits/cost 0.0001 credits

Parameters

API Key
body · string · required
Endpoint
body · string
Endpoints
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Check credit balance


POST https://api.yeb.to/v1/credits/balance
ParametreTürZorunluAçıklama
api_key string evet Your API key

Örnek

curl -X POST https://api.yeb.to/v1/credits/balance \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

Yanıt Örneği

{
  "credits": 142.5,
  "credits_spent": 0.0001,
  "credits_left": 142.5,
  "response_code": 200,
  "response_time_ms": 8
}
{"error":"Cannot resolve user from API key.","code":401}

Yanıt Kodları

KodAçıklama
200 Successİstek başarıyla işlendi.
400 Bad RequestGiriş doğrulama başarısız.
401 UnauthorizedEksik / yanlış API anahtarı.
403 ForbiddenAnahtar etkin değil veya izin verilmiyor.
429 Rate LimitÇok fazla istek.
500 Server ErrorBeklenmeyen hata.

Check balance

credits/balance 0.0001 credits

Parameters

API Key
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Krediler API — Practical Guide

Look up how many credits any API endpoint costs and check your balance — all programmatically. Ideal for budget control, dashboards, and pre-flight checks before batch jobs.

#What the Credits API does

The Credits API lets you look up endpoint costs and check your balance without making an actual API call. Use it to build cost-aware workflows, display pricing in your UI, or validate you have enough credits before launching a batch job.

Each Credits API call costs only 0.0001 credits — essentially free.

#Endpoints

# POST /v1/credits/cost

  • Best for: Looking up the credit cost of any endpoint before calling it.
  • Single lookup: Send "endpoint": "youtube/channel/audit" to get one cost.
  • Bulk lookup: Send "endpoints": ["screenshot/capture", "qr/code"] for up to 50 at once.

# POST /v1/credits/balance

  • Best for: Checking your current credit balance from code.
  • Returns: Your total available credits.

#Quick start

# Look up a single endpoint cost
curl -X POST "https://api.yeb.to/v1/credits/cost" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{"endpoint": "screenshot/capture"}'
# Bulk lookup (up to 50 endpoints)
curl -X POST "https://api.yeb.to/v1/credits/cost" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{"endpoints": ["youtube/channel/audit", "qr/code", "geoip/city"]}'
# Check your balance
curl -X POST "https://api.yeb.to/v1/credits/balance" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>"

#Parameters

Cost endpoint

Param Type Required Description
endpoint string One of the two Single endpoint key, e.g. youtube/channel/audit
endpoints array One of the two Array of up to 50 endpoint keys for bulk lookup

Balance endpoint

No extra parameters — just authenticate with your API key.

#Reading responses

Single cost lookup

{
  "endpoint": "youtube/channel/audit",
  "credits": 0.01,
  "credits_spent": 0.0001,
  "credits_left": 142.5,
  "response_code": 200,
  "response_time_ms": 12
}

Bulk cost lookup

{
  "costs": {
    "screenshot/capture": 0.05,
    "qr/code": 0.009,
    "chatbot/message": 0.05
  },
  "credits_spent": 0.0001,
  "credits_left": 142.5,
  "response_code": 200,
  "response_time_ms": 8
}

Balance response

{
  "credits": 142.5,
  "credits_spent": 0.0001,
  "credits_left": 142.5,
  "response_code": 200,
  "response_time_ms": 8
}

#Endpoint key format

Endpoint keys follow the pattern module/action. Here are some examples:

KeyCreditsAPI
youtube/channel/audit0.01YouTube Channel
screenshot/capture0.05Screenshot
qr/code0.009QR Code Generator
geoip/city0.009GeoIP
chatbot/message0.05ChatBot
bot/detect/detect0.003Bot Detect
captions/transcribe1Captions
Use the /v1/credits/cost endpoint itself to discover costs for any key — if a key doesn't exist, it returns null.

#Practical recipes

  • Pre-flight check: Call /balance before a batch job. If credits < estimated cost, abort early and notify.
  • Pricing page: Fetch all costs with /cost and display them dynamically — always in sync with reality.
  • Usage dashboard: Combine /balance with your transaction history to show spend over time.

#Errors

HTTPWhenWhat to do
422 Neither endpoint nor endpoints provided Send at least one of the two parameters.
422 More than 50 endpoints in array Split into multiple requests.
401 Invalid or missing API key Check your API key in X-API-Key header or api_key param.

#API Changelog

2026-02-07
Initial release — /cost (single + bulk) and /balance endpoints.

Sıkça Sorulan Sorular

Neredeyse — her çağrı 0,0001 kredi maliyetindedir (esasen ücretsiz). Bu, erişilebilirliği korurken kötüye kullanımı önler.

Evet — en fazla 50 endpoint anahtarı içeren bir "endpoints" dizisi gönderin ve tüm maliyetleri tek bir yanıtta alın.

Evet — maliyetler doğrudan canlı yapılandırmadan okunur, bu nedenle her zaman güncel fiyatlandırmayı alırsınız.

Evet. Hata ile sonuçlananlar dahil her istek kredi tüketir. Kredileriniz başarı veya başarısızlıktan bağımsız olarak istek sayısına bağlıdır. Hata açıkça bizim tarafımızdaki bir platform sorunundaysa, etkilenen kredileri geri yükleriz (nakit iade yapılmaz).

[email protected] adresinden bize ulaşın. Geri bildirimleri ciddiye alıyoruz—hata raporunuz veya özellik isteğiniz anlamlıysa, API'yi hızla düzeltebilir veya geliştirebilir ve teşekkür olarak size 50 ücretsiz kredi verebiliriz.

API'ye ve bazen endpoint'e bağlıdır. Bazı endpoint'ler daha katı limitlere sahip olabilecek harici kaynaklardan veri kullanır. Ayrıca kötüye kullanımı önlemek ve platformumuzu stabil tutmak için limitler uyguluyoruz. Her endpoint'in belirli limiti için belgelere bakın.

Kredi sistemiyle çalışıyoruz. Krediler, API çağrıları ve araçlar için harcadığınız ön ödemeli, iade edilemez birimlerdir. Krediler FIFO (en eski önce) sırasıyla tüketilir ve satın alma tarihinden itibaren 12 ay geçerlidir. Kontrol paneli her satın alma tarihini ve son kullanma tarihini gösterir.

Evet. Satın alınan tüm krediler (kesirli bakiyeler dahil) satın almadan itibaren 12 ay geçerlidir. Kullanılmayan krediler geçerlilik süresinin sonunda otomatik olarak sona erer ve kalıcı olarak silinir. Süresi dolan krediler geri yüklenemez veya nakde ya da başka bir değere dönüştürülemez. Geçiş kuralı: 22 Eyl 2025 öncesi satın alınan krediler 22 Eyl 2025'te satın alınmış olarak kabul edilir ve 22 Eyl 2026'da sona erer (satın alma sırasında daha erken bir son kullanma tarihi belirtilmedikçe).

Evet—geçerlilik süreleri içinde. Kullanılmayan krediler mevcut kalır ve satın almadan 12 ay sonra sona erene kadar aydan aya devredilir.

Krediler iade edilemez. Sadece ihtiyacınız olanı satın alın—her zaman daha sonra yükleyebilirsiniz. Bir platform hatası başarısız bir ücretlendirmeye neden olursa, soruşturma sonrası etkilenen kredileri geri yükleyebiliriz. Nakit iade yapılmaz.

Fiyatlar dolar değil kredi olarak belirlenir. Her endpoint'in kendi maliyeti vardır—yukarıdaki "Kredi / istek" rozetine bakın. Her zaman tam olarak ne harcadığınızı bilirsiniz.
← API'lere Dön