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.

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, pose tools, 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-in-paint

In-paint image

Uses a prompt and mask to regenerate specific parts of an image.

Request · cURL

curl -X POST https://api.voidless.dev/api/generate/image-in-paint \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 52,
  "prompt": "Replace the sky with a sunset",
  "referenceFile": "assets/demo-user/images/scene.png",
  "mask_image": "data:image/png;base64,...",
  "palette": [],
  "frameId": ""
}'

Typical response

{
  "file": "assets/demo-user/images/scene-inpaint.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-animation-copy

Copy animation style

Copies motion or timing style from one animation source to another.

Request · cURL

curl -X POST https://api.voidless.dev/api/generate/image-animation-copy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 52,
  "prompt": "Use the same motion on this second sprite",
  "referenceFile": "assets/demo-user/images/source.gif",
  "referenceFile2": "assets/demo-user/images/target.png",
  "frameId": ""
}'

Typical response

{
  "file": "assets/demo-user/images/target-anim.gif",
  "assetId": 123,
  "credits": 1175,
  "seed": 0,
  "cost": 10
}
POST/api/generate/image-animation-edit

Edit animation

Applies prompt-driven changes to an existing animation sequence.

Request · cURL

curl -X POST https://api.voidless.dev/api/generate/image-animation-edit \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 52,
  "prompt": "Make the flames burn brighter",
  "referenceFile": "assets/demo-user/images/frame-1.png",
  "frameId": ""
}'

Typical response

{
  "file": "assets/demo-user/images/animation-edit.gif",
  "assetId": 123,
  "credits": 1175,
  "seed": 0,
  "cost": 10
}
POST/api/generate/image-pose

Generate pose image

Creates a new image using a pose reference.

Request · cURL

curl -X POST https://api.voidless.dev/api/generate/image-pose \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 52,
  "prompt": "Mage casting a spell",
  "pose_image": "data:image/png;base64,...",
  "referenceFile": "assets/demo-user/images/base-pose.png",
  "palette": []
}'

Typical response

{
  "file": "assets/demo-user/images/mage-pose.png",
  "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/generate/rpg-character

Generate RPG character

Creates an RPG-ready character asset from an uploaded reference image.

Request · cURL

curl -X POST https://api.voidless.dev/api/generate/rpg-character \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 52,
  "referenceFile": "assets/demo-user/images/base-character.png",
  "frameId": "",
  "size": 64
}'

Typical response

{
  "file": "assets/demo-user/images/rpg-ranger.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, BPM, and quality mode 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,
  "mode": "sd"
}'

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 using the chosen model, prompt, and optional source images.

Supported models visible in code include seedance, luma ray2flash, kling1.6, and vidu q1.

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 '{
  "model": "vidu q1",
  "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,
  "model": "vidu q1",
  "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.

Supported frontend modes are lq and hq.

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": "hq"
}'

Typical response

{
  "file": "assets/demo-user/models/treasure-chest.glb",
  "assetId": 123,
  "credits": 1175,
  "seed": 0,
  "cost": 10
}