VOIDLESS.DEVLogin

Developer Docs

Voidless API Reference

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.

Generate API KeysAccount Endpoints

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

Using an AI assistant instead?

Connect Voidless to Claude, ChatGPT, Cursor or Claude Code and ask for assets in plain words, no code needed. Set up the Voidless MCP connector →

Authentication

Authenticate with API keys

Generate a key from your profile, 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

User and log endpoints

Use these endpoints to inspect the authenticated user and fetch account activity once you have generated an API key.

GET/api/users/me

Current user

Returns 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
}
GET/api/logs/fetch

Logs

Returns 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 and editing

Image generation, editing, parts, animations, uploads, and pixelation.

POST/api/generate/image

Generate image

Creates a new image from text using the selected model and style settings.

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
}
POST/api/generate/image-edit

Edit image

Edits an existing asset or reference image using a prompt and selected edit model.

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
}
POST/api/generate/image-rotations

Generate rotations

Generates rotated views for an existing image asset.

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
}
POST/api/generate/image-animation

Generate animation

Creates an animation sequence from a reference image and prompt.

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
}
POST/api/generate/image-parts

Generate image parts

Generates variations or segmented parts from a reference 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
}
POST/api/upload/image

Upload image

Uploads a source image into the user asset library for later generation steps.

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
}
POST/api/pixelate/image

Pixelate image

Converts 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

Sound effects and music

Generate sound effects or music directly from text prompts.

POST/api/generate/sfx

Generate SFX

Creates 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
}
POST/api/generate/music

Generate music

Creates 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

Video generation

Generate videos from prompts and extend existing generated clips.

POST/api/generate/video

Generate video

Creates 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
}
POST/api/generate/video-extend

Extend video

Extends 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

3D model generation

Generate 3D-ready outputs from prompts and palette-aware settings.

POST/api/generate/3d-model

Generate 3D model

Creates 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
}