API Referansı

API Anahtarınızı Alma

GPUnex API, web kontrol panelini kullanmadan GPU instance’larını yönetmenize, bakiyeleri kontrol etmenize ve iş akışlarınızı otomatikleştirmenize olanak tanır. Herhangi bir API isteği yapmadan önce bir API anahtarı oluşturmanız gerekmektedir.

1. GPUnex hesabınıza giriş yapın ve Profil sayfanıza veya Kontrol Paneli ayarlar bölümüne gidin.

2. API Anahtarları bölümünü açın. Hesap ayarlarınızdaki API Anahtarları sekmesini veya kartını bulun.

3. “Yeni API Anahtarı Oluştur” düğmesine tıklayın. Anahtara açıklayıcı bir ad vermeniz istenecektir. Anahtarın amacını belirleyen anlamlı bir isim seçin — örneğin, “Üretim Sunucusu”, “CI/CD Pipeline” veya “Yerel Geliştirme”. Bu, birden fazla anahtarı daha sonra yönetmeyi kolaylaştırır.

4. API anahtarınızı hemen kopyalayın. Anahtar oluşturulduktan sonra yalnızca bir kez görüntülenecektir. Kopyalayın ve bir parola yöneticisi veya şifreli bir gizli anahtar kasası gibi güvenli bir konumda saklayın. Bu adımdan sonra tam anahtarı tekrar görüntüleyemezsiniz.

5. Anahtar kapsamını ve iptalini anlayın. Her API anahtarı hesabınıza bağlıdır ve hesap izinlerinizi devralır. Farklı uygulamalar veya ortamlar için birden fazla anahtar oluşturabilirsiniz. Bir anahtar ele geçirilirse veya artık gerekli değilse, API Anahtarları bölümünden istediğiniz zaman iptal edebilirsiniz. Bir anahtarın iptali anında ve kalıcıdır — o anahtarı kullanan tüm istekler reddedilecektir.

Kimlik Doğrulama

GPUnex API’sine yapılan tüm istekler, Bearer token şemasını kullanarak API anahtarınızı içeren bir Authorization başlığı içermelidir.

Başlık formatı:

Authorization: Bearer YOUR_API_KEY

API anahtarı eksik, geçersiz veya iptal edilmişse, API 401 Unauthorized yanıtı döndürecektir:

{
  "error": "unauthorized",
  "message": "Invalid or missing API key. Please check your Authorization header."
}

Anahtarınızın her istekte bulunduğundan emin olun. API, oturum tabanlı kimlik doğrulamayı veya çerez tabanlı kimlik doğrulamayı desteklemez.

Temel Uç Noktalar

GPUnex API, RESTful kaynaklar etrafında düzenlenmiştir. Tüm uç noktalar https://api.gpunex.com/v1 temel URL’sini kullanır. Aşağıda mevcut temel uç noktaların bir özeti bulunmaktadır.

Tüm yanıtlar JSON formatında döndürülür. Başarılı istekler, GET istekleri için 200 OK durum kodu ve kaynak oluşturan POST istekleri için 201 Created durum kodu döndürür.

Örnek: Instance Oluşturma

Yeni bir GPU instance’ı oluşturmak için, istediğiniz yapılandırmayı belirten bir JSON gövdesiyle /v1/instances adresine bir POST isteği gönderin.

İstek:

İstek gövdesi parametreleri:

Örnek yanıt (201 Created):

{
  "id": "inst_7f3a9b2c4d1e",
  "status": "provisioning",
  "gpu_model": "A100_80GB",
  "framework": "pytorch-2.3",
  "region": "us-east-1",
  "ssh_command": null,
  "hourly_rate": "1.89",
  "currency": "USDC",
  "created_at": "2026-02-15T14:32:07Z"
}

Instance başlangıçta provisioning durumunda olacaktır. GPU tahsis edilip ortam hazır olduğunda, durum running olarak değişecek ve ssh_command alanı bağlantı dizginizle doldurulacaktır. Hazırlık süreci, kullanılabilirliğe bağlı olarak genellikle 30 saniye ile 2 dakika arasında sürer.

