Арт-код QR API: Заявка и использование

Арт-код QR — это инновационный технологический продукт, который сочетает в себе QR-код и красивый фоновый рисунок, создавая как практичные, так и эстетически привлекательные произведения. Они не только обладают функциональностью традиционных QR-кодов, которые могут быть быстро отсканированы и распознаны умными устройствами, но и добавляют художественные элементы, усиливающие визуальную привлекательность и узнаваемость бренда. Некоторые арт-коды QR даже создаются с помощью искусственного интеллекта, полностью используя современные технологии и демонстрируя беспрецедентные инновации и уникальность. Это делает арт-коды QR широко применимыми в области брендового маркетинга, рекламного продвижения и других сферах. Проще говоря, арт-код QR — это идеальное сочетание сканирования QR-кода и художественной эстетики, которое не только предоставляет функции передачи информации, но и улучшает визуальный опыт пользователя, делая каждое сканирование наполненным художественным наслаждением.

Обзор произведений

Сначала давайте посмотрим на несколько произведений QR-кодов:

Как вам? Эти QR-коды — это арт-коды QR, которые реализуют идеальное сочетание изображения и QR-кода, они более художественны, чем обычные QR-коды. И что важно, каждый QR-код можно отсканировать!

Как создать?

Хотите создать такой QR-код? Как сделать такой арт-код QR? На самом деле, с технической точки зрения это относительно сложно. В нынешнюю эпоху ИИ решение для арт-кодов QR основано на Stable Diffusion, с помощью ввода подсказки мы можем генерировать соответствующие изображения, одновременно сочетая некоторые элементы содержания QR-кода для достижения такого эффекта. Таким образом, основная проблема заключается в том, как сделать QR-код красивым и художественным, при этом чтобы QR-код можно было правильно отсканировать. Честно говоря, эта технология довольно сложна и требует множества настроек параметров, чтобы достичь хотя бы немного лучшего результата. Должен сказать, что 99% людей сдаются на первом шаге. Предположим, что после постоянных настроек мы действительно достигли такого эффекта, его реальная работа также потребует значительных затрат, если нужно быстрое выполнение, возможно, потребуется производительная видеокарта, и это может обойтись в десятки тысяч рублей. Некоторые друзья могут сказать: «Я не хочу тратить столько усилий, я не хочу тратить столько денег, я просто хочу сделать арт-код QR, или я хочу интегрировать эту возможность в свой продукт, было бы здорово, если бы существовал готовый API». Есть ли он? Да, действительно есть. Наша платформа предоставляет API для генерации арт-кодов QR, мы можем вызывать API, вводя различные параметры, такие как содержание изображения, ссылка QR-кода, стиль и другие параметры, и очень удобно генерировать желаемый арт-код QR, а при первой заявке бесплатно предоставляется 20 раз для рисования.

Заявка на API

Чтобы использовать API арт-кодов QR, сначала перейдите на страницу API арт-кодов QR и нажмите кнопку «Получить»:

Если вы еще не вошли в систему, вас автоматически перенаправят на страницу входа, отсканируйте QR-код, чтобы подписаться на официальный аккаунт, и вы автоматически войдете в систему, без дополнительных шагов регистрации. После входа вы вернетесь на исходную страницу, и вам будет предложено «Вы еще не подали заявку на эту услугу, необходимо подать заявку». При подаче заявки будет проверяться статус подтверждения личности, пожалуйста, следуйте указаниям сайта для завершения подтверждения личности. Подтверждение личности проверяет имя, номер телефона и номер удостоверения личности, после завершения проверки вы можете вернуться на страницу, обновить ее, чтобы убедиться, что информация обновлена, а затем повторно подать заявку.

Основное использование

Чтобы использовать основные функции арт-кодов QR, необходимо заполнить следующие обязательные параметры:

