free-diffusion

Reverse engineering API of stablediffusion3.net

Examples

Installation

npm install free-diffusion

Usage

Get Unique ID

import { refreshUniqueId } from "free-diffusion";

const uniqueId = await refreshUniqueId();

Generate Image

import { freeDiffusion } from "free-diffusion";

const image = await freeDiffusion({
  prompt: "A cute bikini girl with a stylish body is standing on the beach",
  negativePrompt: "no face, extra limbs, low quality",
  model: "tamarin",
  size: "4:3",
  batchSize: 1,
  uniqueId: "<unique-id>",
  recordUuid: "<record-uuid>",
});

Check Generation Status

import { checkStatus } from "free-diffusion";

const status = await checkStatus("<record-uuid>", "<unique-id>");

types:

export interface FreeDiffusionRequest {
  prompt: string;
  negativePrompt?: string;
  model?: "flux" | "tamarin" | "superAnime" | "visiCanvas";
  size?: "1:1" | "3:4" | "4:3";
  uniqueId: string; // required
  batchSize?: number; // number of picture
}

Succeeded generating status:

{
  "id": 2167739,
  "picPrompt": "A cute bikini girl with a stylish body is standing on the beach",
  "picPromptExecuted": "A cute bikini girl with a stylish body is standing on the beach",
  "picParam": "{\"batchSize\":1,\"model\":\"tamarin\",\"negativePrompt\":\"no face, extra limbs, low quality\",\"prompt\":\"A cute bikini girl with a stylish body is standing on the beach\",\"size\":\"4:3\"}",
  "picUrl": "[{\"deleteFlag\":0,\"picUrl\":\"https://file.aiquickdraw.com/s/1769929755_80e4195103d740a3bac4109d3fb8aefb.png\"}]",
  "generateTime": "1769929706",
  "generateCompleteTime": "2026-02-01 15:09:18",
  "createDate": "2026-02-01 15:08:20",
  "createTimeSeconds": 1769929700,
  "picState": "success",
  "expireFlag": 0,
  "batchSize": 1,
  "changeBatchSize": 0,
  "type": "sd",
  "upscaleIndex": "",
  "upscaleFlag": 0,
  "failCode": ""
}

Test

Using Vitest.

pnpm run test test/index.test.ts:<line_number>

License

MIT License © 2026-PRESENT Vincent-the-gamer