Overview
This node integrates with the Vast AI platform API, allowing users to perform various operations related to account management, billing, instances, search, serverless functions, templates, and volumes. Specifically, the "Search" resource with the "Search" operation enables searching for offers on Vast AI.
Common scenarios include:
- Searching for available machine offers or resources on Vast AI based on custom criteria.
- Automating queries to Vast AI's marketplace to find suitable compute instances.
- Integrating Vast AI search results into workflows for further processing or decision-making.
Practical example:
- A user wants to find all available GPU-enabled machines that meet certain specifications. They configure this node to perform a search with specific parameters, then use the output to provision instances or notify stakeholders.
Properties
| Name | Meaning |
|---|---|
| API Group Name or ID | Selects the specific Vast AI API endpoint to call within the chosen operation. Options are dynamically loaded based on the selected operation. For "Search" operation, options include "Search Offers". |
| Body | Key-value pairs representing the request body parameters sent to the API. Multiple parameters can be specified. Blank if the HTTP method is GET. The keys are parameter names or IDs (dynamically loaded), and values are strings. |
Output
The node outputs an array of JSON objects corresponding to the API response from Vast AI. Each item in the output contains a json field holding the parsed JSON response from the API call.
For the "Search" operation, the output JSON typically includes search results such as available offers matching the query parameters.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Vast AI to authenticate requests.
- The node makes HTTP requests to the Vast AI API at
https://console.vast.ai/api/v0. - No additional external dependencies beyond standard HTTP and authentication.
Troubleshooting
- Missing required path parameter errors: Many API calls require specific path parameters (e.g.,
id,instance_id,key). If these are not provided, the node throws an error indicating which parameter is missing. Ensure all required parameters are set correctly. - Authentication errors: If the API key credential is invalid or missing, requests will fail. Verify the API key is correct and has necessary permissions.
- Invalid parameter names or values: Using incorrect parameter names or unsupported values in the Body property may cause API errors. Use the dynamic options loading feature to select valid parameters.
- HTTP request failures: Network issues or Vast AI service downtime can cause request failures. Check connectivity and Vast AI status.
Links and References
- Vast AI API Documentation
- n8n Expressions Documentation (for using expressions in properties)