Uzyskanie klucza API
API GPUnex pozwala zarzadzac instancjami GPU, sprawdzac salda i automatyzowac przeplywy pracy bez korzystania z panelu webowego. Przed wyslaniem jakichkolwiek zadan API musisz wygenerowac klucz API.
-
Zaloguj sie na swoje konto GPUnex i przejdz do strony Profil lub panelu ustawien Pulpitu.
-
Otworz sekcje kluczy API. Szukaj zakladki lub karty Klucze API w ustawieniach konta.
-
Kliknij “Utworz nowy klucz API”. Zostaniesz poproszony o nadanie kluczowi opisowej nazwy. Wybierz cos znaczacego, np. “Serwer produkcyjny”, “Pipeline CI/CD” lub “Rozwoj lokalny”.
-
Skopiuj klucz API natychmiast. Po wygenerowaniu klucz zostanie wyswietlony dokladnie raz. Skopiuj go i przechowaj w bezpiecznym miejscu, takim jak menedzer hasel lub zaszyfrowany sejf.
-
Zrozum zakres klucza i odwolywanie. Kazdy klucz API jest przypisany do twojego konta i dziedziczy uprawnienia konta. Mozesz tworzyc wiele kluczy. Jesli klucz zostanie skompromitowany, mozesz go odwolac w dowolnym momencie.
Uwierzytelnianie
Wszystkie zadania do API GPUnex musza zawierac naglówek Authorization z kluczem API w schemacie Bearer token.
Format naglówka:
Authorization: Bearer TWOJ_KLUCZ_APIJesli klucz API jest brakujacy, nieprawidlowy lub odwolany, API zwróci odpowiedz 401 Unauthorized.
Glówne endpointy
API GPUnex jest zorganizowane wokól zasobów RESTful. Wszystkie endpointy uzywaja bazowego URL https://api.gpunex.com/v1.
| Metoda | Endpoint | Opis |
|---|---|---|
| GET | /v1/instances | Wyswietl wszystkie aktywne i ostatnie instancje. |
| POST | /v1/instances | Utworz nowa instancje GPU. Wymaga body JSON z modelem GPU, frameworkiem i regionem. |
| GET | /v1/instances/:id | Pobierz szczególowe informacje o konkretnej instancji. |
| DELETE | /v1/instances/:id | Zakoncz dzialajaca instancje. |
| GET | /v1/gpu-models | Wyswietl wszystkie dostepne modele GPU na marketplace. |
| GET | /v1/balance | Sprawdz aktualne saldo portfela USDC. |
Przyklad: Tworzenie instancji
Parametry body zadania:
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
gpu_model | string | Tak | Identyfikator modelu GPU. Uzyj /v1/gpu-models aby zobaczyc dostepne opcje. |
framework | string | Tak | Preinstalowany framework i wersja (np. pytorch-2.3, tensorflow-2.16, jax-0.4). |
region | string | Tak | Region centrum danych (np. us-east-1, eu-west-1, ap-southeast-1). |
Przyklad: Sprawdzanie statusu instancji
| Status | Znaczenie |
|---|---|
provisioning | Instancja jest konfigurowana. Zasoby GPU sa alokowane. |
running | Instancja jest aktywna i gotowa do uzycia. Dostep SSH jest dostepny. |
stopping | Instancja jest w trakcie zamykania. |
terminated | Instancja zostala zatrzymana i nie generuje juz oplat. |
error | Wystapil blad podczas provisioningu lub dzialania. |
Limity zapytan i najlepsze praktyki
Limity zapytan
- Ogólne endpointy: 120 zapytan na minute na klucz API.
- Tworzenie instancji: 10 zapytan na minute na klucz API.
- Saldo i endpointy tylko do odczytu: 300 zapytan na minute na klucz API.
Najlepsze praktyki
- Nigdy nie eksponuj kluczy API w kodzie po stronie klienta.
Ważne
Nigdy nie eksponuj klucza API w kodzie po stronie klienta, JavaScript przegladarki ani publicznych repozytoriach. Klucze API powinny byc uzywane wylacznie w aplikacjach po stronie serwera.
-
Uzywaj zmiennych srodowiskowych. Przechowuj klucz API w zmiennej srodowiskowej zamiast wpisywac go na stale w plikach zródlowych.
-
Rotuj klucze okresowo. Generuj nowy klucz API co 90 dni i odwoluj stary.
-
Uzywaj oddzielnych kluczy dla oddzielnych srodowisk.
Wskazówka
Uzywaj oddzielnych kluczy API dla srodowisk developerskiego, stagingowego i produkcyjnego. Dzieki temu odwolanie jednego klucza nie wplywa na inne srodowiska.
-
Obsluguj bledy z wdziekiem. Implementuj logike ponowien z wykladniczym opóznieniem dla odpowiedzi
429i5xx. -
Monitoruj uzycie. Sleedz wolumen zapytan API i wydatki na instancje.