♿ WIA A11Y API Documentation

REST API for sign language, braille, TTS audiobook, and accessibility services. 254 languages supported. Integrate accessibility into your publishing pipeline.

Overview

The WIA A11Y API provides six core services:

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer wia_a11y_your_api_key_here

Get your API key by subscribing at /pricing. Keys start with wia_a11y_.

Page Units

Billing is based on Page Units (PU):

• 1 Page Unit = 1,000 characters (including spaces)
• Minimum charge: 1 PU per request
• Example: 200-page novel (~200,000 chars) = 200 PU
• Example: 20-page picture book (~5,000 chars) = 5 PU

Supported input formats: EPUB, PDF, DOCX, HWP/HWPX, TXT, MD, HTML, or raw text.

Rate Limits

When rate limited, you'll receive a 429 response with a retryAfter field (seconds).

POST /sign-language

Convert text to sign language gesture sequences. 254 languages supported.

{
  "success": true,
  "service": "sign-language",
  "input": {
    "format": "text",
    "page_units": 200,
    "language": "ko"
  },
  "output": {
    "sign_data_url": "https://a11y.wiabook.com/api/results/...",
    "viewer_url": "https://wiatalk.com/sign-viewer.html?data=...",
    "embed_code": "<iframe ...>",
    "total_sentences": 1870,
    "total_gestures": 10419,
    "gestures_per_sentence_avg": 5.6
  },
  "billing": {
    "page_units_charged": 200,
    "price_per_unit": 0.02,
    "total_charged": 4.00,
    "currency": "USD",
    "remaining_quota": 300
  }
}

POST /braille

Convert text to braille. UEB international standard + Korean braille + IPA phoneme mapping.

POST /tts

Convert text to audiobook (chapter-by-chapter MP3). 30+ languages via Piper TTS.

POST /a11y-check

Run WCAG 2.1 AA accessibility check on HTML content or URL.

POST /a11y-fix

Automatically fix accessibility issues in HTML content. Adds alt text, lang attributes, viewport, ARIA labels, high-contrast CSS, and semantic tags.

POST /full-package

Complete accessibility transformation: sign language + braille + TTS + check + fix + badge. Discounted vs individual services.

GET /account

View your API key account info, quota usage, and plan details.

{
  "success": true,
  "account": {
    "email": "user@example.com",
    "plan": "pro",
    "monthly_quota": 2000,
    "used_this_month": 450,
    "remaining": 1550,
    "rate_limit": "60 req/min",
    "quota_resets": "2026-04-01"
  }
}

Examples: cURL

# Sign language conversion (text)
curl -X POST https://a11y.wiabook.com/api/v1/sign-language \
  -H "Authorization: Bearer wia_a11y_YOUR_KEY" \
  -F "text=Hello world. This is a test." \
  -F "lang=en"

# Braille conversion (file upload)
curl -X POST https://a11y.wiabook.com/api/v1/braille \
  -H "Authorization: Bearer wia_a11y_YOUR_KEY" \
  -F "file=@my-book.epub" \
  -F "lang=ko"

# Full package
curl -X POST https://a11y.wiabook.com/api/v1/full-package \
  -H "Authorization: Bearer wia_a11y_YOUR_KEY" \
  -F "file=@document.pdf" \
  -F "lang=en"

# Check account
curl https://a11y.wiabook.com/api/v1/account \
  -H "Authorization: Bearer wia_a11y_YOUR_KEY"

Examples: Python

import requests

API_KEY = "wia_a11y_YOUR_KEY"
BASE = "https://a11y.wiabook.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Text input
resp = requests.post(f"{BASE}/sign-language",
    headers=headers,
    data={"text": "Hello world", "lang": "en"})
print(resp.json())

# File upload
with open("book.epub", "rb") as f:
    resp = requests.post(f"{BASE}/full-package",
        headers=headers,
        files={"file": f},
        data={"lang": "ko"})
print(resp.json())

Examples: Node.js

const API_KEY = 'wia_a11y_YOUR_KEY';
const BASE = 'https://a11y.wiabook.com/api/v1';

// Text input
const resp = await fetch(`${BASE}/braille`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ text: 'Hello world', lang: 'en' })
});
console.log(await resp.json());

// File upload
const form = new FormData();
form.append('file', fs.createReadStream('book.epub'));
form.append('lang', 'ko');

const resp2 = await fetch(`${BASE}/full-package`, {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}` },
  body: form
});
console.log(await resp2.json());

Examples: PHP

$apiKey = 'wia_a11y_YOUR_KEY';
$base = 'https://a11y.wiabook.com/api/v1';

// Text input
$ch = curl_init("$base/tts");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => ['text' => 'Hello world', 'lang' => 'en'],
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"]
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

// File upload
$ch = curl_init("$base/full-package");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('book.epub'),
        'lang' => 'ko'
    ],
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"]
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

Error Codes