# Документация

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

## Как это работает

1. Приложите файл или опишите задачу словами в строке запроса.
2. Проверьте распознанные данные в таблице — спорные значения подсвечены.
3. Выгрузите результат в нужном формате или влейте его в свой шаблон.

## Какие файлы можно загрузить

К одному запросу прикладывается до восьми файлов. Разные типы можно смешивать: например, презентацию как макет и таблицу как источник новых чисел.

- изображения: PNG, JPG, WEBP, GIF, BMP — скриншоты, фотографии, сканы, рисунки от руки
- презентации: PPTX — вместе со слайдами, таблицами и диаграммами внутри
- документы: PDF — включая многостраничные отчёты и сканы без текстового слоя
- таблицы: XLSX, XLS, CSV, TSV
- простой текст, если данные удобнее вписать прямо в запрос

## Какие типы диаграмм поддерживаются

Список отражает то, что движок действительно умеет собирать. Типов, которых здесь нет, — например полярных и тернарных диаграмм — сервис не поддерживает.

- столбчатые, линейные, области, точечные и комбинированные графики
- круговые, кольцевые и розы ветров
- воронки, каскадные (waterfall), диаграммы Ганта
- лепестковые (радар), тепловые карты, диаграммы рангов (bump)
- схемы и рисунки без числовых данных — как редактируемые фигуры

## Как задавать задачу словами

Строка запроса понимает обычный язык, и это основной способ управления. Не нужно подбирать формулировки — достаточно объяснить как коллеге.

Полезно указывать, чем является каждый файл, если их несколько: «первый файл — презентация, второй — данные, обнови график по ним». Так сервис не перепутает макет с источником.

- «возьми диаграмму по регионам со страницы 12»
- «сделай этот график редактируемым»
- «обнови данные в моём шаблоне по этой таблице»
- «построй график по строкам 3–9, кроме итоговой»
- «поменяй цвет второго ряда на серый и убери сетку»

## Как проверять распознанные данные

Результат распознавания всегда нужно проверять — это не формальность. Каждое значение помечено уровнем уверенности, и метки означают конкретные вещи.

Зелёная метка: значение прочитано с напечатанной подписи на графике или взято прямо из файла. Такие числа переносятся дословно, ошибиться в них невозможно.

Жёлтая метка: подписи не было, значение вычислено по высоте столбца или углу сектора относительно шкалы. Здесь возможна погрешность, и её стоит сверить с источником.

Любое число правится в таблице, график перерисовывается сразу. Правки и экспорт не тарифицируются.

## Форматы выгрузки

PowerPoint (.pptx) — слайд с настоящей диаграммой OOXML. Она открывается в PowerPoint как обычный объект: работает «Изменить данные», применяются штатные средства оформления, качество не теряется при масштабировании.

Excel (.xlsx) и CSV — таблица значений, где категории идут первой колонкой, а каждый ряд своей. В ячейках лежат чистые числа, чтобы работали формулы; проценты и множители сохраняются как формат отображения.

PNG — изображение готовой диаграммы, когда файл не нужен.

## Работа с вашим шаблоном презентации

Если слайд уже свёрстан и его оформление менять нельзя, сервис заменит в диаграмме только данные. Цвета, шрифты, скругления и расположение элементов останутся прежними.

Это работает и с диаграммами, собранными из фигур, а не вставленными объектом: пересчитываются размеры плашек, переписываются подписи, при необходимости добавляются строки.

Чтобы это включилось, о нём нужно попросить прямо — «обнови данные в моём шаблоне». При сомнении сервис соберёт новый график и не станет трогать ваш файл.

## Точность и её границы

Когда числа напечатаны на графике или лежат внутри .pptx, они переносятся дословно и проверяются на дословность автоматически: значение, которого нет в источнике, отбрасывается, а не подставляется наугад.

Когда чисел нет, значения считываются по геометрии. На чётком скриншоте погрешность обычно невелика, на фотографии под углом или при сильном сжатии — заметно выше.

Сервис не заполняет пропуски правдоподобными числами. Если значение прочитать нельзя, оно останется пустым.

## Расширение для Chrome

Расширение — упрощённая версия для одного сценария: картинка превращается в редактируемый график. Диалога и работы с документами в нём намеренно нет.

Открывается в боковой панели браузера и не закрывает страницу. По правому клику на любом изображении в интернете есть пункт «распознать этот график».

Доступ к сайтам запрашивается только в момент, когда вы сами выбрали картинку в контекстном меню, и только для домена этой страницы.

## Кредиты и оплата

Тарифицируется только распознавание. Редактирование данных, изменение оформления, экспорт во все форматы и работа с диалогом бесплатны и не расходуют кредиты.

Новый аккаунт получает три бесплатных распознавания в месяц. Дальше — подписка или разовые пакеты кредитов, оплата в рублях.

Чтение данных прямо из .pptx кредитов не тратит: там распознавать нечего, числа берутся из файла.

## Ограничения, о которых стоит знать заранее

Честный список того, чего сервис не делает:

- нет полярных, тернарных диаграмм и картографических проекций
- нет ручной простановки точек по изображению — правка идёт по числам в таблице
- распознавание выполняется на сервере, офлайн-режима нет
- с таблицы читается до нескольких сотен строк; если данных больше, сервис предупредит
- на графике без подписей значений точность ограничена качеством изображения

## Если что-то пошло не так

Распознан не тот график из документа — укажите страницу или слайд прямо в запросе либо выберите другой вручную рядом с результатом.

Значения не совпадают с источником — проверьте жёлтые метки: почти всегда расхождение именно там. Числа правятся в таблице бесплатно.

Ваш шаблон не обновился, а собрался новый график — попросите об обновлении прямо, назвав файл шаблоном.

Осталось непонятным — напишите на почту из подвала сайта, приложив файл и описание. Отвечаем и правим.

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

### Нужна ли регистрация?

Разобрать файл и спланировать задачу можно без входа. Аккаунт понадобится перед самим распознаванием — вход по коду на почту, без пароля.

### Что происходит с моими файлами?

Изображение передаётся на сервер для распознавания. Условия обработки и хранения описаны в политике конфиденциальности — ссылка в подвале любой страницы.

### Можно ли обработать несколько графиков сразу?

Да, до пяти графиков за один запуск: каждый попадёт на свой слайд в итоговой презентации.

### Есть ли API?

Публичного API пока нет. Если он нужен для вашей задачи, напишите — мы собираем такие запросы.

---

Источник: https://fasttochart.ru/docs