Logo FileConvertFree
✨ Попробуйте также эти новые AI-инструменты
• PDF to Word → | Image to Text →
Платформа FileConvertFree для разработчиков

Встройте конвертацию файлов в своё приложение

REST API FileConvertFree позволяет конвертировать PDF и изображения из вашего приложения, серверной системы, автоматизации, корпоративного процесса или офисного ПО.

API v1: Документация доступна всем. Для выполнения API-запросов нужен активный тариф Premium или Pro.
Открыть панель Тарифы Интерактивная документация API
Базовый URL
REST API v1
https://fileconvertfree.com/api1
Авторизация
X-API-Key header
X-API-Key: fcf_live_••••••••

Быстрый старт

Войдите в свою учётную запись FileConvertFree.
Убедитесь, что у вас активен тариф Premium или Pro.
Откройте Панель → API для разработчиков → Создать API-ключ. Сразу сохраните полный ключ: он показывается только один раз.
Передавайте ключ в заголовке X-API-Key в каждом защищённом API-запросе.

Тарифы и лимиты API

Лимиты общие для всей API-учётной записи и всех её ключей. Дополнительные ключи не увеличивают квоту.

Premium

200 / day
  • 200 Запросов в день
  • 30 Запросов в минуту
  • 200 MB Максимальный файл
  • 3 Активных ключей max

Pro

400 / day
  • 400 Запросов в день
  • 60 Запросов в минуту
  • 200 MB Максимальный файл
  • 3 Активных ключей max

Управление API-ключами

1. Создание ключа

В разделе API для разработчиков в Панели можно создать до 3 одновременно активных ключей. Давайте им понятные имена: Production, Office App, Staging и т. п.

2. Сохраните ключ сразу

Полный секрет показывается только после создания или перегенерации. FileConvertFree хранит защищённый хэш, а не открытый секрет, поэтому позже полный ключ показать нельзя.

3. Перегенерация ключа

При перегенерации создаётся новый секрет, а старый ключ немедленно отзывается. Обновите ключ в приложении и сохраните новый секрет до закрытия окна.

4. Отзыв ключа

Отзовите ключ, если он больше не нужен или мог попасть к посторонним. Он сразу перестаёт проходить авторизацию. Запись отозванного ключа автоматически удаляется через 7 дней.

Правила безопасности

Никому не передавайте API-ключ, не публикуйте его на GitHub, не вставляйте в JavaScript на стороне браузера, не отправляйте на скриншотах и не храните в публичном коде. Используйте переменные окружения сервера или менеджер секретов. При подозрении на утечку сразу перегенерируйте или отзовите ключ.

Доступные методы API

МетодEndpointНазначение / параметры
GET/v1/account/usageПроверка тарифа, статуса ключа, дневного расхода, остатка квоты и текущего лимита запросов.
GET/healthПубличная проверка состояния API и версии.
POST/v1/pdf/to-wordКонвертация корректного PDF в Word.
POST/v1/pdf/to-excelКонвертация корректного PDF в Excel.
POST/v1/image/to-textOCR: извлечение текста из изображения. Необязательное поле multipart: fast=true|false.
POST/v1/image/to-wordКонвертация изображения в Word. Необязательное поле multipart: fast=true|false.
POST/v1/image/to-excelКонвертация изображения в Excel. Необязательное поле multipart: fast=true|false.
POST/v1/image/remove-backgroundУдаление фона изображения. Необязательные поля: format (по умолчанию png), transparent=true|false, fast_mode=true|false.

Примеры кода

