Skip to main content
Install the published client from npm: 
npm install zerogpu-api

import { ZerogpuApiClient } from 'zerogpu-api';

const client = new ZerogpuApiClient({
  apiKey: process.env.ZEROGPU_API_KEY,
  projectId: process.env.ZEROGPU_PROJECT_ID,
});

// Many models accept plain string `input`; others accept a message list: see API reference.
const response = await client.responses.createResponse({
  model: process.env.ZEROGPU_MODEL ?? 'YOUR_MODEL',
  input: 'Your input text here...',
  text: { format: { type: 'text' } },
});

console.log(response.output);
Source and regeneration workflow: zerogpu/SDK on GitHub.

​
Chat completions (/v1/chat/completions)

For models that use the chat route, call client.chat.createChatCompletion({ model, messages, metadata? }). See Chat completions.

​
Responses with metadata

Optional metadata on createResponse is supported for model-specific options (e.g. PII). See Responses.

​
Raw HTTP (fetch)

If you prefer not to use the SDK, call the endpoint directly. 
const url = 'https://api.zerogpu.ai/v1/responses';
const headers = {
  'content-type': 'application/json',
  'x-api-key': 'YOUR_API_KEY',
  'x-project-id': 'YOUR_PROJECT_ID'
};
const payload = {
  model: 'YOUR_MODEL',
  input: [
    {
      role: 'user',
      content: 'Your input text here...'
    }
  ],
  text: {
    format: {
      type: 'text'
    }
  }
};

fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

​
Using environment variables (Node.js)

const url = 'https://api.zerogpu.ai/v1/responses';
const headers = {
  'content-type': 'application/json',
  'x-api-key': process.env.ZEROGPU_API_KEY,
  'x-project-id': process.env.ZEROGPU_PROJECT_ID
};
const payload = {
  model: 'YOUR_MODEL',
  input: [
    {
      role: 'user',
      content: 'Your input text here...'
    }
  ],
  text: {
    format: {
      type: 'text'
    }
  }
};

const response = await fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify(payload)
});

const data = await response.json();
console.log(data.output[0].content[0].text);

​
Error handling

try {
  const response = await fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(payload)
  });

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
  }

  const data = await response.json();
  console.log(data.output[0].content[0].text);
} catch (error) {
  console.error('Request failed:', error.message);
}