Fylzap API Reference

import os
import time
import requests

API_KEY = 'fc_live_your_enterprise_key'
BASE_URL = 'https://fylzap.com'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}


def authorize_and_upload(file_path):
    file_name = os.path.basename(file_path)
    file_size = os.path.getsize(file_path)

    auth = requests.post(
        f'{BASE_URL}/api/converter/authorize',
        headers=HEADERS,
        json={
            'fileName': file_name,
            'fileSize': file_size,
            'outputType': 'md',
            'splitMode': 'chapters',
            'useAI': file_name.lower().endswith('.pdf'),
            'useAiClean': True,
            'outputMode': 'knowledge',
        },
    ).json()

    with open(file_path, 'rb') as f:
        requests.post(
            f"{auth['uploadUrl']}/upload",
            headers={'Authorization': f"Bearer {auth['uploadToken']}"},
            files={'file': f},
        )

    return auth['jobId'], file_name


def wait_and_download(job_id, file_name, output_dir='.'):
    while True:
        status = requests.get(
            f'{BASE_URL}/api/converter/status/{job_id}', headers=HEADERS
        ).json()
        if status['status'] == 'success':
            break
        if status['status'] == 'error':
            raise Exception(f"{file_name}: {status.get('error')}")
        time.sleep(3)

    result = requests.get(
        f'{BASE_URL}/api/converter/download/{job_id}', headers=HEADERS
    )
    base_name = os.path.splitext(file_name)[0]
    out_path = os.path.join(output_dir, f'{base_name}_knowledge_pack.zip')
    with open(out_path, 'wb') as f:
        f.write(result.content)
    print(f'Saved: {out_path}')


def generate_knowledge_packs_batch(file_paths, output_dir='.'):
    jobs = [authorize_and_upload(p) for p in file_paths]
    for job_id, file_name in jobs:
        wait_and_download(job_id, file_name, output_dir)


generate_knowledge_packs_batch([
    'document1.pdf',
    'document2.pdf',
    'document3.docx',
])

const FormData = require('form-data');
const fs = require('fs');
const path = require('path');
const axios = require('axios');

const API_KEY = 'fc_live_your_enterprise_key';
const BASE_URL = 'https://fylzap.com';

async function authorizeAndUpload(filePath) {
  const fileName = path.basename(filePath);
  const fileSize = fs.statSync(filePath).size;

  const { data: auth } = await axios.post(
    `${BASE_URL}/api/converter/authorize`,
    {
      fileName, fileSize,
      outputType: 'md',
      splitMode: 'chapters',
      useAI: fileName.toLowerCase().endsWith('.pdf'),
      useAiClean: true,
      outputMode: 'knowledge',
    },
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );

  const form = new FormData();
  form.append('file', fs.createReadStream(filePath), fileName);
  await axios.post(`${auth.uploadUrl}/upload`, form, {
    headers: { ...form.getHeaders(), Authorization: `Bearer ${auth.uploadToken}` },
    maxContentLength: Infinity,
    maxBodyLength: Infinity,
  });

  return { jobId: auth.jobId, fileName };
}

async function waitAndDownload(jobId, fileName, outDir = '.') {
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/api/converter/status/${jobId}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );
    if (status.status === 'success') break;
    if (status.status === 'error') throw new Error(`${fileName}: ${status.error}`);
    await new Promise(r => setTimeout(r, 3000));
  }

  const result = await axios.get(
    `${BASE_URL}/api/converter/download/${jobId}`,
    { headers: { Authorization: `Bearer ${API_KEY}` }, responseType: 'arraybuffer' }
  );
  const baseName = path.basename(fileName, path.extname(fileName));
  const outPath = path.join(outDir, `${baseName}_knowledge_pack.zip`);
  fs.writeFileSync(outPath, result.data);
  console.log('Saved:', outPath);
}

async function generateKnowledgePacksBatch(filePaths, outDir = '.') {
  const jobs = [];
  for (const p of filePaths) jobs.push(await authorizeAndUpload(p));
  for (const { jobId, fileName } of jobs) await waitAndDownload(jobId, fileName, outDir);
}

generateKnowledgePacksBatch(['document1.pdf', 'document2.pdf', 'document3.docx']);