API Trooper AI poskytuje komplexný prístup k správy GPU serverov, vrátane zriadenia serverov, monitoringu, migácie a administratívnych funkcií. Táto RESTful API vám umožňuje programovo spravovať vašu GPU infraštruktúru, vytvárať a sledovať objednávky serverov, pracovať s šablónami a vykonávať administratívne úlohy.
API koncové body a dokumentácia k API sú aktuálne vo fáze beta. V prípade problémov nás kontaktujte: Kontakty na podporu.
Vašu API klúč nájdete v sekcii API Konzola.
Tip pre pokročilých: Stačí túto dokumentáciu predložiť svojmu vývojovému LLM agentovi a on ju automaticky integruje do kódu.
Získať krátky prehľad o základných informáciách k API ako je URL, autentifikácia a viac:
https://james.trooper.ai
Väčšina koncoviek vyžaduje autentifikáciu pomocou Bearer tokenu s použitím vašho Trooper API klúča:
Authorization: Bearer YOUR_API_KEY
Získať svoj API kľúč z API Konzoly.
Všetky odpovedi API sú vo formáte JSON. Úspešné odpovedi typicky obsahujú:
success: boolean indikujúci úspešnosť operácieChyby v odpovediach zahŕňajú:
error: reťazec popisujúci chybunext: Voliteľné pole s návrhom ďalšieho kroku (napr. „prihlásenie“)GET /api/test
Jednoduchý testovací endpoint na overenie pripojenia k API.
GET /api/test
{
"test": "meinstring5"
}
Žiadosť GET /api/blibs
Vyberte všetky verejne dostupné konfigurácie GPU serverov.
GET /api/blibs
Authorization: Bearer YOUR_API_KEY # Optional - includes your private networks if provided
[
{
"id": 1,
"name": "powerai.example",
"gpu_type": "RTX 4090",
"gpu_num": 1,
"gpu_ram": 24,
"cpu_cores": 8,
"cpu_ram": 32,
"hdd": 500,
"price_h": 0.85,
"is_public": 1,
"country_code": "DE",
"is_available": true,
"available_hosts": ["ai18", "ai89"],
"fitCount": 2,
"maxPossibleInstances": 5
}
]
{
"error": "Error fetching Blibs"
}
Žiadosť /api/privatne-bloby
Vyberte GPU servery prístupné vašiemu účtu, vrátane súkromných konfigúracji.
GET /api/blibs-private
Authorization: Bearer YOUR_API_KEY
[
{
"id": 2,
"name": "RTX 4090 Dual Private",
"gpu_type": "RTX 4090",
"gpu_num": 2,
"gpu_ram": 24,
"cpu_cores": 16,
"cpu_ram": 64,
"hdd": 1000,
"price_h": 1.65,
"is_public": 1,
"country_code": "DE"
}
]
{
"error": "Missing or invalid Authorization header"
}
POST /api/objednávka
Vytvorte nový objednávku na GPU server. Musíte zadať uvedenú cenu, inak nebude objednávka prijatá. Takto sa uistite, že aktuálna cena zodpovedá vašim očakávaniam!
POST /api/order
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"blib_id": 1,
"price_h": 0.85,
"total_price": 0.85,
"terms_accepted": true,
"contract_interval": "HOUR",
"second_partition_percentage": 20,
"templates": [
{
"id": 1,
"name": "PyTorch Environment"
}
]
}
{
"success": true,
"orderId": 123
}
{
"error": "You must accept the terms and conditions."
}
{
"error": "Invalid or missing contract interval."
}
Žiadosť /api/objednávky
Vyberte všetky vaše objednávky na servery s podrobnými informáciami.
Pri práci s stavmi serverov zohľadňujte vzájomný vplyv medzi desired_status a current_status. Napríklad server môže mať desired_status zo "zastavený", ale jeho current_status môže ešte byť "spustené", ak je proces zastavenia v priebehu. Vaša aplikácia by mala zohľadniť tieto prechodové stavy a spracovať ich zodpovedne.
GET /api/orders
Authorization: Bearer YOUR_API_KEY
machine_name (voliteľné): Filtrujte podľa konkrétneho názvu stroja[
{
"order_id": 123,
"serverId": 123,
"title": "My PyTorch Server",
"status": "running",
"status_user": "running",
"server_name": "gpu-server-01",
"machine_name": "ai99_trooperai_000123",
"ip": "192.168.1.100",
"ssh_port": 22001,
"price_h": 0.85,
"paid_until": "2025-09-26T14:30:00.000Z",
"contract_interval": "HOUR",
"is_locked": false,
"is_low_priority": false,
"blib_name": "RTX 4090 Single",
"blib_gpu_type": "RTX 4090",
"blib_gpu_num": 1,
"country_code": "DE",
"template_installs": [
{
"id": 1,
"template_name": "PyTorch Environment",
"status": 1,
"status_readable": "Completed"
}
]
}
]
{
"error": "Missing or invalid Authorization header",
"next": "login"
}
POST /api/stav-objednávky
Aktualizujte stav objednávky vašho serveru (spustený, zastavený, restartovaný, zmrazený).
Nastaviť "migration_allowed": true ak schválite presun hostiteľa pri prechode zo stavu zamrznutého na spustený. Tento proces môže trvať 10–90 minút a zmení rozsah portov a potenciálne aj model/rychosť CPU.
POST /api/order-status
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"serverId": 123,
"desired_status": "running",
"migration_allowed": false
}
{
"success": true,
"updated": 1
}
{
"success": false,
"error": "Server is locked and cannot be modified"
}
POST /api/nákaz-zmenit-názov
Aktualizovať zobrazený názov vašho serveru.
POST /api/order-title
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"serverId": 123,
"title": "My New Server Title"
}
{
"success": true,
"message": "Title updated successfully"
}
POST /api/zamknutie-poradia
Zamknúť alebo odomknúť server na zabránenie/povolenie zmien stavu.
POST /api/order-lock
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"serverId": 123,
"is_locked": true
}
{
"success": true,
"updated": 1
}
POST /api/overenie
Získať SSH prihlasovacie údaje a detaily prepojenia na váš server.
POST /api/credentials
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"serverId": 123
}
{
"success": true,
"ssh_password": "generated-password"
}
{
"error": "Access denied or server not found"
}
Žiadosť GET /api/história-statu-obednávky
Získať posledných 5 zmen stavu objednávky servera.
GET /api/order-status-history?order_id=123
Authorization: Bearer YOUR_API_KEY
{
"success": true,
"history": [
{
"id": 1,
"status_user": "running",
"status_txt": "Server started successfully",
"status_since": "2025-09-25T10:30:00.000Z"
},
{
"id": 2,
"status_user": "stopped",
"status_txt": "Server stopped by user",
"status_since": "2025-09-25T08:15:00.000Z"
}
]
}
Migrácia sa používa na presun vašho GPU serveru do inej konfigurácie. Nedoporučujeme ju použiť v produkcii. Ale môžete si ju skúsiť ak chcete!
GET /api/migračné-možnosti
Získať dostupné konfigurácie serverov pre migráciu.
GET /api/migration-options?order_id=123
Authorization: Bearer YOUR_API_KEY
{
"success": true,
"currentOrder": {
"id": 123,
"title": "My Server",
"status": "running",
"contract_interval": "HOUR",
"paid_until": "2025-09-26T14:30:00.000Z"
},
"currentBlib": {
"id": 1,
"name": "RTX 4090 Single",
"gpu_type": "RTX 4090",
"gpu_num": 1,
"price_h": 0.85
},
"availableBlibs": [
{
"id": 2,
"name": "RTX 4090 Dual",
"gpu_type": "RTX 4090",
"gpu_num": 2,
"price_h": 1.65,
"is_available": true,
"additionalCostPerCycle": 0.80
}
]
}
POST /api/výpočet-migračnej-nákladu
Vypočítajte náklady na migráciu na inú konfiguráciu servera.
POST /api/migration-cost
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"order_id": 123,
"target_blib_id": 2
}
{
"success": true,
"upgradeCost": 15.50,
"remainingValue": 12.30,
"totalDue": 3.20,
"additionalCostPerCycle": 0.80,
"nextBillingDate": "2025-09-26T14:30:00.000Z",
"currentRate": {
"amount": 0.85,
"display": "€0.85/hour"
},
"newRate": {
"amount": 1.65,
"display": "€1.65/hour"
}
}
POST /api/kúpiť-presun
Spustiť migráciu na novú konfiguráciu servera.
DŮLEŽITÉ Ak sem posielate neplatné údaje, nič nie je zaručené. Podporný tím nemôže obnoviť vašu objednávku ak zneužijete tento koncový bod na nákup migrácií. Odporúčame používať UI Dashboad.
POST /api/buy-migration
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"order_id": 123,
"target_blib_id": 2,
"keep_data": true
}
{
"success": true,
"message": "Migration initiated successfully",
"new_order_id": 124
}
{
"error": "Insufficient budget for migration"
}
Žiadosť GET /api/shablóny
Získať všetky dostupné šablóny softvéru.
GET /api/templates
Authorization: Bearer YOUR_API_KEY # Optional
[
{
"id": 1,
"name": "PyTorch Environment",
"description": "Pre-configured PyTorch environment with CUDA support",
"category": "Machine Learning",
"is_public": true,
"options": [
{
"id": 1,
"name": "Python Version",
"type": "select",
"default_value": "3.9",
"possible_values": "3.8,3.9,3.10"
}
]
}
]
Žiadosť GET /api/template-config
Získať konfiguráciu nainštalovania šablóny pre konkrétnu objednávku.
GET /api/template-config?order_id=123
Authorization: Bearer YOUR_API_KEY
{
"success": true,
"templates": [
{
"install_id": 1,
"template_id": 1,
"template_name": "PyTorch Environment",
"status": 1,
"status_readable": "Completed",
"config": {
"python_version": "3.9"
}
}
]
}
POST /api/nainštalovať-náštampuľ
Nainštalujte nový šablónový prostredie na svojom serveri.
POST /api/template-install-add
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"order_id": 123,
"template_id": 1,
"config": {
"python_version": "3.9"
}
}
{
"success": true,
"install_id": 5,
"message": "Template installation queued"
}
POST /api/vzor-instalacia-mazat
Odstrániť nainštalovanú šablónu z vašho servera.
POST /api/template-install-delete
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"install_id": 5
}
{
"success": true,
"message": "Template removal initiated"
}
POST /api/nainštalovať-návrh-opakovanie
Opakovať neúspešnú instaláciu šablóny.
POST /api/template-install-retry
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"install_id": 5
}
{
"success": true,
"message": "Template installation retry initiated"
}
"Missing or invalid Authorization header": Autentizácia vyžadovaná"Invalid Trooper key": API klúč je neplatný"Unauthorized access": Nedostatočné oprávnenia"You must accept the terms and conditions": Nespĺnené podmienky pri vytváraní objednávky"Invalid or missing contract interval": Interval zmluvy musí byť HODINA, TIŽDEŇ alebo MESEC"Insufficient budget": Nedostatočný rozpočet na operáciu"Server is locked and cannot be modified": Server je zamknutý na úpravyAPI koncové body môžu byť omezované podľa počtu požadavkov na zabránenie zneužívaniu. Ak prekročíte limit, dostanete HTTP kód chyby 429 Too Many Requests. Zavádzkajte vhodnú logiku opakovania s exponenciálnym čakaním.
Pri otázkach alebo podpore k API kontaktujte: [email protected]
Ak máte k API ľubovolné otázky, kontaktujte nás: Kontakty na podporu