type: тип QR-кода, например, простой текст, ссылка и т.д.
content: содержание QR-кода, например, если это ссылка, мы можем ввести соответствующую ссылку.
prompt: команда стиля для рисования QR-кода, настоятельно рекомендуется использовать английский. Например, pizza нарисует QR-код в виде пиццы.
callback_url: необязательный, адрес асинхронного обратного вызова, предоставленный сразу вернет ID задачи.
content_image_url: необязательный, ссылка на изображение, содержащее реальное содержание QR-кода.
aspect_ratio: необязательный, соотношение сторон холста, по умолчанию 1:1.
ecl: уровень коррекции ошибок, по умолчанию H.
qrw: вес QR-кода, 1.5-3, чем больше, тем ближе к реальному QR-коду.
seed: фиксированное случайное семя, генерирующее воспроизводимый QR-код.
steps: количество итераций рисования, 10-20, по умолчанию 16.
preset: предустановленный стиль фона.
pattern: основной стиль, по умолчанию custom.
position: положение QR-кода, по умолчанию center.
marker_shape: форма маркера, по умолчанию square.
sub_marker: форма вспомогательного маркера, по умолчанию square.
pixel_style: пиксельный стиль, например, square, rounded, dot.
padding_level/padding_noise: уровень отступов и интенсивность шума.
rotate: угол поворота, по умолчанию 0.
rawurl: сохранять ли оригинальную ссылку, по умолчанию false, при включении не создавать короткую ссылку.

Теперь давайте сгенерируем QR-код для официального сайта Zhishuyun, тип — ссылка, содержание — https://data.zhishuyun.com, prompt здесь будет следующим:

(best quality, masterpiece:1.2), underwater, ((pirate ship)), close up, zoom in, absurdes, big waves, twister, water falling, tentacles, ((glowing lights)), ((lighting storm)), fog, smoke, 4k res, 8k, higly detailed textures, cinematic shot, intricate details, side view

На тестовой странице заполните следующие данные:

Затем нажмите «Тест»:

Через некоторое время вы увидите сгенерированный арт-код QR, результат будет похож на следующий:

{
  "task_id": "a7e8831c-203d-447e-83fc-71783c766446",
  "image_url": "https://qrart.cdn.zhishuyun.com/attachments/1132182283529494652/1136344944630563006/Germey_2023-08-02__64ca8da51e5834b500e077bf.png",
  "image_width": 768,
  "image_height": 768
}

QR-код выглядит следующим образом:

Таким образом, мы сгенерировали QR-код, основным элементом которого является корабль, на котором развеваются несколько флагов, и эти флаги как раз и составляют точки привязки QR-кода. Сканируйте его с помощью телефона, и вы сможете перейти на официальный сайт Zhishu Cloud. В то же время, вышеупомянутое содержимое можно очень удобно преобразовать в вызов API.

Руководство по подсказкам

Как видно из вышеописанных действий, ключ к художественному QR-коду заключается в написании подсказки, так какие же есть нюансы в написании подсказок? На самом деле, это общие команды подсказок Stable Diffusion, художественный QR-код основан на технологии Stable Diffusion с некоторыми специальными настройками, поэтому его входная подсказка полностью совпадает с Stable Diffusion. Если вы еще не знаете, что такое Stable Diffusion, вы можете ознакомиться с его официальным сайтом: https://stablediffusionweb.com/, а также с руководством и учебником по подсказкам: https://stable-diffusion-art.com/prompt-guide/. Кроме того, Stable Diffusion также разработал генератор подсказок, который может помочь нам создавать подсказки: https://stablediffusionweb.com/prompt-generator, кроме того, есть несколько сайтов с примерами подсказок: https://publicprompts.art/ Вышеуказанное содержимое предназначено только для справки, для получения дополнительной информации вы можете самостоятельно искать материалы, связанные со Stable Diffusion, для изучения.

Расширенные параметры

Этот API также предоставляет больше расширенных параметров для удобства настройки дополнительных функций, описание следующее:

