https://codedchords.dev • This is a web feed, also known as an Atom feed. Subscribe by copying the URL from the address bar into your newsreader. Visit About Feeds to learn more and get started. It's free. Visit website Recent posts Updated on $DATE date API Coded Chords - API A personal blog Zola2026-09-16T00:00:00+00:00https://codedchords.dev/tags/api/atom.xml 発表されたGPT-image-2.5 Flareに移行 2026-09-16T00:00:00+00:00 2026-09-16T00:00:00+00:00 Toshiyuki Yoshida https://codedchords.dev/blog/2026/09/gpt-image-2-5/ <!-- textlint-disable --> <img src="https:&#x2F;&#x2F;codedchords.dev&#x2F;blog&#x2F;2026&#x2F;09&#x2F;gpt-image-2-5&#x2F;cover.avif?h=0a7e385af6656ed96ec0" alt="Cover" width="1536" height="864" loading="lazy" /><!-- textlint-enable --> <details> <summary>Table of Contents</summary> <!-- toc --> </details> <p>このブログの記事上部にあるカバー画像はOpenAIのGPT-image-2を使用してカバー画像を生成していましたが、GPT-image-2.5が発表されたので早速移行してみました。</p> <h2 id="GPT-image-2.5の概要">GPT-image-2.5の概要</h2> <p>GPT-image-2.5は、性格の異なる2つのモデルとして公開されました。OpenAIはそれぞれを次のように位置づけています。</p> <ul> <li><code>gpt-image-2.5-flare</code>は「日常的な用途で高品質な画像を生成するための、最も速いモデル」である</li> <li><code>gpt-image-2.5-sunburst</code>は「画像の生成と編集における最も高性能なモデル」である</li> </ul> <p>トークン単価はどちらのモデルもGPT-image-2と同じです。</p> <p>品質指定の段が増えました。これまでは<code>low</code> / <code>medium</code> / <code>high</code>の3段階で、<code>high</code>が最上段でした。2.5ではその上に<code>xhigh</code>と<code>max</code>が加わり、<code>high</code>は最上段ではなくなっています。</p> <p>試験的提供であった透過背景が今回正式な機能として提供されました。<code>background</code>に<code>transparent</code>を指定してPNGかWebPで受け取ると、背景を抜いた画像が返ります。文字の描画も大きく改善されましたが、正確な位置に置くのは依然として苦手です。</p> <h2 id="gpt-image-2.5-flare_vs_gpt-image-2">gpt-image-2.5-flare vs gpt-image-2</h2> <p>移行の前後で何がどう変わるのかを、同じプロンプトで実際に生成して比べました。サイズは1536x864、品質はhighで、両モデルとも条件を揃えました。実際に使用したプロンプトは以下です。</p> <details> <summary>プロンプト</summary> <pre class="giallo z-code"><code data-lang="plain"><span class="giallo-l"><span>荒れた海の上で対峙するポセイドンとネプチューン。</span></span> <span class="giallo-l"><span>左に立つポセイドンは青緑の海水をまとい、三叉の銛を振り上げている。</span></span> <span class="giallo-l"><span>右のネプチューンは白い波頭を鎧のようにまとい、同じく三叉の銛を構える。</span></span> <span class="giallo-l"><span>二人の間で海面が渦を巻き、波しぶきが高く上がる。</span></span> <span class="giallo-l"><span>低い位置から見上げる構図、嵐の空、雲間から差す光。</span></span> <span class="giallo-l"><span>油彩のような重い質感、青と灰色を基調に、波しぶきだけが白く輝く。</span></span> <span class="giallo-l"><span>文字やロゴは写り込まない。</span></span></code></pre></details> <p>生成時間は各モデル3回ずつ計測しています。サーバー側の混雑が一方に偏らないよう、GPT-image-2とFlareを1回ずつ交互に実行しました。ジョブを投入してから完了を確認するまでの秒数です。</p> <table><thead><tr><th>モデル</th><th style="text-align: right">1回目</th><th style="text-align: right">2回目</th><th style="text-align: right">3回目</th><th style="text-align: right">中央値</th></tr></thead><tbody> <tr><td>gpt-image-2</td><td style="text-align: right">129.1</td><td style="text-align: right">118.7</td><td style="text-align: right">117.6</td><td style="text-align: right">118.7</td></tr> <tr><td>gpt-image-2.5-flare</td><td style="text-align: right">25.2</td><td style="text-align: right">25.8</td><td style="text-align: right">25.4</td><td style="text-align: right">25.4</td></tr> </tbody></table> <p>中央値で4.7倍の差です。3回の振れ幅はGPT-image-2が117.6秒から129.1秒、Flareが25.2秒から25.8秒に収まっていて、たまたま速い1回を引いたわけではありません。2分待つか25秒待つかは、記事を書きながら試行錯誤する場面ではかなり違います。</p> <p>生成された6枚です。左がgpt-image-2、右がgpt-image-2.5-flareで、上から1回目・2回目・3回目です。この節に掲載しているのは縮小したサムネイルです。元データの可逆WebPは、以下にまとめて置いています。</p> <ul> <li><a rel="external" href="https://e.pcloud.link/publink/show?code=kZ9Kq77ZJs6HQphSWUJPRcwIyyiRpJuQAqiy">ポセイドンとネプチューンの生成画像（可逆WebP）</a></li> </ul> <div style="display:grid;gap:1rem;margin:1.5rem 0; grid-template-columns:repeat(auto-fit,minmax(280px,1fr));"> <figure style="margin:0;text-align:center;"> <img src="poseidon-old-1-thumb.avif" alt="gpt-image-2が1回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>1回目 / gpt-image-2</figcaption> </figure> <figure style="margin:0;text-align:center;"> <img src="poseidon-flare-1-thumb.avif" alt="gpt-image-2.5-flareが1回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>1回目 / gpt-image-2.5-flare</figcaption> </figure> <figure style="margin:0;text-align:center;"> <img src="poseidon-old-2-thumb.avif" alt="gpt-image-2が2回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>2回目 / gpt-image-2</figcaption> </figure> <figure style="margin:0;text-align:center;"> <img src="poseidon-flare-2-thumb.avif" alt="gpt-image-2.5-flareが2回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>2回目 / gpt-image-2.5-flare</figcaption> </figure> <figure style="margin:0;text-align:center;"> <img src="poseidon-old-3-thumb.avif" alt="gpt-image-2が3回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>3回目 / gpt-image-2</figcaption> </figure> <figure style="margin:0;text-align:center;"> <img src="poseidon-flare-3-thumb.avif" alt="gpt-image-2.5-flareが3回目に生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>3回目 / gpt-image-2.5-flare</figcaption> </figure> </div> <p>総じてFlareのほうが主題をフォーカスし密度が高い構図になっています。コトラストの高く見やすい絵になっています。ただし、gpt-image-2のほうも悪くはなく、広大さと自然なコントラストでこちらが好きと言う方も多いでしょう。</p> <p>速さは疑いようがなく、何度か引き直して選ぶ使い方であれば1回25秒で試せることの方が効いてきます。</p> <p>ここまではすべて<code>high</code>での生成です。2.5で加わった<code>max</code>がどう違うのかを、同じプロンプトで1枚だけ試しました。</p> <div style="text-align:center;margin:1.5rem 0;"> <figure> <img src="poseidon-flare-max-thumb.avif" alt="gpt-image-2.5-flareがmax品質で生成したポセイドンとネプチューン" width="400" height="225" loading="lazy"> <figcaption>quality=max / gpt-image-2.5-flare</figcaption> </figure> </div> <p>所要時間は35.3秒でした。<code>high</code>の25秒台から4割ほど伸びています。</p> <p>サムネではあまりわかりませんが、元のサイズで確認すると明らかに絵が油彩のような質感を再現しています。画像の題材やもっとフォトリアリスティックなトーンであればよりはっきりと質感は上がるかも知れません。この1枚の生成にかかったのは約0.13ドルになります。</p> <h2 id="画像生成に使用しているスクリプト">画像生成に使用しているスクリプト</h2> <p>カバー画像は<code>scripts/generate-cover.sh</code>という自前のシェルスクリプトで生成しています。プロンプトと出力先を渡すと、OpenAIに投げてAVIFに変換するところまでやります。全文は以下のとおりです。</p> <details> <summary>scripts/generate-cover.sh</summary> <pre class="giallo z-code"><code data-lang="shellscript" data-name="scripts/generate-cover.sh"><span class="giallo-l"><span class="z-punctuation z-definition z-comment z-shebang z-shell z-meta z-shebang z-shell">#!/bin/bash</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">set</span><span class="z-string"> -euo pipefail</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Generate cover image using OpenAI gpt-image-2.5 Flare API</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Requires: OPENAI_API_KEY, curl, jq, avifenc</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Note: gpt-image-2.5 can return png, jpeg or webp, but we deliberately</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># keep the default PNG. It is the only lossless option among them, and</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># feeding a lossless intermediate to avifenc avoids stacking a second</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># generation of lossy artifacts on top of the AVIF encode.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment">#</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># AVIF is used for photographic and AI-generated cover images only.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Diagrams, charts and screenshots must stay lossless WebP:</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># cwebp -lossless -z 9 -exact input.png -o output.webp</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">SIZE</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;1536x864&quot;</span></span> <span class="giallo-l"><span class="z-source">QUALITY</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;high&quot;</span></span> <span class="giallo-l"><span class="z-source">MODEL</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;gpt-image-2.5-flare&quot;</span><span class="z-punctuation z-definition z-comment z-comment"> # image_generation tool model</span></span> <span class="giallo-l"><span class="z-source">HOST_MODEL</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;gpt-4.1-mini&quot;</span><span class="z-punctuation z-definition z-comment z-comment"> # host model that drives the image tool</span></span> <span class="giallo-l"><span class="z-source">AVIF_QUALITY</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;60&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">usage</span><span class="z-punctuation">() {</span></span> <span class="giallo-l"><span class="z-entity z-name z-function"> cat</span><span class="z-keyword z-operator"> &lt;&lt;</span><span class="z-punctuation z-definition z-string">&#39;USAGE&#39;</span></span> <span class="giallo-l"><span class="z-string">Usage: generate-cover.sh -p &lt;prompt&gt; -o &lt;output&gt; [-s size] [-q quality] [-w avif_quality]</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-string">Options:</span></span> <span class="giallo-l"><span class="z-string"> -p Image generation prompt (required)</span></span> <span class="giallo-l"><span class="z-string"> -o Output file path, e.g. cover.avif (required)</span></span> <span class="giallo-l"><span class="z-string"> -s Size: 1536x864, 2048x1152, 1024x1024, etc.</span></span> <span class="giallo-l"><span class="z-string"> Must be multiples of 16, aspect ratio within 3:1 to 1:3.</span></span> <span class="giallo-l"><span class="z-string"> (default: 1536x864 = 16:9)</span></span> <span class="giallo-l"><span class="z-string"> -q Quality: low, medium, high, xhigh, or max (default: high)</span></span> <span class="giallo-l"><span class="z-string"> gpt-image-2.5 adds xhigh and max above high. They cost more per</span></span> <span class="giallo-l"><span class="z-string"> image, so covers stay at high unless asked otherwise.</span></span> <span class="giallo-l"><span class="z-string"> -w AVIF encoder quality (0-100, default: 60)</span></span> <span class="giallo-l"><span class="z-string"> 60 is roughly equivalent to the previous cwebp -q 80.</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-string">Examples:</span></span> <span class="giallo-l"><span class="z-string"> # 16:9 cover image (default)</span></span> <span class="giallo-l"><span class="z-string"> ./scripts/generate-cover.sh \</span></span> <span class="giallo-l"><span class="z-string"> -p &quot;A futuristic cityscape&quot; \</span></span> <span class="giallo-l"><span class="z-string"> -o content/blog/2026/05/my-article/cover.avif</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-string"> # Higher-quality AVIF encoding</span></span> <span class="giallo-l"><span class="z-string"> ./scripts/generate-cover.sh \</span></span> <span class="giallo-l"><span class="z-string"> -p &quot;Abstract pattern&quot; \</span></span> <span class="giallo-l"><span class="z-string"> -o output.avif -w 75</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string">USAGE</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-punctuation">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword">while</span><span class="z-support z-function z-builtin"> getopts</span><span class="z-punctuation z-definition z-string z-string"> &quot;p:o:s:q:w:&quot; opt</span><span class="z-punctuation">;</span><span class="z-keyword"> do</span></span> <span class="giallo-l"><span class="z-keyword"> case</span><span class="z-punctuation z-definition z-variable z-source"> $opt</span><span class="z-keyword"> in</span></span> <span class="giallo-l"><span class="z-string"> p</span><span class="z-keyword z-operator">)</span><span class="z-source"> PROMPT</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-variable z-other z-normal z-shell">$OPTARG</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-string"> o</span><span class="z-keyword z-operator">)</span><span class="z-source"> OUTPUT</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-variable z-other z-normal z-shell">$OPTARG</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-string"> s</span><span class="z-keyword z-operator">)</span><span class="z-source"> SIZE</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-variable z-other z-normal z-shell">$OPTARG</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-string"> q</span><span class="z-keyword z-operator">)</span><span class="z-source"> QUALITY</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-variable z-other z-normal z-shell">$OPTARG</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-string"> w</span><span class="z-keyword z-operator">)</span><span class="z-source"> AVIF_QUALITY</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-variable z-other z-normal z-shell">$OPTARG</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> *)</span><span class="z-entity z-name z-function"> usage</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-keyword"> esac</span></span> <span class="giallo-l"><span class="z-keyword">done</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword">if</span><span class="z-punctuation"> [</span><span class="z-keyword z-operator"> -z</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-punctuation z-definition z-variable z-variable z-other z-normal z-shell">${PROMPT</span><span class="z-keyword z-operator">:-</span><span class="z-punctuation z-definition z-variable">}</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ]</span><span class="z-keyword z-operator"> ||</span><span class="z-punctuation"> [</span><span class="z-keyword z-operator"> -z</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-punctuation z-definition z-variable z-variable z-other z-normal z-shell">${OUTPUT</span><span class="z-keyword z-operator">:-</span><span class="z-punctuation z-definition z-variable">}</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ];</span><span class="z-keyword"> then</span></span> <span class="giallo-l"><span class="z-entity z-name z-function"> usage</span></span> <span class="giallo-l"><span class="z-keyword">fi</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword">if</span><span class="z-punctuation"> [</span><span class="z-keyword z-operator"> -z</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-punctuation z-definition z-variable z-variable z-other z-normal z-shell">${OPENAI_API_KEY</span><span class="z-keyword z-operator">:-</span><span class="z-punctuation z-definition z-variable">}</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ];</span><span class="z-keyword"> then</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Error: OPENAI_API_KEY is not set&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-keyword">fi</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Generating image with </span><span class="z-variable z-other z-normal z-shell">$MODEL</span><span class="z-string z-punctuation z-definition z-string">...&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot; Size: </span><span class="z-variable z-other z-normal z-shell">$SIZE</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot; Quality: </span><span class="z-variable z-other z-normal z-shell">$QUALITY</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot; AVIF quality: </span><span class="z-variable z-other z-normal z-shell">$AVIF_QUALITY</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot; Prompt: </span><span class="z-punctuation z-definition z-variable z-variable z-other z-normal z-shell">${PROMPT</span><span class="z-keyword z-operator">:</span><span class="z-variable z-other z-normal z-shell">0</span><span class="z-keyword z-operator">:</span><span class="z-variable z-other z-normal z-shell z-punctuation z-definition z-variable">80}</span><span class="z-string z-punctuation z-definition z-string">...&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">RESP_FILE</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">mktemp</span><span class="z-string"> -t cover-resp-XXXXXX</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-source">TMP_PNG</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">mktemp</span><span class="z-string"> -t cover-XXXXXX</span><span class="z-punctuation">)</span><span class="z-string">.png</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">trap</span><span class="z-punctuation z-definition z-string z-string"> &#39;rm -f &quot;$RESP_FILE&quot; &quot;$TMP_PNG&quot;&#39; EXIT</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># A high-quality render can still take a couple of minutes — longer than the</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># ~60s idle timeout that closes a synchronous (or streamed) connection before</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># the image is ready. Submit the job in background mode via the Responses API</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># and poll for it, so every HTTP request is short-lived and never hits the</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># timeout. The image_generation tool drives gpt-image-2.5 Flare; the host model just</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># forwards the prompt verbatim.</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Submitting background job...&quot;</span></span> <span class="giallo-l"><span class="z-source">SUBMIT</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">curl</span><span class="z-string"> -s --max-time</span><span class="z-constant z-numeric"> 60</span><span class="z-string"> https://api.openai.com/v1/responses</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> -H &quot;Content-Type: application/json&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> -H &quot;Authorization: Bearer </span><span class="z-variable z-other z-normal z-shell">$OPENAI_API_KEY</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> -d &quot;</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">jq</span><span class="z-string"> -n</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> --arg host &quot;</span><span class="z-variable z-other z-normal z-shell">$HOST_MODEL</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> --arg model &quot;</span><span class="z-variable z-other z-normal z-shell">$MODEL</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> --arg prompt &quot;</span><span class="z-variable z-other z-normal z-shell">$PROMPT</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> --arg size &quot;</span><span class="z-variable z-other z-normal z-shell">$SIZE</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> --arg quality &quot;</span><span class="z-variable z-other z-normal z-shell">$QUALITY</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string z-string"> &#39;{model: $host, background: true, store: true,</span></span> <span class="giallo-l"><span class="z-string"> instructions: &quot;The user message is the exact image prompt. Call the image_generation tool once using that text verbatim as the prompt; do not paraphrase, summarize, translate, or add to it.&quot;,</span></span> <span class="giallo-l"><span class="z-string"> input: $prompt,</span></span> <span class="giallo-l"><span class="z-string"> tools: [{type: &quot;image_generation&quot;, model: $model, size: $size, quality: $quality}],</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> tool_choice: {type: &quot;image_generation&quot;}}&#39;</span><span class="z-punctuation">)</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">JOB_ID</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$SUBMIT</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> |</span><span class="z-entity z-name z-function"> jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;.id // empty&#39;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-keyword">if</span><span class="z-punctuation"> [</span><span class="z-keyword z-operator"> -z</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$JOB_ID</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ];</span><span class="z-keyword"> then</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Error: </span><span class="z-punctuation">$(</span><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$SUBMIT</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> |</span><span class="z-entity z-name z-function"> jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;.error.message // &quot;failed to submit job&quot;&#39;</span><span class="z-punctuation">)</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-keyword">fi</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot; Job: </span><span class="z-variable z-other z-normal z-shell">$JOB_ID</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Polling for completion (high quality can take a few minutes)...&quot;</span></span> <span class="giallo-l"><span class="z-source">STATUS</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string">&quot;&quot;</span></span> <span class="giallo-l"><span class="z-keyword">for</span><span class="z-source"> _</span><span class="z-keyword"> in</span><span class="z-punctuation"> $(</span><span class="z-entity z-name z-function">seq</span><span class="z-constant z-numeric"> 1 120</span><span class="z-punctuation">);</span><span class="z-keyword"> do</span></span> <span class="giallo-l"><span class="z-entity z-name z-function"> curl</span><span class="z-string"> -s --max-time</span><span class="z-constant z-numeric"> 30</span><span class="z-punctuation z-definition z-string z-string"> &quot;https://api.openai.com/v1/responses/</span><span class="z-variable z-other z-normal z-shell">$JOB_ID</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-string z-punctuation z-definition z-string"> -H &quot;Authorization: Bearer </span><span class="z-variable z-other z-normal z-shell">$OPENAI_API_KEY</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> &gt;</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$RESP_FILE</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-source"> STATUS</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;.status // &quot;unknown&quot;&#39; &quot;</span><span class="z-variable z-other z-normal z-shell">$RESP_FILE</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-keyword"> case</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$STATUS</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword"> in</span></span> <span class="giallo-l"><span class="z-string"> completed</span><span class="z-keyword z-operator">)</span><span class="z-keyword"> break</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-string"> failed</span><span class="z-punctuation">|</span><span class="z-string">cancelled</span><span class="z-punctuation">|</span><span class="z-string">incomplete</span><span class="z-keyword z-operator">)</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Error: job </span><span class="z-variable z-other z-normal z-shell">$STATUS</span><span class="z-string"> — </span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;.error.message // .incomplete_details.reason // &quot;no detail&quot;&#39; &quot;</span><span class="z-variable z-other z-normal z-shell">$RESP_FILE</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">)</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span><span class="z-punctuation"> ;;</span></span> <span class="giallo-l"><span class="z-keyword"> esac</span></span> <span class="giallo-l"><span class="z-entity z-name z-function"> sleep</span><span class="z-constant z-numeric"> 5</span></span> <span class="giallo-l"><span class="z-keyword">done</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword">if</span><span class="z-punctuation"> [</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$STATUS</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> !=</span><span class="z-punctuation z-definition z-string z-string"> &quot;completed&quot;</span><span class="z-punctuation"> ];</span><span class="z-keyword"> then</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Error: job did not complete (last status: </span><span class="z-variable z-other z-normal z-shell">$STATUS</span><span class="z-string z-punctuation z-definition z-string">)&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-keyword">fi</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">B64</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;[.output[]? | select(.type==&quot;image_generation_call&quot;) | .result][0] // empty&#39; &quot;</span><span class="z-variable z-other z-normal z-shell">$RESP_FILE</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-keyword">if</span><span class="z-punctuation"> [</span><span class="z-keyword z-operator"> -z</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$B64</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation"> ];</span><span class="z-keyword"> then</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Error: no image in completed response&quot;</span></span> <span class="giallo-l"><span class="z-entity z-name z-function"> jq</span><span class="z-string z-punctuation z-definition z-string"> -r &#39;.output[]? | select(.type==&quot;message&quot;) | .content[]?.text // empty&#39; &quot;</span><span class="z-variable z-other z-normal z-shell">$RESP_FILE</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> |</span><span class="z-entity z-name z-function"> head</span><span class="z-string"> -c</span><span class="z-constant z-numeric"> 500</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> echo</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin"> exit</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-keyword">fi</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Decoding base64 image...&quot;</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin">printf</span><span class="z-punctuation z-definition z-string z-string"> &#39;%s&#39; &quot;</span><span class="z-variable z-other z-normal z-shell">$B64</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> |</span><span class="z-entity z-name z-function"> base64</span><span class="z-string"> -d</span><span class="z-keyword z-operator"> &gt;</span><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$TMP_PNG</span><span class="z-punctuation z-definition z-string">&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Converting to AVIF (quality=</span><span class="z-variable z-other z-normal z-shell">$AVIF_QUALITY</span><span class="z-string z-punctuation z-definition z-string">)...&quot;</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">avifenc</span><span class="z-string z-punctuation z-definition z-string"> -q &quot;</span><span class="z-variable z-other z-normal z-shell">$AVIF_QUALITY</span><span class="z-punctuation z-definition z-string z-string">&quot; -y</span><span class="z-constant z-numeric"> 420</span><span class="z-string"> -s</span><span class="z-constant z-numeric"> 6</span><span class="z-string"> --ignore-exif --ignore-xmp</span><span class="z-constant z-character z-escape"> \</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;</span><span class="z-variable z-other z-normal z-shell">$TMP_PNG</span><span class="z-punctuation z-definition z-string">&quot; &quot;</span><span class="z-variable z-other z-normal z-shell">$OUTPUT</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> &gt;</span><span class="z-string"> /dev/null</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin">echo</span><span class="z-punctuation z-definition z-string z-string"> &quot;Saved: </span><span class="z-variable z-other z-normal z-shell">$OUTPUT</span><span class="z-string"> (</span><span class="z-punctuation">$(</span><span class="z-entity z-name z-function">du</span><span class="z-string z-punctuation z-definition z-string"> -h &quot;</span><span class="z-variable z-other z-normal z-shell">$OUTPUT</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-keyword z-operator"> |</span><span class="z-entity z-name z-function"> cut</span><span class="z-string"> -f1</span><span class="z-punctuation">)</span><span class="z-string z-punctuation z-definition z-string">)&quot;</span></span></code></pre></details> <p>今回はパラメータや戻り値に変更はないので、モデル名の修正だけで移行できました。</p> <pre class="giallo z-code"><code data-lang="diff"><span class="giallo-l"><span class="z-punctuation">-</span><span class="z-markup z-deleted z-diff">MODEL=&quot;gpt-image-2&quot; # image_generation tool model</span></span> <span class="giallo-l"><span class="z-punctuation">+</span><span class="z-markup z-inserted z-diff">MODEL=&quot;gpt-image-2.5-flare&quot; # image_generation tool model</span></span></code></pre><h2 id="まとめ">まとめ</h2> <p>GPT-image-2からGPT-image-2.5 Flareへの移行は、スクリプトのモデル名を1行変えるだけで済みました。パラメータと戻り値は変わらず、トークン単価も据え置きです。</p> <p>効果がはっきり出たのは速さでした。同じプロンプトと設定で、中央値118.7秒が25.4秒になっています。記事を書きながら何度か引き直す使い方では、この差がそのまま作業の速さになります。</p> <p>画質は一長一短です。Flareは描写が濃く絵としての見栄えは上です。一方でgpt-image-2は色の指示に忠実で、構図も落ち着いています。速くなったからといって指示への忠実さまで上がったわけではありませんでした。</p> <p>新しく加わった<code>max</code>は35.3秒、1枚あたり約0.13ドルでした。<code>high</code>よりも質感は上がりますから、高解像度でここぞという1枚では選ぶ価値があります。</p> <h2 id="References">References</h2> <!-- textlint-disable --> <div class="references"> <ul> <li><a rel="external" href="https://developers.openai.com/api/docs/guides/image-generation">OpenAI</a>. 「Image generation」</li> <li><a rel="external" href="https://developers.openai.com/api/docs/pricing">OpenAI</a>. 「Pricing」</li> <li><a rel="external" href="https://developers.openai.com/api/docs/models/gpt-image-2.5-flare">OpenAI</a>. 「GPT-Image-2.5 Flare」</li> <li><a rel="external" href="https://developers.openai.com/api/docs/changelog">OpenAI</a>. 「Changelog」</li> </ul> </div> <!-- textlint-enable --> GPT-image-2.5が発表されました。生成速度と品質向上が謳われているので、実際にgpt-image-2.5-flareを使用して画像生成を行い旧モデルと比較してみます。 SoundCloud API仕様の変更 2025-04-28T00:00:00+00:00 2025-04-28T00:00:00+00:00 Toshiyuki Yoshida https://codedchords.dev/blog/2025/04/soundcloud-api-changed/ <p>直近数日の内にSoundCloudはAPIの仕様を変更したようです。自作のTypeScriptコンポーネントがうまく機能しなくなったために対応しました。</p> <h2 id="変更のポイント">変更のポイント</h2> <p>以下のコードは以前使用していたものでSoundCloudの曲をWebに埋め込むためのコー ドです。</p> <pre class="giallo z-code"><code data-lang="javascript"><span class="giallo-l"><span class="z-keyword z-storage z-type">export const</span><span class="z-entity z-name z-function"> SoundCloudEmbed</span><span class="z-keyword z-operator">:</span><span class="z-entity z-name z-type"> React</span><span class="z-punctuation z-accessor">.</span><span class="z-entity z-name z-type">FC</span><span class="z-punctuation z-definition z-typeparameters">&lt;</span><span class="z-entity z-name z-type">SoundCloudEmbedProps</span><span class="z-punctuation z-definition z-typeparameters">&gt;</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> ({</span><span class="z-variable z-parameter"> url</span><span class="z-punctuation"> })</span><span class="z-storage z-type"> =&gt;</span><span class="z-punctuation"> {</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> // SoundCloud の埋め込み URL 形式に変換</span></span> <span class="giallo-l"><span class="z-storage z-type"> const</span><span class="z-variable z-other z-constant z-js"> embedUrl</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation z-definition z-string z-string"> `https://w.soundcloud.com/player/?url=</span><span class="z-punctuation">${</span><span class="z-entity z-name z-function">encodeURIComponent</span><span class="z-string">(</span><span class="z-variable z-other z-readwrite">url</span><span class="z-string">)</span><span class="z-punctuation">}</span><span class="z-string z-punctuation z-definition z-string">&amp;color=%23ff5500&amp;auto_play=false&amp;hide_related=false&amp;show_comments=true&amp;show_user=true&amp;show_reposts=false&amp;show_teaser=true`</span><span class="z-punctuation">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword"> return</span><span class="z-source"> (</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;</span><span class="z-entity z-name z-tag">div</span><span class="z-entity z-other z-attribute-name"> className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;w-full&quot;</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;</span><span class="z-entity z-name z-tag">iframe</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> width</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;100%&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> height</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;166&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> scrolling</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;no&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> frameBorder</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;no&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> allow</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;autoplay&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> src</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">{</span><span class="z-variable z-other z-readwrite">embedUrl</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &gt;&lt;/</span><span class="z-entity z-name z-tag">iframe</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;</span><span class="z-entity z-name z-tag">div</span><span class="z-entity z-other z-attribute-name"> className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;text-[10px] text-gray-400 overflow-hidden whitespace-nowrap text-ellipsis font-light&quot;</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;</span><span class="z-entity z-name z-tag">a</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> href</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;https://soundcloud.com/yostos&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> title</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;Yostos&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> target</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;_blank&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> rel</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;noopener noreferrer&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;text-gray-400 no-underline&quot;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &gt;</span></span> <span class="giallo-l"><span class="z-source"> Yostos</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;/</span><span class="z-entity z-name z-tag">a</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-punctuation"> &amp;</span><span class="z-source">nbsp</span><span class="z-punctuation">;</span><span class="z-source">·</span><span class="z-punctuation">&amp;</span><span class="z-source">nbsp</span><span class="z-punctuation">;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;</span><span class="z-entity z-name z-tag">a</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> href</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">{</span><span class="z-variable z-other z-readwrite">url</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> title</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;Yostos&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> target</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;_blank&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> rel</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;noopener noreferrer&quot;</span></span> <span class="giallo-l"><span class="z-entity z-other z-attribute-name"> className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;text-gray-400 no-underline&quot;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &gt;</span></span> <span class="giallo-l"><span class="z-source"> Blackbird</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;/</span><span class="z-entity z-name z-tag">a</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;/</span><span class="z-entity z-name z-tag">div</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-tag"> &lt;/</span><span class="z-entity z-name z-tag">div</span><span class="z-punctuation z-definition z-tag">&gt;</span></span> <span class="giallo-l"><span class="z-source"> )</span><span class="z-punctuation">;</span></span> <span class="giallo-l"><span class="z-punctuation">};</span></span></code></pre> <p>以前はiframeのsrcに指定するurlは曲ページへのリンクと同じリンクを指定すればよかった のですが、ここ数日の変更でiframeのsrcの指定はAPI専用のURLでなければならなく なったようです。</p> <p>この変更は既にアップロードされている曲には遡及していないようで、直近にアップ ロードした曲のみに影響しています。</p> <h2 id="SoundCloudEmbed_コンポーネントの変更">SoundCloudEmbed コンポーネントの変更</h2> <p>本来はSoundCloudでJavascriptのコードを取得すべきです。 このブログではMDXを使っている関係で取得したコードでは修正が必要なため、 <code>SoundCloudEmbed</code>というコンポーネントを作っていました。 この変更でShare Linkのみ指定していたSoundCloudEmbedは動かなくなりました。</p> <p>仕方がないのでAPI用のURLを指定できようように修正しました。またタイトルの固定 でなく曲名を指定できるよう変更しています。</p> <pre class="giallo z-code"><code data-lang="typescript"><span class="giallo-l"></span> <span class="giallo-l"><span class="z-storage z-type">type</span><span class="z-entity z-name z-type"> SoundCloudEmbedProps</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> {</span></span> <span class="giallo-l"><span class="z-variable z-object z-property"> url</span><span class="z-keyword z-operator">:</span><span class="z-support z-type z-primitive"> string</span><span class="z-punctuation">;</span></span> <span class="giallo-l"><span class="z-variable z-object z-property"> apiurl</span><span class="z-keyword z-operator">?:</span><span class="z-support z-type z-primitive"> string</span><span class="z-punctuation">;</span><span class="z-punctuation z-definition z-comment z-comment"> // Optional API URL</span></span> <span class="giallo-l"><span class="z-variable z-object z-property"> title</span><span class="z-keyword z-operator">?:</span><span class="z-support z-type z-primitive"> string</span><span class="z-punctuation">;</span><span class="z-punctuation z-definition z-comment z-comment"> // Optional title</span></span> <span class="giallo-l"><span class="z-punctuation">};</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-storage z-type">export const</span><span class="z-entity z-name z-function"> SoundCloudEmbed</span><span class="z-keyword z-operator">:</span><span class="z-entity z-name z-type"> React</span><span class="z-punctuation z-accessor">.</span><span class="z-entity z-name z-type">FC</span><span class="z-punctuation z-definition z-typeparameters">&lt;</span><span class="z-entity z-name z-type">SoundCloudEmbedProps</span><span class="z-punctuation z-definition z-typeparameters">&gt;</span><span class="z-keyword z-operator"> =</span><span class="z-source"> (</span><span class="z-punctuation">{</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> url</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> apiurl</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> title</span></span> <span class="giallo-l"><span class="z-punctuation">}</span><span class="z-source">)</span><span class="z-storage z-type z-function z-arrow z-ts"> =&gt;</span><span class="z-punctuation"> {</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> // SoundCloud の埋め込み URL 形式に変換</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> // If apiurl is provided, use it for the iframe source, otherwise use the url</span></span> <span class="giallo-l"><span class="z-storage z-type"> const</span><span class="z-variable z-other z-constant z-ts"> sourceUrl</span><span class="z-keyword z-operator"> =</span><span class="z-variable z-other z-readwrite"> apiurl</span><span class="z-keyword z-operator"> ||</span><span class="z-variable z-other z-readwrite"> url</span><span class="z-punctuation">;</span></span> <span class="giallo-l"><span class="z-storage z-type"> const</span><span class="z-variable z-other z-constant z-ts"> embedUrl</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation z-definition z-string z-string"> `https://w.soundcloud.com/player/?url=</span><span class="z-punctuation">${</span><span class="z-entity z-name z-function">encodeURIComponent</span><span class="z-string">(</span><span class="z-variable z-other z-readwrite">sourceUrl</span><span class="z-string">)</span><span class="z-punctuation">}</span><span class="z-string z-punctuation z-definition z-string">&amp;color=%23ff5500&amp;auto_play=false&amp;hide_related=false&amp;show_comments=true&amp;show_user=true&amp;show_reposts=false&amp;show_teaser=true`</span><span class="z-punctuation">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> // Prepare the display title</span></span> <span class="giallo-l"><span class="z-storage z-type"> const</span><span class="z-variable z-other z-constant z-ts"> displayTitle</span><span class="z-keyword z-operator"> =</span><span class="z-variable z-other z-readwrite"> title</span><span class="z-keyword z-operator"> ?</span><span class="z-punctuation z-definition z-string z-string"> `Yostos - </span><span class="z-punctuation">${</span><span class="z-variable z-other z-readwrite">title</span><span class="z-punctuation">}</span><span class="z-punctuation z-definition z-string">`</span><span class="z-keyword z-operator"> :</span><span class="z-punctuation z-definition z-string z-string"> &quot;Yostos&quot;</span><span class="z-punctuation">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword"> return</span><span class="z-source"> (</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;</span><span class="z-variable z-other z-readwrite">div className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;w-full&quot;</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;</span><span class="z-variable z-parameter">iframe</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> width</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;100%&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> height</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;166&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> scrolling</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;no&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> frameBorder</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;no&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> allow</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;autoplay&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> src</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">{</span><span class="z-variable z-other z-readwrite">embedUrl</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &gt;</span><span class="z-source">&lt;/</span><span class="z-entity z-name z-type">iframe</span><span class="z-source">&gt;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;</span><span class="z-variable z-other z-readwrite">div className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;text-[10px] text-gray-400 overflow-hidden whitespace-nowrap text-ellipsis font-light&quot;</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;</span><span class="z-variable z-parameter">a</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> href</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">{</span><span class="z-variable z-other z-readwrite">url</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> title</span><span class="z-keyword z-operator">=</span><span class="z-punctuation">{</span><span class="z-variable z-other z-readwrite">displayTitle</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> target</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;_blank&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> rel</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;noopener noreferrer&quot;</span></span> <span class="giallo-l"><span class="z-variable z-other z-readwrite"> className</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;text-gray-400 no-underline&quot;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &gt;</span></span> <span class="giallo-l"><span class="z-punctuation"> {</span><span class="z-variable z-parameter">displayTitle</span><span class="z-punctuation">}</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;/</span><span class="z-variable z-other z-readwrite">a</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;/</span><span class="z-variable z-other z-readwrite">div</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator"> &lt;/</span><span class="z-variable z-other z-readwrite">div</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-source"> )</span><span class="z-punctuation">;</span></span> <span class="giallo-l"><span class="z-punctuation">};</span></span></code></pre> <p>API用URLだけ取得はできないので、結局埋め込み用のJavascriptのコードをSoundCloudから取得してURLを取り出して貼り付けることになります。 手間は貼り付けるより面倒なので、コンポーネントにした意味がないかもしれません。</p> 直近数日の内にSoundCloudはAPIの仕様を変更したようです。自作のTypeScriptコンポーネントがうまく機能しなくなったために対応しました。 国税庁の法人番号システムWeb-APIの検証 2025-04-18T00:00:00+00:00 2025-04-18T00:00:00+00:00 Toshiyuki Yoshida https://codedchords.dev/blog/2025/04/company-info-api/ <p>仕事で企業を一意に特定するという要件があり、法人番号制度を利用するために 国税庁が提供する法人番号システムのWeb API の検証のためのコードを作成してみました。</p> <h2 id="法人番号制度とは">法人番号制度とは</h2> <p>法人番号制度は、2015年10月5日に発足しました。 この制度は、行政の効率化、国民の利便性の向上、および公平・公正な社会の実現を 目的として導入されました。法人には13桁の番号が指定され、商号や所在地といった 基本情報とともに国税庁の法人番号公表サイトで公開されています。</p> <p>特に近年では、2023年10月から開始されたインボイス制度（適格請求書等保存方式） との関連で、登録番号（T+法人番号等）を記載した適格請求書の発行が消費税の 仕入税額控除の要件となっているためシステムで扱うことも多くなっています。</p> <h2 id="国税庁のWeb_APIについて">国税庁のWeb APIについて</h2> <p>国税庁が提供するAPIについては、<a rel="external" href="https://www.houjin-bangou.nta.go.jp/webapi/index.html">法人番号システムのWep API</a> のページに利用方法や申し込み方法がガイドされています。</p> <p>利用には国税庁が振り出す「アプリケーションID」を取得する必要があります。 次の２つのアプリケーションIDがあります。</p> <ul> <li>インボイスWeb-APIを利用できるアプリケーションID</li> <li>法人番号システムWeb-APIのみ利用できるアプリケーションID</li> </ul> <p>前者は国税庁の承認を受ける必要がありますが、後者の法人番号システムのAPIにつ いては申請だけでアプリケーションIDを振り出してくれます。ただし、申請してから ２週間から1ヶ月程度かかります。</p> <h2 id="法人情報検索APIクライアント">法人情報検索APIクライアント</h2> <p>Typescriptで検証のためのコードを書いてみました。</p> <p>法人名、または法人番号で検索できます。</p> <p>実行すると、次のような標準出力にレスポンスをそのまま表示します。 (以下の例では、適当に折り返しています)</p> <p><a rel="external" href="https://github.com/yostos/get-company-info">GitHubに公開</a>したので、ビルド方法や詳細な使い方はそちらをご覧ください。 検証用なのでエラー処理はいい加減です。</p> <pre class="giallo z-code"><code data-lang="shellscript"><span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">╰─❯</span><span class="z-string"> npm start -- --type name 任天堂株式会社</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&gt;</span><span class="z-source"> company-info-api@1.0.0 start</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&gt;</span><span class="z-source"> node dist/index.js --type name 任天堂株式会社</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">含まれている日本語：</span><span class="z-string"> 任天堂株式会社</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">日本語を含むか：</span><span class="z-constant z-language z-true"> true</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-operator">&lt;?</span><span class="z-source">xml version</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;1.0&quot;</span><span class="z-source"> encoding</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;UTF-8&quot;?</span><span class="z-source">&gt;&lt;</span><span class="z-string">corporations</span><span class="z-source">&gt;&lt;</span><span class="z-string">lastUpdateDate</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">2025-04-18</span><span class="z-source">&lt;/lastUpdateDate&gt;&lt;count&gt;1&lt;/count&gt;&lt;divideNumber&gt;1&lt;/divideNumber&gt;&lt;di</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">videSize</span><span class="z-source">&gt;</span><span class="z-string">1</span><span class="z-source">&lt;/divideSize&gt;&lt;corporation&gt;&lt;sequenceNumber&gt;1&lt;/sequenceNumber&gt;&lt;corpo</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">rateNumber</span><span class="z-source">&gt;</span><span class="z-string">1130001011420</span><span class="z-source">&lt;/corporateNumber&gt;&lt;process&gt;01&lt;/process&gt;&lt;correct&gt;1&lt;/c</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">orrect</span><span class="z-source">&gt;&lt;updateDate&gt;2018-07-18&lt;/updateDate&gt;&lt;changeDate&gt;2015-10-05&lt;/changeDat</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">e</span><span class="z-source">&gt;&lt;name&gt;任天堂株式会社&lt;/name&gt;&lt;nameImageId/&gt;&lt;kind&gt;301&lt;/kind&gt;&lt;prefectureName&gt;</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">京都府</span><span class="z-source">&lt;/prefectureName&gt;&lt;cityName&gt;京都市南区&lt;/cityName&gt;&lt;streetNumber&gt;上鳥羽鉾</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">立町１１番地１</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&lt;</span><span class="z-source">/streetNumber&gt;&lt;addressImageId/&gt;&lt;prefectureCode</span><span class="z-keyword z-operator">&gt;</span><span class="z-source">2</span><span class="z-keyword z-operator">6&lt;</span><span class="z-source">/prefectureCode&gt;&lt;cityCod</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">e</span><span class="z-source">&gt;</span><span class="z-string">107</span><span class="z-source">&lt;/cityCode&gt;&lt;postCode&gt;6018116&lt;/postCode&gt;&lt;addressOutside/&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&lt;</span><span class="z-source">addressOutsideImageId/&gt;&lt;closeDate/&gt;&lt;closeCause/&gt;&lt;successorCorporateNumber/</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&lt;</span><span class="z-source">changeCause/&gt;&lt;assignmentDate</span><span class="z-keyword z-operator">&gt;</span><span class="z-source">2015-10-</span><span class="z-keyword z-operator">05&lt;</span><span class="z-source">/assignmentDate&gt;&lt;latest</span><span class="z-keyword z-operator">&gt;</span><span class="z-source">1</span><span class="z-keyword z-operator">&lt;</span><span class="z-source">/latest</span><span class="z-keyword z-operator">&gt;</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&lt;</span><span class="z-source">enName/&gt;&lt;enPrefectureName/&gt;&lt;enCityName/&gt;&lt;enAddressOutside/&gt;&lt;furigana</span><span class="z-keyword z-operator">&gt;</span><span class="z-source">ニンテ</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">ンドウ</span><span class="z-source">&lt;/furigana&gt;&lt;hihyoji&gt;0&lt;/hihyoji&gt;&lt;/corporation&gt;&lt;/corporations&gt;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">╰─❯</span><span class="z-string"> npm start -- --format csv --type name 任天堂株式会社</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&gt;</span><span class="z-source"> company-info-api@1.0.0 start</span></span> <span class="giallo-l"><span class="z-keyword z-operator">&gt;</span><span class="z-source"> node dist/index.js --format csv --type name 任天堂株式会社</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">含まれている日本語：</span><span class="z-string"> 任天堂株式会社</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">日本語を含むか：</span><span class="z-constant z-language z-true"> true</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-entity z-name z-function">2025-04-18,1,1,1</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">1,1130001011420,01,1,2018-07-18,2015-10-05,&quot;任天堂株式会社&quot;,,301,&quot;京都府&quot;,&quot;</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">京都市南区&quot;,&quot;上鳥羽鉾立町１１番地１&quot;,</span></span> <span class="giallo-l"><span class="z-entity z-name z-function">,26,107,6018116,,,,,,,2015-10-05,1,,,,,&quot;ニンテンドウ&quot;,0</span></span></code></pre><h2 id="まとめ">まとめ</h2> <p>一応国の仕組みで、一意に法人を特定できるのいろいろ活用できて便利そうです。</p> <p>私が社会人になりたての頃に同じような要件があり、 当時はこういったものがありませんでした。 そのため、名寄せしたり帝国データバンクの企業情報とぶつけたり苦労しました。 国がこんなものを提供してくれるなんて、いい時代だ。</p> <h2 id="2025-04-20_追記">2025-04-20 追記</h2> <p>経済産業省も法人番号で検索できるAPIを公開していたので、対応しました。</p> I had a requirement at work to uniquely identify companies, and to utilize the corporate number system, I created code to verify the Web API of the Corporate Number System provided by the National Tax Agency.