API Reference

npm install @ddukddak/node

const result = await client.auth.test();
console.log(result.message); // "Authenticated"

const account = await client.account.get();
console.log(`Usage: ${account.api_usage} / ${account.api_quota} credits`);

// Returns an array directly (not wrapped in { data: [...] })
const templates = await client.templates.list({ page: 1, limit: 10 });

for (const t of templates) {
  console.log(`- ${t.id} (${t.slug}): ${t.name}`);
  console.log(`  Size: ${t.canvas_width}x${t.canvas_height}`);
}

// Async — returns immediately with status "pending"
const image = await client.images.create({
  template: "product-card",   // slug or UUID
  properties: [
    { name: "title", text: "My Awesome Product!" },
    { name: "background", image_url: "https://example.com/bg.jpg" },
    { name: "price", text: "$29.99", color: "#FF6B6B" },
  ],
  transparent: false,          // optional, default false
  webhook_url: "https://...",  // optional
});

console.log(image.uid);    // "img_abc123..."
console.log(image.status); // "pending"

// Requires Automate plan or higher
const video = await client.videos.create({
  template: "story-promo",                     // slug or UUID
  input_media_url: "https://example.com/clip.mp4",
  properties: [
    { name: "title", text: "Spring Sale 2026" },
    { name: "subtitle", text: "Up to 50% off" },
  ],
  audio_url: "https://example.com/bgm.mp3",   // optional
  webhook_url: "https://...",                  // optional
});

console.log(video.uid);    // track with this ID
console.log(video.status); // "pending"

// Requires Scale plan or higher
// Increase timeout for AI generation
const client = new Ddukddak("YOUR_API_KEY", { timeout: 120000 });

// Gemini model
const aiImage = await client.aiImages.createAndWait({
  prompt: "A minimalist product photo of a white sneaker",
  model: "gemini-2.5-flash-image",
  aspect_ratio: "1:1",
  image_size: "1K",
});
console.log(aiImage.image_url);

// Hailuo Image model (MiniMax)
const hailuoImage = await client.aiImages.createAndWait({
  prompt: "Cute bear mascot holding a camera",
  model: "image-01",
  aspect_ratio: "16:9",
  image_size: "HD",   // image-01 only supports "HD"
});
console.log(hailuoImage.image_url);

// Requires Scale plan or higher
const client = new Ddukddak("YOUR_API_KEY", { timeout: 300000 });

// MiniMax Hailuo model
const video = await client.aiVideos.createAndWait(
  {
    prompt: "A white sneaker rotating 360 degrees",
    model: "MiniMax-Hailuo-2.3",
    aspect_ratio: "16:9",    // MiniMax: "16:9" only
    resolution: "768p",      // "768p" or "1080p"
    duration: "6s",          // "6s" or "10s"
  },
  5000, 600000,
);
console.log(video.video_url);

// Google Veo 3.1 Fast model
const veoVideo = await client.aiVideos.createAndWait(
  {
    prompt: "Barista making latte art, close-up",
    model: "veo-3.1-fast-generate-preview",
    aspect_ratio: "9:16",    // Veo supports "9:16"
    resolution: "1080p",     // "720p" or "1080p"
    duration: "6s",          // "4s", "6s", "8s"
  },
  5000, 600000,
);
console.log(veoVideo.video_url);

const {
  Ddukddak,
  AuthenticationError,
  ValidationError,
  QuotaExceededError,
  PlanRestrictedError,
  RateLimitError,
  NotFoundError,
  DdukddakError,
} = require("@ddukddak/node");

try {
  const image = await client.images.create({ template: "..." });
} catch (error) {
  if (error instanceof AuthenticationError)
    console.log("Invalid API key");
  else if (error instanceof QuotaExceededError)
    console.log("Monthly credit limit reached");
  else if (error instanceof PlanRestrictedError)
    console.log("Feature not available on your plan");
  else if (error instanceof RateLimitError)
    console.log("Too many requests, retry later");
  else if (error instanceof NotFoundError)
    console.log("Template not found");
  else if (error instanceof ValidationError)
    console.log("Invalid parameters:", error.message);
  else if (error instanceof DdukddakError)
    console.log("Error:", error.message);
}