aio-epub-setup

EPUB Setup — Account & License Configuration

Hướng dẫn đăng ký tài khoản, mua license, và cấu hình API key để sử dụng dịch vụ dịch EPUB.

Tổng quan

Dịch vụ EPUB Translation gồm 2 phần:

• Web app: https://read.aiocean.io — giao diện đọc và dịch sách
• API server: https://read-api.aiocean.dev — ConnectRPC API cho AI agents

Prerequisite: Đây là skill đầu tiên trong workflow. Sau khi setup xong, dùng aio-epub-upload để tải sách lên.

Bước 1: Đăng ký tài khoản

1. Truy cập https://read.aiocean.io
2. Click Sign In ở góc trên phải
3. Đăng nhập bằng tài khoản Google hoặc email
4. Sau khi đăng nhập, bạn có thể duyệt sách cộng đồng và khám phá giao diện

Guest mode: Bạn có thể khám phá toàn bộ tính năng mà chưa cần đăng nhập. Chỉ khi thực hiện hành động (dịch, upload, lưu) mới cần xác thực.

Bước 2: Mua License

License cho phép bạn:

• Upload sách EPUB lên server
• Dịch sách bằng AI (sử dụng models trên server)
• Xuất sách đã dịch (bilingual hoặc translation-only)
• Sử dụng API cho AI agents

Cách mua

1. Đăng nhập tại https://read.aiocean.io
2. Vào Settings → License
3. Chọn gói phù hợp và thanh toán
4. License key sẽ hiển thị trong Settings sau khi thanh toán

Gói license

Gói	Mô tả
Free	Đọc sách cộng đồng, xem demo
Personal	Upload sách, dịch bằng AI, xuất EPUB
Pro	Tất cả tính năng + API access cho agents

Bước 3: Cấu hình API Key

Cho AI Agent (Claude Code)

Thêm API key vào environment variable hoặc trực tiếp trong code:

# Option 1: Environment variable (khuyến nghị)
export AIO_EPUB_API_KEY="your-license-key-here"

# Option 2: Thêm vào .env file của project
echo 'AIO_EPUB_API_KEY=your-license-key-here' >> .env

Verify kết nối

import json, urllib.request, os

BASE = "https://read-api.aiocean.dev/ListBooks.v1.BookService"
KEY = os.environ.get("AIO_EPUB_API_KEY", "")

if not KEY:
    print("ERROR: AIO_EPUB_API_KEY not set")
    print("Run: export AIO_EPUB_API_KEY='your-license-key'")
    exit(1)

def api(method, body):
    data = json.dumps(body).encode('utf-8')
    req = urllib.request.Request(f"{BASE}/{method}", data=data, headers={
        "Content-Type": "application/json",
        "X-License-Key": KEY
    })
    with urllib.request.urlopen(req) as resp:
        return json.loads(resp.read())

# Test: validate license
try:
    result = api("ValidateLicense", {"licenseKey": KEY})
    if result.get("valid"):
        print("License is valid!")
        print(f"Message: {result.get('message', '')}")
    else:
        print(f"License invalid: {result.get('message', 'Unknown error')}")
except Exception as e:
    print(f"Connection failed: {e}")
    print("Check your network and API key")