Как отлаживать Base64-изображения в JSON API-ответах

Проблема Base64 в JSON

Мультимодальные AI API — генерация изображений, OCR, синтез речи — обычно возвращают медиа в виде Base64-строк внутри JSON. Стандартные JSON-просмотрщики отображают их как обычный текст, и вы видите лишь бесконечную стену закодированных символов без возможности понять содержимое.

Типичный обходной путь требует множества шагов: найти Base64-поле, скопировать строку, открыть отдельный сайт-декодер, вставить, декодировать, скачать. Для одного поля это терпимо, но при нескольких Base64-значениях в ответе процесс становится серьёзным узким местом.

Типичный ответ AI API

Вот упрощённый пример ответа DALL·E с несколькими вариантами изображений:

{
  "created": 1709055842,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAA...",
      "revised_prompt": "A serene mountain landscape at sunset"
    },
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgBBB...",
      "revised_prompt": "A serene mountain landscape at sunrise"
    },
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgCCC...",
      "revised_prompt": "A serene mountain landscape at noon"
    }
  ]
}

Каждое поле "b64_json" содержит полное PNG-изображение в формате Base64. В обычном JSON-просмотрщике вы увидите три стены текста. Без декодирования каждой строки по отдельности невозможно проверить содержимое, сравнить варианты или убедиться в валидности изображений.

Лучший способ: автоматическое определение и инлайн-предпросмотр

ViewJSON автоматически определяет Base64-медиа в JSON и отображает инлайн-предпросмотр: изображения как миниатюры, аудио как воспроизводимые клипы, видео во встроенном плеере, PDF как предпросмотр документа.

Как работает определение формата?

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

Процесс обработки:

1. Для каждого строкового значения ViewJSON декодирует только первые 64 байта Base64-контента
2. Сравнивает эти байты с библиотекой известных сигнатур файловых форматов (магических чисел)
3. При совпадении (например, 89 50 4E 47 для PNG, FF D8 FF для JPEG) отображает соответствующий предпросмотр

Это быстро. Декодирование только 64 байт означает, что даже 100-мегабайтная Base64-строка идентифицируется менее чем за миллисекунду. Полное декодирование происходит только при раскрытии предпросмотра.

Поддерживаемые форматы

ViewJSON определяет и отображает более 15 медиаформатов:

Пошаговое руководство: отладка API-ответов

1. Откройте ViewJSON — перейдите на viewjson.net
2. Вставьте JSON — скопируйте полный ответ API из терминала, Postman или кода и вставьте в редактор. Невалидный JSON (хвостовые запятые, комментарии, ключи без кавычек) восстанавливается автоматически.
3. Проверьте предпросмотр — Base64-поля определяются автоматически. Нажмите на иконку глаза (👁) рядом с медиаполем для переключения инлайн-предпросмотра.
4. Сравните результаты — с включённым предпросмотром прокрутите JSON, чтобы сравнить несколько изображений рядом. Дополнительные инструменты не нужны.
5. Поделитесь с командой — используйте кнопку «Поделиться» для создания сжатого URL с вашим JSON. Очень большие Base64-данные могут быть усечены из-за ограничений длины URL.

Когда это наиболее полезно?

• Проверка результатов DALL·E / Stable Diffusion — API генерации изображений часто возвращают несколько Base64-вариантов. С ViewJSON вы видите все изображения рядом и выбираете лучший результат без отдельного декодирования.
• Проверка OCR-областей — пакетные OCR-пайплайны возвращают десятки обрезанных областей в Base64. Инлайн-просмотр позволяет мгновенно обнаружить ошибки выравнивания или обрезки.
• Сравнение голосовых вариантов TTS — при тестировании различных голосов или стилей произношения в API синтеза речи вы можете прослушать каждый аудиоклип прямо внутри JSON.
• Просмотр HTTP-перехватов — вставьте JSON из истории запросов Postman или Fiddler, чтобы увидеть реально отправленные или полученные медиа вместо прокрутки закодированных строк.

Конфиденциальность

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