像素迷宫 API

// config.php
'api' => [
    'require_key' => true,
    // ...
],

php bin/apikey.php create "我的应用"
# ✓ 已创建 Key：nlk_xxxxxxxxxxxxxxxxxxxxxxxx
#   只显示这一次，请立刻保存

X-API-Key: nlk_xxxxxxxxxxxxxxxxxxxxxxxx
Authorization: Bearer nlk_xxxxxxxxxxxxxxxxxxxxxxxx

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1730000000

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1730000000
Content-Type: application/json

{
  "ok": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "请求过于频繁，已触发限流喵~",
    "field": null
  },
  "request_id": "req_6f3c9a2b1d4e"
}

{
  "ok": true,
  "data": {
    "mode": "obfuscate",
    "mime": "image/png",
    "filename": "neko-1500x1200-obfuscated.png",
    "image_base64": "iVBORw0KGgo...",
    "data_url": "data:image/png;base64,iVBORw0KGgo...",
    "width": 1500,
    "height": 1200,
    "offset": 1234567,
    "offset_mode": "golden",
    "restore_code": "NL1-1500x1200-ZK8X-4F",
    "watermark": { "applied": true, "type": "text", "layer": "pre" },
    "resource_count": 0,
    "bytes": 987654,
    "elapsed_ms": 812,
    "warnings": []
  },
  "request_id": "req_6f3c9a2b1d4e"
}

{
  "ok": false,
  "error": {
    "code": "INVALID_OFFSET",
    "message": "偏移量必须在 0 到 1799999 之间喵~",
    "field": "offset"
  },
  "request_id": "req_6f3c9a2b1d4e"
}

$offset = (int) round((sqrt(5) - 1) / 2 * $width * $height);

# 1. 混淆：默认返回 PNG 二进制，还原码在响应头里
curl -X POST "https://maze.shizuku.plus/api/v1/obfuscate" \
  -F "image=@cat.png" \
  -F "offset_mode=golden" \
  -D headers.txt \
  -o cat-obfuscated.png

# 2. 取出还原码（X-Neko-Restore-Code: NL1-1500x1200-ZK8X-4F）
grep -i '^x-neko-restore-code' headers.txt

# 3. 还原
curl -X POST "https://maze.shizuku.plus/api/v1/deobfuscate" \
  -F "image=@cat-obfuscated.png" \
  -F "restore_code=NL1-1500x1200-ZK8X-4F" \
  -o cat-restored.png

$ch = curl_init('https://maze.shizuku.plus/api/v1/obfuscate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: nlk_xxx'],
    CURLOPT_POSTFIELDS => [
        'image' => new CURLFile('/path/cat.png', 'image/png', 'cat.png'),
        'offset_mode' => 'golden',
        'watermark' => '1',
        'wm_text' => '猫羽雫 nya~',
        'wm_layer' => 'pre',
    ],
]);
$png = curl_exec($ch);
file_put_contents('/path/cat-out.png', $png);
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), "\n";

const fd = new FormData();
fd.append('image', fileInput.files[0]);
fd.append('offset_mode', 'golden');
fd.append('watermark', '1');
fd.append('wm_text', '猫羽雫 nya~');

const res = await fetch('https://maze.shizuku.plus/api/v1/obfuscate?format=json', {
  method: 'POST',
  headers: { 'X-API-Key': 'nlk_xxx' },
  body: fd,
});
const json = await res.json();
if (!json.ok) throw new Error(json.error.message);
const img = document.querySelector('img');
img.src = json.data.data_url;
console.log('还原码：', json.data.restore_code);

import requests

with open('cat.png', 'rb') as f:
    r = requests.post(
        'https://maze.shizuku.plus/api/v1/obfuscate',
        headers={'X-API-Key': 'nlk_xxx'},
        files={'image': ('cat.png', f, 'image/png')},
        data={'offset_mode': 'golden', 'watermark': '1', 'wm_text': '猫羽雫 nya~'},
        timeout=120,
    )
r.raise_for_status()
open('cat-out.png', 'wb').write(r.content)
print(r.headers['X-Neko-Restore-Code'])

# 1. 要求 PHP >= 8.1，扩展：gd、fileinfo、mbstring、zlib
php -v
php -m | grep -E 'gd|fileinfo|mbstring'

# 2. 目录权限
chmod -R 755 .
chmod -R 775 storage

# 3. 自检
php bin/doctor.php

# 4. 本地试跑
php -S 127.0.0.1:8080 -t .

POST https://maze.shizuku.plus/mcp.php

{
  "mcpServers": {
    "neko-labyrinth": {
      "command": "python",
      "args": ["/path/to/neko-labyrinth/mcp/server.py"],
      "env": {
        "NEKO_API_BASE": "https://maze.shizuku.plus/api/v1"
      }
    }
  }
}