preset: предустановленный стиль фона. Стиль фона QR-кода, например, сюрреалистический стиль, неоновый эффект, стиль ручной рисовки и т.д.
steps: количество итераций рисования. Чем больше количество, тем сильнее художественный стиль QR-кода, диапазон от 10 до 20, по умолчанию 16.
qrw: вес QR-кода. Чем больше вес, тем ближе изображение к реальному QR-коду, но художественный стиль будет ослаблен, диапазон значений от 1.5 до 3, по умолчанию 1.5.
seed: случайное семя. Используется для генерации случайного QR-кода, при одинаковом семени стиль сгенерированного QR-кода будет одинаковым, диапазон от 1 до 9007199254740991.
rawurl: сохранять ли оригинальную ссылку. По умолчанию входная ссылка будет сокращена до короткой ссылки, что может повысить коэффициент сканирования, это значение по умолчанию false.
padding_level: внутренний отступ QR-кода. Размер внутреннего отступа QR-кода,
aspect_ratio: соотношение сторон QR-кода.
position: положение QR-кода.
pixel_style: стиль пикселей QR-кода.
marker_shape: форма рамки привязки QR-кода.
sub_marker: стиль подмаркировки QR-кода.
rotate: угол поворота QR-кода.
ecl: уровень коррекции ошибок QR-кода.
padding_noise: шум внутреннего отступа QR-кода.
pattern: предустановленная комбинация QR-кодов. Предустановленные комбинации стилей QR-кодов, такие как стиль рамки привязки (квадратный, круглый и т.д.), стиль точек (квадратный, круглый и т.д.).

В дальнейшем мы подробно рассмотрим некоторые расширенные параметры API художественного QR-кода, выбрав некоторые из них для представления.

Предустановка preset

API художественного QR-кода установило множество предустановленных шаблонов, этот параметр называется preset, возможные значения следующие:

sunset（日落）: Сочетание теплых тонов и мягкого светового эффекта заката.
floral（花卉）: Художественный стиль с элементами цветов и растений, подчеркивающий красоту природы.
snowflakes（雪花）: Ледяной мир с холодной атмосферой, наполненной кристаллами льда и снежинками.
feathers（羽毛）: Отображение перьев и характеристик птиц, создающее легкое и мягкое ощущение.
raindrops（雨滴）: Вдохновленный каплями дождя и водяными каплями, создающий свежий и влажный эффект.
ultra-realism（超现实）: Крайне реалистичные детали и текстуры, создающие эффект, превосходящий реальность.
epic-realms（史诗领域）: Великолепные сцены и эпическое ощущение, создающее грандиозный визуальный опыт.
intricate-studio（错综复杂）: Стиль, богатый деталями и сложностью, который требует внимательного наблюдения для полного понимания.
symmetric-masterpiece（对称杰作）: Создание изящного баланса и гармонии с помощью симметричных элементов.
luminous-highway（发光高速公路）: Подчеркивание светового эффекта ночью, такого как фары и неоновые огни.
celestial-journey（星际之旅）: Исследование вселенной и межзвездного волшебного путешествия.
neon-mech（霓虹机械）: Сочетание неоновых огней и механических элементов, создающее ощущение будущего.
ethereal-low-poly（飘渺低多边形）: Стиль низкополигональной графики, создающий эфемерный и абстрактный эффект.
golden-vista（金色景观）: Преобладание золотых тонов, создающее зрелищный визуальный пейзаж.
cinematic-expanse（电影式广袤）: Широкие сцены с кинематографическим ощущением, захватывающие внимание.
cinematic-warm（电影式温暖）: Теплые тона и световые эффекты с кинематографическим качеством.
desolate-wilderness（荒凉荒野）: Изображение пустоши и дикой природы, создающее чувство одиночества.
vibrant-palette（鲜明调色板）: Богатая и разнообразная цветовая палитра с ярким контрастом.
enigmatic-journey（神秘之旅）: Исследование путешествия, полного загадок и таинственности.
timeless-cinematic（永恒电影）: Стиль с кинематографическим качеством, не подверженный времени.
regal-galaxy（皇家星系）: Галактики и космические элементы с королевским оттенком.
illustrious-canvas（杰出画布）: Создание выдающегося и привлекательного эффекта на холсте.
expressive-mural（富有表现力的壁画）: Стиль крупной настенной росписи, наполненный выразительностью и эмоциями.
serene-haze（宁静薄雾）: Эффект спокойствия и легкого тумана, создающий умиротворяющую атмосферу.

