API-referentie

Uw API-sleutel Verkrijgen

De GPUnex API stelt u in staat GPU-instanties te beheren, saldi te controleren en uw workflows te automatiseren zonder de webdashboard te gebruiken. Voordat u API-verzoeken doet, moet u een API-sleutel genereren.

1. Log in op uw GPUnex-account en navigeer naar uw Profiel-pagina of het Dashboard-instellingenpaneel.

2. Open de sectie API-sleutels. Zoek naar het tabblad of de kaart API-sleutels binnen uw accountinstellingen.

3. Klik op “Nieuwe API-sleutel Aanmaken”. U wordt gevraagd de sleutel een beschrijvende naam te geven. Kies iets betekenisvols dat het doel van de sleutel identificeert — bijvoorbeeld “Productieserver”, “CI/CD-pipeline” of “Lokale Ontwikkeling”. Dit maakt het later eenvoudiger om meerdere sleutels te beheren.

4. Kopieer uw API-sleutel onmiddellijk. Zodra de sleutel is gegenereerd, wordt deze precies één keer weergegeven. Kopieer hem en bewaar hem op een veilige locatie zoals een wachtwoordbeheerder of een versleutelde geheimekluis. U kunt de volledige sleutel na deze stap niet meer bekijken.

5. Begrijp sleutelbereik en intrekking. Elke API-sleutel is gekoppeld aan uw account en erft uw accountrechten. U kunt meerdere sleutels aanmaken voor verschillende applicaties of omgevingen. Als een sleutel is gecompromitteerd of niet meer nodig is, kunt u deze op elk moment intrekken vanuit de sectie API-sleutels. Het intrekken van een sleutel is onmiddellijk en permanent — alle verzoeken met die sleutel worden geweigerd.

Authenticatie

Alle verzoeken aan de GPUnex API moeten een Authorization-header bevatten met uw API-sleutel volgens het Bearer-tokenformaat.

Header-formaat:

Authorization: Bearer UW_API_SLEUTEL

Als de API-sleutel ontbreekt, ongeldig of ingetrokken is, retourneert de API een 401 Unauthorized-respons:

{
  "error": "unauthorized",
  "message": "Ongeldige of ontbrekende API-sleutel. Controleer uw Authorization-header."
}

Zorg ervoor dat uw sleutel bij elk verzoek is opgenomen. De API ondersteunt geen sessie-gebaseerde authenticatie of cookie-gebaseerde authenticatie.

Kern-endpoints

De GPUnex API is georganiseerd rond RESTful-resources. Alle endpoints gebruiken de basis-URL https://api.gpunex.com/v1. Hieronder volgt een samenvatting van de beschikbare kern-endpoints.

Alle responses worden geretourneerd in JSON-formaat. Succesvolle verzoeken retourneren een 200 OK-statuscode voor GET-verzoeken en een 201 Created-statuscode voor POST-verzoeken die resources aanmaken.

Voorbeeld: Een Instantie Aanmaken

Om een nieuwe GPU-instantie aan te maken, stuur een POST-verzoek naar /v1/instances met een JSON-body die uw gewenste configuratie specificeert.

Verzoek:

Verzoekbody-parameters:

Voorbeeldrespons (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"
}

De instantie heeft aanvankelijk de status provisioning. Zodra de GPU is toegewezen en de omgeving klaar is, verandert de status naar running en wordt het veld ssh_command gevuld met uw verbindingsstring. Provisioning duurt doorgaans tussen de 30 seconden en 2 minuten, afhankelijk van beschikbaarheid.

Voorbeeld: Instantiestatus Controleren

Zodra u een instantie heeft aangemaakt, kunt u op elk moment de huidige status controleren door het instantie-endpoint met het ID op te vragen.

Verzoek:

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

Voorbeeldrespons (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"
}

Statuswaarden:

Snelheidslimieten en Best Practices

Snelheidslimieten

De GPUnex API hanteert snelheidslimieten om eerlijk gebruik en platformstabiliteit te garanderen. De huidige limieten zijn:

• Algemene endpoints: 120 verzoeken per minuut per API-sleutel.
• Instantie-aanmaak: 10 verzoeken per minuut per API-sleutel.
• Saldo en alleen-lezen endpoints: 300 verzoeken per minuut per API-sleutel.

Als u de snelheidslimiet overschrijdt, retourneert de API een 429 Too Many Requests-respons met een Retry-After-header die aangeeft hoeveel seconden u moet wachten voordat u het opnieuw probeert.

{
  "error": "rate_limit_exceeded",
  "message": "Te veel verzoeken. Probeer het opnieuw na 12 seconden.",
  "retry_after": 12
}

Best Practices

Volg deze richtlijnen om uw integratie veilig en betrouwbaar te houden.

1. Stel API-sleutels nooit bloot in client-side code. Sluit uw API-sleutel niet in JavaScript dat in de browser draait, broncode van mobiele apps of openbaar toegankelijke repositories. API-sleutels mogen alleen worden gebruikt in server-side applicaties waar ze niet door eindgebruikers kunnen worden geïnspecteerd.

2. Gebruik omgevingsvariabelen. Bewaar uw API-sleutel in een omgevingsvariabele in plaats van deze hard te coderen in uw bronbestanden. Bijvoorbeeld:

   export GPUNEX_API_KEY="uw_api_sleutel_hier"

   Verwijs er vervolgens naar in uw code:

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

3. Roteer sleutels periodiek. Als beveiligings-best practice, genereer elke 90 dagen een nieuwe API-sleutel en trek de oude in. Dit beperkt de impact als een sleutel per ongeluk wordt gelekt.

4. Gebruik aparte sleutels voor aparte omgevingen. Maak verschillende API-sleutels aan voor ontwikkeling, staging en productie. Op deze manier heeft het intrekken van één sleutel geen invloed op andere omgevingen.

5. Behandel fouten sierlijk. Controleer altijd HTTP-statuscodes in uw applicatie. Implementeer retry-logica met exponentiële backoff voor 429- en 5xx-responses. Probeer 4xx-fouten anders dan 429 niet opnieuw — deze duiden op een probleem met het verzoek zelf.

6. Monitor uw gebruik. Houd uw API-aanroepvolume en instantie-uitgaven bij. Gebruik het /v1/balance-endpoint om programmatisch uw USDC-saldo te monitoren en waarschuwingen in te stellen als het onder een drempel zakt.