Örnek: Instance Durumunu Kontrol Etme

Bir instance oluşturduktan sonra, kimliğiyle instance uç noktasını sorgulayarak mevcut durumunu istediğiniz zaman kontrol edebilirsiniz.

İstek:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.gpunex.com/v1/instances/inst_7f3a9b2c4d1e

Örnek yanıt (200 OK):

{
  "id": "inst_7f3a9b2c4d1e",
  "status": "running",
  "gpu_model": "A100_80GB",
  "framework": "pytorch-2.3",
  "region": "us-east-1",
  "ssh_command": "ssh [email protected] -p 2222",
  "ip_address": "203.0.113.42",
  "hourly_rate": "1.89",
  "currency": "USDC",
  "uptime_seconds": 3847,
  "total_cost": "2.02",
  "created_at": "2026-02-15T14:32:07Z",
  "started_at": "2026-02-15T14:33:15Z"
}

Durum değerleri:

Hız Sınırları ve En İyi Uygulamalar

Hız Sınırları

GPUnex API, adil kullanım ve platform kararlılığını sağlamak için hız sınırları uygular. Mevcut sınırlar şunlardır:

• Genel uç noktalar: API anahtarı başına dakikada 120 istek.
• Instance oluşturma: API anahtarı başına dakikada 10 istek.
• Bakiye ve salt okunur uç noktalar: API anahtarı başına dakikada 300 istek.

Hız sınırını aşarsanız, API yeniden denemeden önce kaç saniye beklemeniz gerektiğini belirten bir Retry-After başlığıyla birlikte 429 Too Many Requests yanıtı döndürecektir.

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please retry after 12 seconds.",
  "retry_after": 12
}

En İyi Uygulamalar

Entegrasyonunuzu güvenli ve güvenilir tutmak için bu yönergeleri takip edin.

1. API anahtarlarını istemci tarafı kodunda asla açığa çıkarmayın. API anahtarınızı tarayıcıda çalışan JavaScript’e, mobil uygulama kaynak koduna veya herkesin erişebileceği bir depoya yerleştirmeyin. API anahtarları yalnızca son kullanıcılar tarafından incelenemeyen sunucu tarafı uygulamalarda kullanılmalıdır.

2. Ortam değişkenlerini kullanın. API anahtarınızı kaynak dosyalarınıza sabit kodlamak yerine bir ortam değişkeninde saklayın. Örneğin:

   export GPUNEX_API_KEY="your_api_key_here"

   Ardından kodunuzda referans verin:

   curl -H "Authorization: Bearer $GPUNEX_API_KEY" https://api.gpunex.com/v1/instances

3. Anahtarları periyodik olarak değiştirin. Güvenlik en iyi uygulaması olarak, her 90 günde bir yeni API anahtarı oluşturun ve eskisini iptal edin. Bu, bir anahtarın yanlışlıkla sızması durumunda etkiyi sınırlar.

4. Farklı ortamlar için ayrı anahtarlar kullanın. Geliştirme, staging ve üretim için ayrı API anahtarları oluşturun. Bu şekilde, bir anahtarın iptali diğer ortamları etkilemez.

5. Hataları zarif bir şekilde yönetin. Uygulamanızda her zaman HTTP durum kodlarını kontrol edin. 429 ve 5xx yanıtları için üstel geri çekilmeli yeniden deneme mantığı uygulayın. 429 dışındaki 4xx hatalarını yeniden denemeyin — bunlar isteğin kendisiyle ilgili bir sorunu gösterir.

6. Kullanımınızı izleyin. API çağrı hacminizi ve instance harcamalarınızı takip edin. USDC bakiyenizi programatik olarak izlemek ve bir eşiğin altına düşerse uyarılar ayarlamak için /v1/balance uç noktasını kullanın.