Мы попробуем разные параметры, например, возьмем sunset（日落） и raindrops（雨滴） для примера.

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "sakura",
    "preset": "sunset"
  }'

Здесь мы установили preset на sunset（日落效果），результат следующий:

Если мы изменим стиль, например, поменяем параметр preset на raindrops（雨滴效果），результат следующий:

Что касается других настроек, вы можете экспериментировать самостоятельно.

二维码宽高比 aspect_ratio

С помощью параметра aspect_ratio мы можем установить соотношение сторон QR-кода, например, квадрат 1:1, прямоугольник 16:9 и так далее, этот параметр:

768x768: Соотношение сторон 1:1, что означает, что ширина и высота холста равны. Соответствующий размер пикселей 768x768, сгенерированный QR-код будет квадратным.
1008x576: Соотношение сторон 16:9, что означает, что ширина холста в 16/9 раз больше высоты. Соответствующий размер пикселей 1008x576, сгенерированный QR-код будет шире, подходит для широкоформатного отображения.
576x1008: Соотношение сторон 9:16, что означает, что ширина холста в 9/16 раз меньше высоты. Соответствующий размер пикселей 576x1008, сгенерированный QR-код будет выше, подходит для вертикального отображения.
864x672: Соотношение сторон 4:3, что означает, что ширина холста в 4/3 раз больше высоты. Соответствующий размер пикселей 864x672, сгенерированный QR-код будет немного квадратным, подходит для общего отображения.
672x864: Соотношение сторон 3:4, что означает, что ширина холста в 3/4 раз меньше высоты. Соответствующий размер пикселей 672x864, сгенерированный QR-код будет немного вертикально-прямоугольным, подходит для общего отображения.

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "Fish",
    "aspect_ratio": "576x1008"
  }'

Здесь мы попытались сгенерировать прямоугольный QR-код, результат следующий:

二维码位置 position

Мы также можем контролировать положение QR-кода с помощью параметра position, например, если на изображении есть девушка в платье, и мы хотим разместить QR-код на месте платья и интегрировать его, мы можем попробовать изменить положение QR-кода, пример вызова следующий:

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "одна из красивых девушек при лунном свете на фоне, в стиле пиксельного хаоса, вдохновленного рококо, темно-белый и небесно-голубой, сделано из пластика, нежные цветы, гонгби, виммельбильдер",
    "position": "bottom",
    "aspect_ratio": "576x1008"
  }'

Эффект如下：

二维码像素风格 pixel_style

Мы также можем настроить пиксельный стиль QR-кода, передав pixel_style, возможные значения параметров следующие:

square（方形）：использует квадратные пиксельные ячейки, каждая пиксельная ячейка имеет форму квадрата.
rounded（圆角）：пиксельные ячейки имеют закругленные углы, что делает сгенерированный QR-код более мягким и современным.
dot（点状）：использует маленькие круглые точки в качестве пиксельных ячеек, сгенерированный QR-код имеет точечный эффект, похожий на печатный эффект.
squircle（圆角方形）：похоже на закругленный прямоугольник, но ближе к круглой форме, придавая сгенерированному QR-коду уникальный стиль.
row（行排列）：располагает пиксельные ячейки по строкам, создавая горизонтальный узор.
column（列排列）：располагает пиксельные ячейки по столбцам, создавая вертикальный узор.