import os import requests API_KEY = os.environ["FCF_API_KEY"] url = "https://fileconvertfree.com/api1/v1/pdf/to-word" with open("sample.pdf", "rb") as source: response = requests.post( url, headers={"X-API-Key": API_KEY}, files={"file": ("sample.pdf", source, "application/pdf")}, timeout=700, ) response.raise_for_status() with open("converted.docx", "wb") as out: out.write(response.content)
import { readFile, writeFile } from "node:fs/promises"; const key = process.env.FCF_API_KEY; const bytes = await readFile("scan.png"); const form = new FormData(); form.append("file", new Blob([bytes], { type: "image/png" }), "scan.png"); form.append("fast", "false"); const response = await fetch( "https://fileconvertfree.com/api1/v1/image/to-text", { method: "POST", headers: { "X-API-Key": key }, body: form } ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); console.log(await response.json());
Используйте JavaScript-пример на сервере/в Node.js. Никогда не раскрывайте секретный API-ключ во frontend-коде браузера.
curl -X POST "https://fileconvertfree.com/api1/v1/pdf/to-excel" \ -H "X-API-Key: $FCF_API_KEY" \ -F "file=@sample.pdf" \ --output converted.xlsx
<?php $apiKey = getenv('FCF_API_KEY'); $ch = curl_init('https://fileconvertfree.com/api1/v1/image/to-word'); $file = new CURLFile(__DIR__ . '/scan.png', 'image/png', 'scan.png'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey], CURLOPT_POSTFIELDS => ['file' => $file, 'fast' => 'false'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 700, ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($body === false || $status >= 400) { throw new RuntimeException('API request failed: HTTP ' . $status); } file_put_contents(__DIR__ . '/converted.docx', $body); curl_close($ch);

Поддерживаемые файлы и проверка

PDF-методы принимают настоящие PDF-файлы. Методы для изображений принимают JPEG/JPG/JFIF, PNG, WebP, GIF, BMP и TIFF/TIF. API проверяет и расширение, и сигнатуру файла — простое переименование неподдерживаемого файла не обойдёт проверку.

Как возвращается результат

Методы конвертации возвращают готовый файл непосредственно клиенту. Image-to-text возвращает JSON. Внутренние ссылки конвертеров на скачивание внешним API-клиентам не раскрываются.

HTTP-ошибки и их значение

СтатусЧто означаетПричина / что делать
401Ключ отсутствует, неверен, истёк или отозван.Проверьте X-API-Key. После отзыва/перегенерации замените ключ на текущий.
403Доступ к API не разрешён.У аккаунта нет активного тарифа Premium или Pro.
409Операция с ключом конфликтует с его состоянием.Например: уже есть 3 активных ключа или выполняется перегенерация неактивного ключа.
413Файл слишком большой.Загрузите файл в пределах лимита API-тарифа (сейчас 200 МБ).
415Неподдерживаемый или неверный тип файла.Используйте поддерживаемый PDF/формат изображения и правильное расширение; API также проверяет сигнатуру.
422Некорректное содержимое запроса.Файл может быть пустым либо обязательные multipart-данные отсутствуют/некорректны.
429Слишком много запросов.Достигнут минутный лимит или общая дневная квота аккаунта. Повторите позже или дождитесь дневного сброса.
5xxВременный сбой API или сервиса конвертации.Повторите запрос с задержкой. Серверные/инфраструктурные ошибки не списываются из дневной квоты.

Как считается квота

Дневная квота и минутный лимит общие для всех ключей одного API-аккаунта. Неверные/неподдерживаемые загрузки, отклонённые до запуска конвертации, дневную квоту не расходуют. Серверные и инфраструктурные сбои возвращают зарезервированную дневную квоту. Запрос, принятый в конвертацию, может быть учтён, даже если внутренний конвертер позже вернул клиентскую ошибку 4xx. Дневная квота сбрасывается по календарному дню сервера/БД API.

Usage check: GET https://fileconvertfree.com/api1/v1/account/usage

Частые вопросы

Можно ли использовать API на Free?

Нет. Документация доступна всем, но для вызовов API сейчас нужен активный Premium или Pro.

Три ключа дают тройную квоту?

Нет. Все ключи используют общие дневные и минутные лимиты аккаунта.

Можно восстановить потерянный секрет?

Нет. Открытый ключ не хранится. Перегенерируйте ключ и сохраните новый секрет.

Что произойдёт после окончания платного тарифа?

Доступ к API отключается, если на основном сайте больше нет активного подходящего тарифа. Продлите Premium или Pro.

Готовы подключить FileConvertFree?

Создайте ключ в Панели, проверьте его через usage endpoint и подключите нужный метод конвертации.

Открыть панельИнтерактивная документация API