JavaScript SDK

npm install @vulk/sdk

import { VulkClient } from '@vulk/sdk';

const vulk = new VulkClient({
  apiKey: 'vk_your_api_key_here'
});

// List your projects
const projects = await vulk.projects.list();

// Create a new project  
const project = await vulk.projects.create({
  prompt: 'Create a landing page for a SaaS product'
});

const vulk = new VulkClient({
  apiKey: 'vk_xxx',        // Required
  baseUrl: 'https://vulk.dev/api/v1', // Optional
  timeout: 30000           // Optional (ms)
});

const { projects } = await vulk.projects.list({
  limit: 20,
  offset: 0
});

const project = await vulk.projects.get('project-id');

const project = await vulk.projects.create({
  prompt: 'Build a dashboard for analytics',
  model: 'google/gemini-3-pro-preview' // Optional
});

const { models } = await vulk.models.list();

// Returns array of available AI models with:
// - id, name, provider, category, multiplier

const usage = await vulk.usage.get();

// Returns:
// - apiKeys (list of your keys)
// - recentUsage (last 50 requests)
// - totalRequests

try {
  const project = await vulk.projects.create({ prompt: '...' });
} catch (error) {
  if (error.status === 401) {
    console.error('Invalid API key');
  } else if (error.status === 429) {
    console.error('Rate limit exceeded');
  }
}

import type { Project, AIModel, ApiUsage } from '@vulk/sdk';