civitai rest api client for js

This is a lightweight, type-safe JavaScript/TypeScript library for interacting with the Civitai REST API. It supports both web browsers and Node.js environments.

• Small Footprint: The library has a minimal dependency footprint, making it suitable for use in various project environments.
• Type Safety: Written in TypeScript, the library provides type safety and better tooling support, reducing runtime errors and improving developer experience.
• Cross-Platform: The library can be used in both web browsers (via bundlers like Webpack or Rollup) and Node.js environments.

Using npm:

npm install @stable-canvas/civitai-rest-api-client

Using yarn:

yarn add @stable-canvas/civitai-rest-api-client

import "./ensure-fetch"; // Required for NodeJS
import { CivitaiRESTAPIClient } from "@stable-canvas/civitai-rest-api-client";

const client = new CivitaiRESTAPIClient();
const models = await client.default.getModels({
    nsfw: false,
    limit: 5,
});
console.log(models);

full example in /examples folder

This library is implemented based on the Civitai REST API Reference. The following endpoints are supported:

• getCreators

• getImages

• getModels
• getModels1

• getModelVersions
• getModelVersionsByHash

• getTags

For detailed information on the parameters and response types for each endpoint, please refer to the Civitai REST API Reference.

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

This project is licensed under the MIT License.