개발자와 ML 팀을 위해 만들었습니다

REST API, 범위가 지정된 API 키, 서명된 웹훅으로 코드에서 GPU 인스턴스를 시작, 모니터링, 중지하세요.

오퍼는 출시일에 공개됩니다. 지금 계정을 만들면 마켓이 열리는 즉시 코드에서 GPU를 시작할 수 있습니다.

예시: 이용 가능한 오퍼 목록shell

curl -H "Authorization: Bearer $EVERXCLOUD_API_KEY" \
  "https://api.everxcloud.ai/v1/offers?gpu_model=h100-sxm-80gb&limit=5"

예시로 보는 API

예시에서 $EVERXCLOUD_API는 API 기본 URL, $EVERXCLOUD_STREAM은 스트리밍 기본 URL, $EVERXCLOUD_API_KEY는 사용자의 API 키입니다.

REST API와 범위 지정 API 키
포털에서 할 수 있는 모든 기능을 /v1에서 사용할 수 있습니다: 카탈로그, 인스턴스, SSH 키, 잔액과 사용량, 스팟 거래소 주문, 예약, 시간 패키지. 목록은 커서로 페이지가 나뉘며 모든 생성 요청에는 Idempotency-Key가 필요합니다.
- 포털에서 instances:read, instances:write, billing:read, webhooks:manage처럼 필요한 범위만 가진 키를 만드세요.
- 키는 Authorization: Bearer sk_live_… 형식으로 보냅니다. 한 번만 표시되고 해시로 저장되며 언제든지 폐기할 수 있습니다.
- 금액은 해당 통화의 마이크로 단위 정수(1단위 = 1,000,000)이며 항상 통화 필드(USD, EUR, GBP)가 함께 제공됩니다.
잔액 조회shell
```
curl -H "Authorization: Bearer $EVERXCLOUD_API_KEY" \
  "$EVERXCLOUD_API/v1/balance"
```
머신 템플릿과 SSH 접속
준비된 템플릿과 SSH 키 하나로 오퍼에서 인스턴스를 시작하고, 실행될 때까지 상태를 확인한 뒤 SSH로 접속하세요.
- 템플릿: ubuntu-cuda, pytorch, tensorflow, jupyter, vllm, comfyui.
- 인스턴스는 SSH 호스트, 포트, 사용자를 제공합니다. EverXCloud Network 장비는 직접 접속하거나, 직접 접속이 불가능하면 릴레이를 통해 접속합니다.
- 공급자가 지원하는 경우 API로 인스턴스를 중지, 시작, 삭제할 수 있으며 청구는 상태를 따릅니다. 인스턴스를 삭제하면 데이터도 삭제되므로 직접 사본을 보관하세요.
인스턴스 시작shell
```
curl -X POST "$EVERXCLOUD_API/v1/instances" \
  -H "Authorization: Bearer $EVERXCLOUD_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"offer_id": "<offer id>", "expected_hourly_price_micro": 2160000, "currency": "EUR", "template_id": "pytorch", "ssh_key_id": "<key id>"}'
```
웹훅과 실시간 스트림
인스턴스, 잔액, 충전, 견적, 주문, 시간 패키지 이벤트에 엔드포인트를 구독하세요. 모든 전송은 서명되고, 간격을 늘려 가며 재시도되며, 중복을 걸러낼 수 있는 전송 ID(X-EverXCloud-Delivery)가 포함됩니다.
- 각 전송의 X-EverXCloud-Signature 헤더(t=…,v1=…)를 엔드포인트 시크릿으로 검증하세요.
- 이벤트에는 instance.ready, instance.expiring, instance.terminated, balance.low, balance.topup, order.filled, credits.expiring이 있습니다.
- 마켓 가격은 Server-Sent Events로 스트리밍됩니다. /v1/stream/market은 공개이며, /v1/stream/orders는 exchange:read 범위를 가진 API 키로 본인의 주문을 따라갑니다.
마켓 가격 스트리밍shell
```
curl -N "$EVERXCLOUD_STREAM/v1/stream/market?skus=rtx-5090-32gb:fr:1:EUR"
```

출시일에 바로 시작하세요

지금 계정을 만드세요. 마켓이 열리는 즉시 범위 지정 API 키를 만들고 코드에서 GPU를 시작할 수 있습니다.

우선 이용 신청 마켓 검색

예시로 보는 API

REST API와 범위 지정 API 키

머신 템플릿과 SSH 접속

웹훅과 실시간 스트림

출시일에 바로 시작하세요