Предварительный просмотр стиля如下：

二维码框风格 marker_shape

С помощью marker_shape можно настроить стиль рамки для позиционирования, возможные значения параметров следующие:

square（方形）：форма метки квадратная, используется для выделения определенного места или элемента.
circle（圆形）：форма метки круглая, может использоваться для обозначения ключевых областей или элементов.
plus（加号）：форма метки в виде плюса, похожа на крест, используется для выделения внимания или определенной информации.
box（方框）：форма метки в виде квадрата, похожа на обводку прямоугольника, может использоваться для окружения области или элемента.
octagon（八边形）：форма метки восьмиугольная, с уникальными углами, используется для визуального привлечения.
random（随机）：форма метки распределена случайным образом, добавляя художественный и визуальный интерес к QR-коду.
tiny-plus（微小加号）：маленькая метка в виде плюса, может использоваться для обозначения мелких элементов или деталей.

Предварительный просмотр стиля如下：

二维码子标记风格 sub_marker

С помощью sub_marker можно настроить форму для подметок (меньших меток), возможные значения параметров следующие:

square（方形）：форма подметки квадратная, может использоваться для выделения деталей определенного места.
circle（圆形）：форма подметки круглая, может использоваться для подчеркивания ключевых деталей или элементов.
box（方框）：форма подметки в виде квадрата, похожа на обводку прямоугольника, подходит для обозначения мелких областей.
random（随机）：форма подметки распределена случайным образом, добавляя художественный и визуальный интерес к QR-коду.
plus（加号）：форма подметки в виде плюса, похожа на крест, может использоваться для обозначения мелкой информации или элементов.

二维码旋转角度 rotate

С помощью rotate можно контролировать угол поворота QR-кода, возможные значения параметров следующие:

0：без поворота, сгенерированный QR-код сохраняет оригинальное направление, без эффекта поворота.
90：сгенерированный QR-код поворачивается по часовой стрелке на 90 градусов, отображаясь в вертикальном направлении.
180：сгенерированный QR-код поворачивается на 180 градусов, отображаясь вверх ногами.
270：сгенерированный QR-код поворачивается по часовой стрелке на 270 градусов, отображаясь в обратном вертикальном направлении.

二维码预设 pattern

С помощью pattern можно легко активировать некоторые стили QR-кода, такие как квадратные рамки для позиционирования, круглые пиксельные точки и т.д., здесь предопределены некоторые pattern:

pattern	含义
s1	pixel_style: квадрат marker_shape: квадрат
s2	pixel_style: квадрат marker_shape: квадрат rotate: 180
s3	pixel_style: квадрат marker_shape: квадрат rotate: 180custom_padding_noise: 0.25
rd1	pixel_style: закругленный marker_shape: случайный
rd2	pixel_style: закругленный marker_shape: случайный rotate: 180
rd3	pixel_style: закругленный marker_shape: случайный rotate: 180custom_padding_noise: 0.25
d1	pixel_style: точка marker_shape: круг
d2	pixel_style: точка marker_shape: круг rotate: 180
d3	pixel_style: точка marker_shape: круг rotate: 180custom_padding_noise: 0.25
r1	pixel_style: ряд marker_shape: плюс
r2	pixel_style: ряд marker_shape: плюс rotate: 180
r3	pixel_style: ряд marker_shape: плюс rotate: 180custom_padding_noise: 0.25
c1	pixel_style: колонка marker_shape: коробка
c2	pixel_style: колонка marker_shape: коробка rotate: 180
c3	pixel_style: колонка marker_shape: коробка rotate: 180custom_padding_noise: 0.25
sq1	pixel_style: сквирл marker_shape: случайный
sq2	pixel_style: сквирл marker_shape: случайный rotate: 180
sq3	pixel_style: сквирл marker_shape: случайный rotate: 180custom_padding_noise: 0.25