Node.js & TypeScript SDK for DEVUP AI

npm install devupai

import DevupAI from "devupai";

// Initialize the client with your API key
const client = new DevupAI({
  apiKey: process.env.DEVUP_API_KEY!,
});

async function main() {
  const response = await client.chat.completions.create({
    model: "deepseek-ai/DeepSeek-V4-Pro", // Example model
    messages: [
      {
        role: "system",
        content: "You are a concise technical assistant.",
      },
      {
        role: "user",
        content: "Explain artificial intelligence in one paragraph.",
      },
    ],
  });

  console.log(response.choices[0]?.message?.content);
  console.log("Cost:", response._devup?.cost_dzd, "DZD");
  console.log("Balance:", response._devup?.balance_dzd, "DZD");
}

main().catch(console.error);

import DevupAI from "devupai";

const client = new DevupAI({
  apiKey: process.env.DEVUP_API_KEY!,
});

async function streamResponse() {
  const stream = await client.chat.completions.create({
    model: "deepseek-ai/DeepSeek-V4-Pro", // Example model
    messages: [
      {
        role: "user",
        content: "Write a short poem about Algeria.",
      },
    ],
    stream: true,
  });

  for await (const chunk of stream) {
    // Check for the final billing chunk containing settled cost and balance
    if ("_devup" in chunk) {
      console.log("\n--- Billing Summary ---");
      console.log("Cost:", chunk._devup.cost_dzd, "DZD");
      console.log("Remaining balance:", chunk._devup.balance_dzd, "DZD");
      continue;
    }

    // Process incremental text deltas
    process.stdout.write(chunk.choices?.[0]?.delta?.content ?? "");
  }
}

streamResponse().catch(console.error);

import DevupAI from "devupai";

const client = new DevupAI({
  apiKey: process.env.DEVUP_API_KEY!,
});

async function createEmbeddings() {
  const response = await client.embeddings.create({
    model: "BAAI/bge-m3", // Example embedding model
    input: ["Hello world", "مرحبا بالعالم", "Bonjour le monde"],
  });

  console.log("Embedding vector dimensions:", response.data[0]?.embedding?.length);
  console.log("Total embeddings generated:", response.data.length);
}

createEmbeddings().catch(console.error);

import DevupAI from "devupai";

// 1. Client-level options (constructor)
// Note: apiKey is passed explicitly — the core client does not auto-read process.env
const client = new DevupAI({
  apiKey: process.env.DEVUP_API_KEY!,
  baseURL: "https://api.devupai.com/v1", // Optional custom endpoint
  headers: {
    "X-Application-Name": "my-service", // Custom default headers
  },
});

// 2. Per-request options (timeout, abort signals, custom headers)
const controller = new AbortController();

const response = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Pro",
  messages: [{ role: "user", content: "Summarize Algeria in three sentences." }],
  timeout: 30_000, // Timeout after 30 seconds
  signal: controller.signal, // External cancellation signal
  headers: {
    "X-Request-Source": "worker-pool",
  },
});

import DevupAI, { DevupAPIError } from "devupai";

const client = new DevupAI({
  apiKey: process.env.DEVUP_API_KEY!,
});

async function main() {
  try {
    await client.chat.completions.create({
      model: "deepseek-ai/DeepSeek-V4-Pro",
      messages: [{ role: "user", content: "Hello DEVUP AI" }],
    });
  } catch (error) {
    if (error instanceof DevupAPIError) {
      console.error("DEVUP API request failed:");
      console.error("Status:", error.status); // HTTP status code (or 0 for network failure)
      console.error("Message:", error.message); // Human-readable error message
      console.error("Type:", error.type); // API error classification
      console.error("Code:", error.code); // Machine-readable error code
      console.error("Request ID:", error.requestId); // Unique x-request-id header for tracing
      console.error("Retry-After:", error.retryAfter); // Retry-After header value if rate-limited
      return;
    }

    throw error;
  }
}

main().catch(console.error);