アートQRコード API 申請および使用

アートQRコードは、QRコードと美しい背景画像を組み合わせた革新的な技術製品であり、実用的でありながら美しい作品を創造します。これらは、従来のQRコードの機能性を持ち、スマートデバイスで迅速にスキャンして認識できるだけでなく、アート要素を加えることで視覚的な魅力とブランド認識度を高めています。その中には、人工知能によって生成されたアートQRコードもあり、現代技術を最大限に活用し、比類のない革新性と独自性を示しています。これにより、アートQRコードはブランドマーケティングや広告プロモーションなどの分野で広く応用されています。簡単に言えば、アートQRコードはQRコードのスキャンとアートの美しさの完璧な組み合わせであり、情報伝達の機能を提供するだけでなく、ユーザーの視覚体験を向上させ、毎回のスキャンがアートの楽しみで満たされるようにします。

作品概要

まずは、いくつかのQRコード作品を見てみましょう：

どうですか？これらのQRコードはアートQRコードであり、画像とQRコードの完璧な組み合わせを実現しており、普通のQRコードよりもアート感があります。そして重要なのは、すべてのQRコードがスキャン可能です！

どうやって作る？

このようなQRコードを作りたいですか？どうやってこのアートQRコードを作るのでしょうか？実際、技術的には相対的に複雑です。現在のAI時代において、アートQRコードのソリューションはStable Diffusionに基づいており、プロンプトを入力することで対応する画像を生成し、QRコードの内容と融合させて最終的にこのような効果を実現します。したがって、ここでの主な課題は、QRコードを美しくかつアートに富んだものにし、かつQRコードが正しくスキャンされるようにすることです。正直なところ、この技術は実際にはかなり難しく、多くのパラメータ調整が必要で、少しでも良い効果を得るためにはかなりの努力が必要です。 99%の人は最初のステップで諦めてしまうでしょう。仮に、不断の調整を通じて本当にこのような効果を出せたとしても、実際に運用するにはかなりのコストがかかります。もしスピードが必要であれば、性能の良いGPUが必要で、気をつけないと数万円かかることもあります。友人の中には「そんなに労力をかけたくないし、そんなにお金も使いたくない。アートQRコードを作りたい、あるいはこの機能を自分の製品に統合したい。もし既存のAPIがあればいいのに」と思う人もいるかもしれません。ありますか？実際にあります。本プラットフォームでは、アートQRコードに関連する生成APIを提供しており、APIを呼び出してさまざまなパラメータ（画像内容、QRコードリンク、スタイルなど）を入力することで、非常に便利に希望のアートQRコードを生成できます。また、初回申請時には20回の描画が無料で提供されます。

API申請

アートQRコードAPIを使用するには、まずアートQRコード APIページにアクセスし、「取得」ボタンをクリックします：

まだログインしていない場合は、自動的にログインページにリダイレクトされ、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コードを生成してみましょう。タイプはリンク、内容は https://data.zhishuyun.com、プロンプトには以下の内容を入力します：

(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コードの位置決めポイントを構成しています。スマートフォンでスキャンすれば、知数云の公式サイトにジャンプできます。また、上記の内容を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コードスタイルの組み合わせ、例えば位置決めフレームのスタイル（四角形、円形など）、点のスタイル（四角形、円形など）。

以下では、アートQRコードAPIのいくつかの高度なパラメータを詳しく理解し、その中からいくつかを紹介します。

プリセット preset

アートQRコードAPIは多くのプリセットテンプレートを設定しており、このパラメータは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（雨滴効果）に変更すると、効果は以下の通りです：

他の設定については、皆さんで試してみてください。

QRコードのアスペクト比 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コードを生成してみました。効果は以下の通りです：

QRコードの位置 position

positionパラメータを使用してQRコードの位置を制御することもできます。例えば、画像の中にスカートを着た女の子がいて、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"
  }'

効果は以下の通りです：

QRコードピクセルスタイル pixel_style

QRコードのピクセルスタイルをカスタマイズすることもでき、pixel_styleを渡すことで実現できます。パラメータの選択肢は以下の通りです：

square（正方形）：正方形のピクセルユニットを使用し、各ピクセルユニットは正方形の形状です。
rounded（角丸）：ピクセルユニットに角丸があり、生成されたQRコードがより柔らかく現代的に見えます。
dot（点状）：小さな円点をピクセルユニットとして使用し、生成されたQRコードはドットパターンの効果を呈示し、印刷効果に似ています。
squircle（角丸正方形）：角丸の長方形に似ていますが、より円形に近い形状で、生成されたQRコードに独特のスタイルを与えます。
row（行配置）：ピクセルユニットを行に配置し、水平方向のパターンを呈示します。
column（列配置）：ピクセルユニットを列に配置し、垂直方向のパターンを呈示します。

