---
canonical_url: "https://docs.composio.dev/toolkits/vast_ai"
markdown_url: "https://docs.composio.dev/toolkits/vast_ai.md"
product: "platform"
version: null
last_updated: null
---

# Vast.ai

Search Vast.ai GPU compute offers, storage volume offers, and launch templates using a durable API key.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `VAST_AI`
- **Version:** 00000000_00

## Tools

### Search GPU Offers

**Slug:** `VAST_AI_SEARCH_GPU_OFFERS`

Find currently rentable Vast.ai GPU compute offers using verified marketplace filters. Returns compact offer identifiers, GPU capacity, and hourly pricing for comparison; it does not rent an offer. The connected API key must include Vast.ai's misc permission category.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of matching offers to return; must be at least 1. |
| `gpu_names` | array | No | Exact GPU model names to include; omit to allow any model. |
| `locations` | array | No | Exact provider geolocation labels to include; omit to search all locations. |
| `gpu_counts` | array | No | Exact GPU counts to include; omit to allow any count. |
| `rentable_only` | boolean | No | When true, return only offers currently available to rent; when false, do not filter by rentability. |
| `verified_only` | boolean | No | When true, return only host-verified offers; when false, do not filter by verification status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Templates

**Slug:** `VAST_AI_SEARCH_TEMPLATES`

Search Vast.ai launch templates by safe identifying metadata. The tool filters and pages locally because the provider returns a large unpaginated payload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum templates to return from the locally filtered matches (1-100). |
| `offset` | integer | No | Zero-based offset into the locally filtered matches; use next_offset from the previous response. |
| `hash_id` | string | No | Return only the template with this exact hash ID. |
| `template_id` | integer | No | Return only the template with this numeric ID. |
| `name_contains` | string | No | Case-insensitive text that the template name must contain. |
| `recommended_only` | boolean | No | When true, include only templates marked recommended by Vast.ai. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Volume Offers

**Slug:** `VAST_AI_SEARCH_VOLUME_OFFERS`

Find Vast.ai storage volume offers available in the marketplace. Returns compact location, capacity, and storage-cost details; it does not rent or modify a volume.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of volume offers to return; must be at least 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |