Overview - DeployGPU

The DeployGPU API lets you programmatically deploy GPU instances, manage volumes, and check your account. All endpoints are under /api/v1/.

Base URL

https://api.deploygpu.ai/api/v1

OpenAPI Specification

The full OpenAPI 3.1 JSON spec is available at:

https://api.deploygpu.ai/api-docs

Import this URL into tools like Postman, Insomnia, or any OpenAPI-compatible client to auto-generate requests.

Authentication

Authenticated endpoints require an API key. Pass it in either header:

# Option 1: X-API-Key header
curl -H "X-API-Key: gpu_live_xxx" https://api.deploygpu.ai/api/v1/account/balance

# Option 2: Authorization Bearer
curl -H "Authorization: Bearer gpu_live_xxx" https://api.deploygpu.ai/api/v1/account/balance

Create API keys from the dashboard under Settings > API Keys. See API Keys for details.

Public catalog endpoints (offers, GPU families, providers) do not require authentication. All other endpoints do.

Error Format

All errors return a consistent JSON envelope:

{
  "error": {
    "code": "not_found",
    "message": "Deployment not found"
  }
}

Error Codes

HTTP Status	Code	Description
400	`bad_request`	Invalid parameters
400	`validation_error`	Validation failed (may include `fields` map)
400	`provider_not_found`	Unknown provider name
400	`provider_not_supported`	Provider not yet supported via API
400	`invalid_request`	Malformed request body
401	—	Missing or invalid API key
402	`insufficient_balance`	Not enough credits
404	`not_found`	Resource not found or not owned by you
429	`rate_limited`	Rate limit exceeded
500	`internal_error`	Unexpected server error

Insufficient Balance Example

When you don’t have enough credits to create a deployment or volume, the error includes your current and required balance:

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance. Required: $1.4500, available: $0.5000",
    "current_balance": "0.5000",
    "required_balance": "1.4500"
  }
}

Rate Limits

All v1 endpoints share a rate limit of 300 requests per 15 minutes per IP address. The X-RateLimit-Remaining response header shows how many requests you have left. When exceeded, the API returns 429:

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please try again later."
  }
}

Monetary Values

All monetary amounts are returned as strings with 4 decimal places (e.g., "1.4500"). This avoids floating-point precision issues.

Timestamps

All timestamps are in ISO 8601 format with UTC timezone (e.g., "2026-05-10T20:12:51.596837Z").

​Base URL

​OpenAPI Specification

​Authentication

​Error Format

​Error Codes

​Insufficient Balance Example

​Rate Limits

​Monetary Values

​Timestamps

Base URL

OpenAPI Specification

Authentication

Error Format

Error Codes

Insufficient Balance Example

Rate Limits

Monetary Values

Timestamps