スタイルのプレビューは以下の通りです：

QRコードマーカー形状 marker_shape

marker_shapeを使用して、位置決めボックスのスタイルをカスタマイズできます。パラメータの選択肢は以下の通りです：

square（正方形）：マーカーの形状は正方形で、特定の位置や要素を強調するために使用されます。
circle（円形）：マーカーの形状は円形で、重要な領域や要素をマークするために使用されます。
plus（プラス）：マーカーの形状はプラスで、十字型に似ており、注意や特定の情報を強調するために使用されます。
box（ボックス）：マーカーの形状はボックスで、描画された長方形に似ており、領域や要素を囲むために使用されます。
octagon（八角形）：マーカーの形状は八角形で、独特の角を持ち、視覚的に引き付けます。
random（ランダム）：マーカーの形状がランダムに分布し、QRコードにアート感と視覚的な楽しさを加えます。
tiny-plus（小さなプラス）：小さなプラスマーカーで、細かい要素や詳細をマークするために使用されます。

スタイルのプレビューは以下の通りです：

QRコードサブマーカー形状 sub_marker

sub_markerを使用して、サブマーカー（小さなマーカー）の形状を指定できます。パラメータの選択肢は以下の通りです：

square（正方形）：サブマーカーの形状は正方形で、特定の位置の詳細を強調するために使用されます。
circle（円形）：サブマーカーの形状は円形で、重要な詳細や要素を強調するために使用されます。
box（ボックス）：サブマーカーの形状はボックスで、描画された長方形に似ており、小さな領域をマークするのに適しています。
random（ランダム）：サブマーカーの形状がランダムに分布し、QRコードにアート感と視覚的な楽しさを加えます。
plus（プラス）：サブマーカーの形状はプラスで、十字型に似ており、細かい情報や要素をマークするために使用されます。

QRコード回転角度 rotate

rotateを使用してQRコードの回転角度を制御できます。パラメータの選択肢は以下の通りです：

0：回転せず、生成されたQRコードは元の方向を保持し、回転効果はありません。
90：生成されたQRコードを時計回りに90度回転させ、縦方向に表示します。
180：生成されたQRコードを180度回転させ、逆さまに表示します。
270：生成されたQRコードを時計回りに270度回転させ、逆縦方向に表示します。

QRコードプリセット pattern

patternを使用すると、正方形の位置決めボックスや円形のピクセルポイントなど、いくつかのQRコードスタイルを簡単に有効にできます。ここではいくつかのpatternが事前定義されています：

pattern	含义
s1	ピクセルスタイル: 正方形マーカー形状: 正方形
s2	ピクセルスタイル: 正方形マーカー形状: 正方形回転: 180
s3	ピクセルスタイル: 正方形マーカー形状: 正方形回転: 180カスタムパディングノイズ: 0.25
rd1	ピクセルスタイル: 丸みを帯びたマーカー形状: ランダム
rd2	ピクセルスタイル: 丸みを帯びたマーカー形状: ランダム回転: 180
rd3	ピクセルスタイル: 丸みを帯びたマーカー形状: ランダム回転: 180カスタムパディングノイズ: 0.25
d1	ピクセルスタイル: ドットマーカー形状: 円
d2	ピクセルスタイル: ドットマーカー形状: 円回転: 180
d3	ピクセルスタイル: ドットマーカー形状: 円回転: 180カスタムパディングノイズ: 0.25
r1	ピクセルスタイル: 行マーカー形状: プラス
r2	ピクセルスタイル: 行マーカー形状: プラス回転: 180
r3	ピクセルスタイル: 行マーカー形状: プラス回転: 180カスタムパディングノイズ: 0.25
c1	ピクセルスタイル: 列マーカー形状: ボックス
c2	ピクセルスタイル: 列マーカー形状: ボックス回転: 180
c3	ピクセルスタイル: 列マーカー形状: ボックス回転: 180カスタムパディングノイズ: 0.25
sq1	ピクセルスタイル: スクワイアクルマーカー形状: ランダム
sq2	ピクセルスタイル: スクワイアクルマーカー形状: ランダム回転: 180
sq3	ピクセルスタイル: スクワイアクルマーカー形状: ランダム回転: 180カスタムパディングノイズ: 0.25