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.

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, 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

Authenticate with API keys

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

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

Edit image

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

Generate rotations

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

Generate animation

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

Generate image parts

Generates 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
}
POST/api/assets/resolve-image

Resolve an image

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

Upload image

Uploads 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
}
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
}
POST/api/upload/model

Upload 3D model

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