This package allows you to communicate with the AI Horde API
DISCLAIMER: THIS PACKAGE/REPOSITORY IS IN NO WAY ASSOCIATED TO THE CREATORS OF AI HORDE
Version 5.0.0 introduces some breaking changes:
- Node 18.0.0 or higher is required
- The way some things are exported is changed
It also features an internal restructure to reduce complexity and improve performance.
To report bugs please open an issue on GitHub.
- Configurable Caching
- Methods for all endpoints on the API V2
- Default Token
- Types with comments and explanations (TS)
- Ratelimit bucket
I am always happy about contributions. You can contribute by forking this repository, updating or adding and then creating a pull request. You can contribute by adding new features, optimizing the currently existing code, adding examples or anything else I missed.
The package exports the class AIHorde
which includes basically everything you need, when using typescript you can also export types.
The package also exports constant values used in the hordes API request payloads
const { AIHorde } = require("@zeldafan0225/ai_horde");
/*
Create new instance of the ai_horde class to communicate with the rest API
You can configure which cache should contain the data for what time
You can also configure at what interval the cache is checking if there are any data that should be deleted
The class also takes a default token. This is helpful if you want to use this package only using your own token.
The token is not a required argument in any method.
A default API route is also in the contrictor for changing where the requests are directed to (e.g. when using a subdomain like https://test.aihorde.net)
*/
const ai_horde = new AIHorde({
cache_interval: 1000 * 10,
cache: {
generations_check: 1000 * 30,
},
client_agent: "My-Project:v0.0.1:My-Contact"
});
// start the generation of an image with the given payload
const generation = await ai_horde.postAsyncImageGenerate({
prompt: "The legend of Zelda",
});
console.log(generation);
// check the status of your generation using the generations id
const check = await ai_horde.getImageGenerationCheck(generation.id);
console.log(check);
See the auto-generated docs for more info on methods and parameters.