Zuki Image API

Authorization: Bearer zk-your-api-key

[
  { "taskType": "authentication", "apiKey": "zk-your-api-key" },
  { "taskType": "imageInference", "model": "zuki-image-1.0", "positivePrompt": "…" }
]

{
  "data": [
    {
      "taskType": "imageInference",
      "taskUUID": "39d7207a-343e-4198-9c40-ef6d302cadb3",
      "imageUUID": "84a325ac-3fab-42ac-a303-93b50a6de979",
      "imageURL": "https://zuki.pw/v1/images/84a325ac-3fab-42ac-a303-93b50a6de979.jpg",
      "cost": 0.0431
    }
  ]
}

{
  "errors": [
    {
      "code": "insufficientCredits",
      "message": "Insufficient balance to run this task. Top up your balance and try again.",
      "taskType": "imageInference",
      "taskUUID": "39d7207a-343e-4198-9c40-ef6d302cadb3",
      "documentation": "https://zuki.pw/docs#errors"
    }
  ]
}

{ "data": [{ "taskType": "imageInference", "taskUUID": "…", "status": "processing" }] }

[{ "taskType": "getResponse", "taskUUID": "a770f077-f413-47de-9dac-be0b26a35da6" }]

{
  "data": [
    {
      "taskType": "imageInference",
      "taskUUID": "a770f077-f413-47de-9dac-be0b26a35da6",
      "status": "success",
      "imageUUID": "b7db282d-2943-4f12-992f-77df3ad3ec71",
      "imageURL": "https://zuki.pw/v1/images/b7db282d-2943-4f12-992f-77df3ad3ec71.jpg"
    }
  ]
}

const API = 'https://zuki.pw/v1';
const headers = { Authorization: `Bearer ${process.env.ZUKI_API_KEY}`, 'Content-Type': 'application/json' };
const call = async (tasks) => (await fetch(API, { method: 'POST', headers, body: JSON.stringify(tasks) })).json();

// 1. Submit
const taskUUID = crypto.randomUUID();
await call([{
  taskType: 'imageInference',
  taskUUID,
  model: 'zuki-image-1.0-max',
  positivePrompt: 'Isometric cutaway of a small underground bakery, highly detailed',
  deliveryMethod: 'async',
}]);

// 2. Poll with backoff
for (let delay = 2000; ; delay = Math.min(delay * 1.5, 10000)) {
  await new Promise((r) => setTimeout(r, delay));
  const res = await call([{ taskType: 'getResponse', taskUUID }]);
  if (res.errors?.length) throw new Error(res.errors[0].message);
  const done = res.data.filter((d) => d.status === 'success');
  if (done.length) { console.log(done.map((d) => d.imageURL)); break; }
}

{
  "taskType": "imageInference",
  "taskUUID": "a770f077-f413-47de-9dac-be0b26a35da6",
  "status": "success",
  "imageUUID": "550e8400-e29b-41d4-a716-446655440000",
  "imageURL": "https://zuki.pw/v1/images/550e8400-e29b-41d4-a716-446655440000.jpg"
}

{ "errors": [{ "code": "contentModerated", "message": "…", "taskType": "imageInference", "taskUUID": "…", "status": "error" }] }

import express from 'express';

const app = express();
app.use(express.json({ limit: '50mb' }));
const processed = new Set();

app.post('/hooks/zuki', (req, res) => {
  if (req.query.token !== process.env.WEBHOOK_TOKEN) return res.sendStatus(401);
  res.sendStatus(200); // respond fast, process asynchronously

  const body = req.body;
  if (body.errors) return console.error('Generation failed', body.errors[0]);
  if (processed.has(body.imageUUID)) return; // deliveries can repeat
  processed.add(body.imageUUID);
  console.log('Image ready', body.taskUUID, body.imageURL);
});

app.listen(3000);

[{
  "taskType": "imageInference",
  "model": "zuki-image-1.0",
  "positivePrompt": "Turn this photo into a watercolor painting",
  "inputs": { "referenceImages": ["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."] }
}]

{
  "data": [
    {
      "taskType": "imageUpload",
      "imageUUID": "6f1c2a9e-4b7d-4e8a-9c21-3d5f0b8e7a14",
      "format": "JPG",
      "width": 1280,
      "height": 960,
      "size": 348211,
      "expiresAt": "2026-09-30T18:04:11.000Z"
    }
  ]
}

[{
  "taskType": "imageInference",
  "model": "zuki-image-1.0",
  "positivePrompt": "Same person in a spacesuit on the Moon",
  "inputs": { "referenceImages": ["6f1c2a9e-4b7d-4e8a-9c21-3d5f0b8e7a14"] }
}]

{ "uploadEndpoint": "https://your-bucket.s3.amazonaws.com/out/teapot.jpg?X-Amz-Signature=…" }

{
  "data": [
    {
      "taskType": "accountManagement",
      "operation": "getDetails",
      "name": "production",
      "balance": { "amount": 41.27, "currency": "USD" },
      "models": ["zuki-image-1.0", "zuki-image-1.0-max"],
      "rateLimits": { "tasksPerMinute": 60, "concurrentTasks": 4 },
      "usage": {
        "today": { "credits": 1.84, "requests": 42 },
        "last7Days": { "credits": 12.3, "requests": 301 },
        "last30Days": { "credits": 58.73, "requests": 1420 },
        "total": { "credits": 58.73, "requests": 1420 }
      }
    }
  ]
}

async function callWithRetry(tasks, maxRetries = 4) {
  for (let i = 0; ; i++) {
    const res = await fetch('https://zuki.pw/v1', {
      method: 'POST',
      headers: { Authorization: `Bearer ${process.env.ZUKI_API_KEY}`, 'Content-Type': 'application/json' },
      body: JSON.stringify(tasks),
    });
    const retryable = res.status === 429 || res.status >= 500;
    if (!retryable || i >= maxRetries) return res.json();
    await new Promise((r) => setTimeout(r, 1000 * 2 ** i + Math.random() * 250)); // 1s, 2s, 4s, 8s
  }
}

[
  {
    "taskType": "imageInference",
    "model": "zuki-image-1.0",
    "positivePrompt": "Put the jacket from image 1 on a model walking down the street from image 2, editorial photo",
    "width": 1024,
    "height": 1536,
    "inputs": {
      "referenceImages": [
        "https://example.com/jacket.jpg",
        "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      ]
    }
  }
]

[
  {
    "taskType": "imageInference",
    "model": "zuki-image-1.0-max",
    "positivePrompt": "Replace the sky with a dramatic sunset, keep the building untouched",
    "inputs": {
      "referenceImages": ["https://example.com/photo.jpg"],
      "maskImage": "https://example.com/sky-mask.png"
    },
    "settings": { "quality": "high" }
  }
]

[
  {
    "taskType": "imageInference",
    "model": "zuki-image-1.0",
    "positivePrompt": "A cartoon fox sticker with a thick white outline",
    "width": 1024,
    "height": 1024,
    "settings": { "background": "transparent" },
    "outputFormat": "PNG"
  }
]

[
  {
    "taskType": "imageInference",
    "model": "zuki-image-1.0",
    "positivePrompt": "Flat vector logo of a paper crane",
    "numberResults": 4,
    "outputFormat": "WEBP",
    "outputQuality": 90
  }
]

[
  {
    "taskType": "imageInference",
    "model": "zuki-image-1.0",
    "positivePrompt": "Same scene at night with neon signs",
    "inputs": { "referenceImages": ["84a325ac-3fab-42ac-a303-93b50a6de979"] }
  }
]