Configuration

The DhivehiGPT client accepts the following options:

Option	Type	Required	Default	Description
`apiKey`	`string`	No	`process.env.DHIVEHIGPT_API_KEY`	Your DhivehiGPT API key. Falls back to the `DHIVEHIGPT_API_KEY` environment variable; throws if neither is set.
`baseUrl`	`string`	No	`https://api.dhivehigpt.com`	Override the API base URL, e.g. for testing against a staging environment.
`apiVersion`	`string`	No	`v1`	Override the API version path segment, e.g. `v2`.
`timeoutMs`	`number`	No	No timeout	Aborts a request if it takes longer than this many milliseconds.
`headers`	`Record<string, string>`	No	`{}`	Additional headers sent with every request.
`fetch`	`typeof fetch`	No	The global `fetch`	A custom `fetch` implementation, e.g. for older runtimes or for testing.

import { DhivehiGPT } from '@javaabu/dhivehigpt-sdk';

const client = new DhivehiGPT({
  apiKey: process.env.DHIVEHIGPT_API_KEY, // optional; read from the same env var automatically
  apiVersion: 'v1', // optional, this is the default
  timeoutMs: 10_000,
  headers: {
    'X-Request-Source': 'my-app',
  },
});

API key resolution

apiKey is optional. When omitted, the client reads it from the DHIVEHIGPT_API_KEY environment variable:

// DHIVEHIGPT_API_KEY=sk_... in the environment
const client = new DhivehiGPT();

An explicitly passed apiKey always takes priority over the environment variable. If neither is available, the constructor throws.

You can generate an API key from the API Keys page of your team account. You need a DhivehiGPT team account with an active subscription, and only team owners and admins can generate API keys.

Rate limits

All DhivehiGPT API routes are limited to 60 requests per minute per API key. Exceeding this limit causes the SDK to throw a RateLimitError.