Overview

import { Verlon } from '@verlon-ai/sdk';

const verlon = new Verlon({
  apiKey: process.env.VERLON_API_KEY
});

const response = await verlon.chat({
  gateId: 'your-gate-id',
  data: {
    messages: [
      { role: 'user', content: 'Hello!' }
    ]
  }
});

console.log(response.content);

import { Verlon } from '@verlon-ai/sdk';

const verlon = new Verlon({
  apiKey: 'your-api-key',        // Required
  baseUrl: 'https://custom.api'  // Optional, defaults to https://api.verlon.ai
});

interface VerlonResponse {
  // Common fields
  id: string;              // Request ID
  model: string;           // Model used
  cost: number;            // Request cost in USD
  latency: number;         // Response time in ms

  // Method-specific fields
  content?: string;        // Chat response text
  data?: any[];            // Image/video/embedding data
  url?: string;            // Audio file URL
  text?: string;           // OCR extracted text

  // Usage statistics
  usage?: {
    promptTokens: number;
    completionTokens: number;
    totalTokens: number;
  };
}

try {
  const response = await verlon.chat({
    gateId: 'your-gate-id',
    data: {
      messages: [{ role: 'user', content: 'Hello!' }]
    }
  });

  console.log(response.content);
} catch (error) {
  console.error('Error:', error.message);
}

import { Verlon, ChatRequest, VerlonResponse } from '@verlon-ai/sdk';

const verlon = new Verlon({
  apiKey: process.env.VERLON_API_KEY!
});

// TypeScript knows the structure
const response: VerlonResponse = await verlon.chat({
  gateId: 'your-gate-id',
  data: {
    messages: [
      { role: 'user', content: 'Hello!' }
    ]
  }
});

// Autocomplete and type safety
console.log(response.content);  // TypeScript knows this exists
console.log(response.cost);     // TypeScript knows this is a number

// Good ✅
const verlon = new Verlon({
  apiKey: process.env.VERLON_API_KEY
});

// Bad ❌
const verlon = new Verlon({
  apiKey: 'sk-vrln-hardcoded_key'  // Never do this!
});