Using cURL
curl -X GET https://api.voidless.dev/api/users/me \
-H "x-api-key: YOUR_API_KEY"Developer Docs
Generate images, audio, video, and 3D models with the same authenticated API surface used by the web app. Authenticate requests with a user-generated x-api-key from your profile page.
Base URL
https://api.voidless.dev Create API keys from your profile page, then pass them in the x-api-key header on any authenticated content API route.
MCP
Connect Voidless to Claude, ChatGPT, Cursor, Claude Code or Codex and ask for assets in plain words, no code needed. The hosted connector works on any account, free included. Set up the Voidless MCP connector →
Authentication
API keys come with Voidless+. Generate a key from your account page, then send it in the x-api-key header on authenticated API requests.
Using cURL
curl -X GET https://api.voidless.dev/api/users/me \
-H "x-api-key: YOUR_API_KEY"Account
Use these endpoints to inspect the authenticated user and fetch account activity once you have generated an API key.
/api/users/meReturns the authenticated user profile, credits, tier, and storage usage.
Authenticate this route with the x-api-key header.
Request · cURL
curl -X GET https://api.voidless.dev/api/users/me \
-H "x-api-key: YOUR_API_KEY"Typical response
{
"id": 24,
"username": "demo-user",
"email": "[email protected]",
"credits": 1200,
"tier": "plus",
"storage_used": 840.91,
"has_access": true
}/api/logs/fetchReturns the authenticated user logs with sorting, filtering, and pagination support.
Request · cURL
curl -X GET https://api.voidless.dev/api/logs/fetch?sort=createdAt:desc&pagination[pageSize]=10&pagination[page]=1&filters[name][$notContains]=Purchase \
-H "x-api-key: YOUR_API_KEY"Typical response
{
"data": [
{
"id": 460,
"attributes": {
"name": "Signed Up",
"status": "Green",
"createdAt": "2026-04-18T11:17:56.491Z"
}
}
],
"meta": {
"pagination": {
"page": 1,
"pageSize": 10,
"pageCount": 3,
"total": 54
}
}
}Image
Image generation, editing, parts, animations, uploads, and pixelation.
/api/generate/imageCreates a new image from text using the selected model and style settings. Every image uses one of the style presets: style if set (or its nearest preset), else one the prompt names, else pixel art below 512 and cartoon above. The response's style and styleSource say which.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/image \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux2-klein",
"prompt": "Small potion bottle, pixel art, transparent background",
"colours": 8,
"dimension": "2d",
"size": 64,
"type": "object",
"seed": 0,
"palette": [],
"referenceImage": "",
"styleImage": ""
}'Typical response
{
"file": "assets/demo-user/images/potion.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/image-editEdits an existing asset or reference image using a prompt and selected edit model.
referenceFile takes an image key from any of your assets, or its cdn.voidless.dev URL. Empty = the asset's own base image.
images (up to 4 extra references) take the same: image keys from any of your assets, or their cdn.voidless.dev URLs. Other links are refused with a 400.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/image-edit \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": 52,
"images": [],
"prompt": "Turn the armor blue and add gold trim",
"referenceFile": "assets/demo-user/images/character.png",
"frameId": "",
"model": "e1",
"remove_bg": false
}'Typical response
{
"file": "assets/demo-user/images/character-edit.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/image-rotationsGenerates rotated views for an existing image asset.
referenceFile takes an image key from any of your assets, or its cdn.voidless.dev URL. Empty = the asset's own base image.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/image-rotations \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": 52,
"mode": "basic",
"referenceFile": "assets/demo-user/images/crate.png",
"frameId": ""
}'Typical response
{
"file": "assets/demo-user/images/crate-rotations.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/image-animationCreates an animation sequence from a reference image and prompt.
referenceFile takes an image key from any of your assets, or its cdn.voidless.dev URL. Empty = the asset's own base image.
end_frame: the image the clip ends on, an image key from any of your assets or its cdn.voidless.dev URL (the start image loops it). Empty = free ending.
An end image of another size is scaled to the start image's, and the response carries a note saying so. One whose shape differs from the start image's by more than 1.25x is refused with a 400.
An image that isn't on one of your assets is refused (404), an external URL or a GIF with a 400, before anything is charged.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/image-animation \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": 52,
"prompt": "Idle breathing animation",
"mode": "f",
"referenceFile": "assets/demo-user/images/character.png",
"end_frame": "",
"frameId": ""
}'Typical response
{
"file": "assets/demo-user/images/character-anim.gif",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/image-partsGenerates variations or segmented parts from a reference image.
referenceFile takes an image key from any of your assets, or its cdn.voidless.dev URL. Empty = the asset's own base image.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/image-parts \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": 52,
"prompt": "Create matching helmet, chest, and boots",
"referenceFile": "assets/demo-user/images/armor.png"
}'Typical response
{
"file": "assets/demo-user/images/armor-parts.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/assets/resolve-imageChecks that an image key or its cdn.voidless.dev URL is on one of your assets, and returns where.
Free. The same rule every route above applies to referenceFile, end_frame and images.
4xx answers { error }: 404 when none of your assets has the image, 400 for an external URL, image data or a GIF. width and height are null when the file's size can't be read.
Request · cURL
curl -X POST https://api.voidless.dev/api/assets/resolve-image \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "https://cdn.voidless.dev/assets/demo-user/images/character.png"
}'Typical response
{
"key": "assets/demo-user/images/character.png",
"url": "https://cdn.voidless.dev/assets/demo-user/images/character.png",
"assetId": 52,
"width": 64,
"height": 64
}/api/upload/imageUploads a source image into the user asset library for later generation steps. A picture that is not a square of 32-384, 512, 768 or 1024 px is centred on the smallest that holds it, with transparent padding (scaled down to 1024 if larger).
Request · cURL
curl -X POST https://api.voidless.dev/api/upload/image \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/png;base64,...",
"type": "image"
}'Typical response
{
"file": "assets/demo-user/images/upload.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/pixelate/imageConverts an uploaded image into a pixel-art styled output.
Request · cURL
curl -X POST https://api.voidless.dev/api/pixelate/image \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/png;base64,...",
"size": 64,
"colours": 8
}'Typical response
{
"file": "assets/demo-user/images/pixelated.png",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}Audio
Generate sound effects or music directly from text prompts.
/api/generate/sfxCreates a short sound effect from a prompt.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/sfx \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Arcade coin pickup, bright and short"
}'Typical response
{
"file": "assets/demo-user/audio/coin-pickup.wav",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/musicCreates a music track from a prompt with duration, key, and BPM options.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/music \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Retro JRPG town theme with light percussion",
"duration": 60,
"keyScale": "C major",
"bpm": 100
}'Typical response
{
"file": "assets/demo-user/audio/town-theme.mp3",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}Video
Generate videos from prompts and extend existing generated clips.
/api/generate/videoCreates a video from a prompt and optional source images.
Voidless picks the video model for you; there is nothing to choose.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/video \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A spaceship drifting past a neon planet",
"images": [
"assets/demo-user/images/start-frame.png"
]
}'Typical response
{
"file": "assets/demo-user/video/spaceship.mp4",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/generate/video-extendExtends a previously generated video asset.
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/video-extend \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assetId": 401,
"prompt": "Continue the camera push-in toward the city",
"video": "assets/demo-user/video/spaceship.mp4"
}'Typical response
{
"file": "assets/demo-user/video/spaceship-extended.mp4",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}Models
Generate 3D-ready outputs from prompts and palette-aware settings.
/api/generate/3d-modelCreates a 3D model asset from a prompt, seed, and generation mode.
Modes: game (game-ready, light mesh) and lq (draft).
Request · cURL
curl -X POST https://api.voidless.dev/api/generate/3d-model \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Low poly treasure chest with metal straps",
"seed": 0,
"mode": "game"
}'Typical response
{
"file": "assets/demo-user/models/treasure-chest.glb",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}/api/upload/modelAdds a GLB made elsewhere to the library as a 3D model, ready for rigging, animation and sprite renders like a generated one. Free.
Send url (a public http(s) link) or glb (the file, base64), not both. A binary glTF 2.0 with everything embedded, 40 MB at most.
thumbnail (a square PNG of the front, base64, 64-1024 px) is optional: without it the front view is drawn for you.
Draco and meshopt compressed files are refused: export them again without mesh compression.
Request · cURL
curl -X POST https://api.voidless.dev/api/upload/model \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/knight.glb",
"name": "Knight"
}'Typical response
{
"file": "assets/demo-user/models/knight.glb",
"assetId": 123,
"credits": 1175,
"seed": 0,
"cost": 10
}