<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Super Lewis</title>
    <description>The latest articles on DEV Community by Super Lewis (@super_lewis).</description>
    <link>https://dev.to/super_lewis</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4064426%2F6d43e7fa-ca92-4bee-82ad-7abc88cee021.jpg</url>
      <title>DEV Community: Super Lewis</title>
      <link>https://dev.to/super_lewis</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/super_lewis"/>
    <language>en</language>
    <item>
      <title>Gemini 4 Neon vs Carbon vs Hydrogen vs Argon: Hydrogen Answers Twice as Fast, Neon Costs the Most</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Thu, 19 Nov 2026 15:11:05 +0000</pubDate>
      <link>https://dev.to/super_lewis/gemini-4-neon-vs-carbon-vs-hydrogen-vs-argon-hydrogen-answers-twice-as-fast-neon-costs-the-most-3664</link>
      <guid>https://dev.to/super_lewis/gemini-4-neon-vs-carbon-vs-hydrogen-vs-argon-hydrogen-answers-twice-as-fast-neon-costs-the-most-3664</guid>
      <description>&lt;p&gt;The short answer: use &lt;a href="https://apimodels.app/models/gemini-4-hydrogen" rel="noopener noreferrer"&gt;Gemini 4 Hydrogen&lt;/a&gt; for agent loops and bulk coding. For answers of 1,500 to 4,000 tokens it took a median 23 seconds on our platform, against 44 for Argon and 49 for Carbon, and at $0.825 / $4.125 per 1M tokens it is the lowest-priced. Use &lt;a href="https://apimodels.app/models/gemini-4-argon" rel="noopener noreferrer"&gt;Gemini 4 Argon&lt;/a&gt; when unsure and &lt;a href="https://apimodels.app/models/gemini-4-carbon" rel="noopener noreferrer"&gt;Gemini 4 Carbon&lt;/a&gt; for the hardest debugging. &lt;a href="https://apimodels.app/models/gemini-4-neon" rel="noopener noreferrer"&gt;Gemini 4 Neon&lt;/a&gt; tops the coding-agent index but, at $2.40 / $12, costs the most of the four; on low thinking it cost half as much in our test.&lt;/p&gt;

&lt;p&gt;In about six weeks Google released four Gemini 4 models: the flagship Argon, announced on 30 September and on the API from 13 October; Carbon, opened to all paid developers on 10 November; Hydrogen on 12 November; and Neon on 18 November. The names are all chemical elements, which tells you nothing about speed or price.&lt;/p&gt;

&lt;p&gt;A word on who we are: we run apimodels.app, a platform where one API key calls the whole Gemini 4 family, Claude, GPT and other image, video, audio and language models. The latency figures come from production calls on that platform over the last 30 days, sample size not disclosed, with our own test accounts removed. Prices were checked on 19 November 2026.&lt;/p&gt;

&lt;p&gt;We will not paste another benchmark table here. This piece answers three practical questions: which one is fast, which one is worth the money, and which job goes to which model. Speed comes from real calls on our platform over the last 30 days. Capability comes from Google's published numbers, labelled as such. Neon has been live for a day, so instead of production data we ran our own six-task test on its thinking levels.&lt;/p&gt;

&lt;h2&gt;
  
  
  The key numbers
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Speed&lt;/strong&gt;: for answers of 1,500 to 4,000 tokens, Gemini 4 Hydrogen's median was 23 seconds, Argon's 44 and Carbon's 49. Most agent steps land in that range, so moving to Hydrogen roughly halves a run.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Price today&lt;/strong&gt;: per 1M tokens, input / output, Hydrogen $0.825 / $4.125, Argon and Carbon $1.10 / $5.50, Neon $2.40 / $12.00. The first three are 45% below Google's list price; Neon is 20% below.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;1 December price change&lt;/strong&gt;: Google doubles its list price for Argon and Carbon, and ours moves to $2.20 / $11.00, still 45% below Google. Hydrogen and Neon do not change.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Neon thinking levels&lt;/strong&gt;: on six graded tasks at current prices, the default high level cost 19.8 cents and low cost 9.6 cents, with all 37 checks passed both times.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What they share&lt;/strong&gt;: all four have a 1M-token context and up to 65,536 output tokens per response.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  How the four differ
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The jobs Google gives them&lt;/strong&gt;: Hydrogen is for fast everyday execution such as writing code, running tests and checking changes. Carbon is for the hardest, longest reasoning. Neon sits between them, aimed at complex coding, analytical reasoning and production enterprise workflows. Argon is the October flagship, and when Google launched Carbon it still recommended Argon for most coding and knowledge work.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Price on APIMODELS (per 1M tokens, input / output)&lt;/strong&gt;: Hydrogen $0.825 / $4.125; Argon and Carbon $1.10 / $5.50, rising to $2.20 / $11.00 on 1 December; Neon $2.40 / $12.00. The first three are 45% below Google's list price; Neon is 20% below.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Thinking levels&lt;/strong&gt;: Neon offers low, medium, high and xhigh, with high as the default. Thinking tokens are billed at the output rate even though you never see them, so the longer a model thinks, the bigger the bill.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Release dates&lt;/strong&gt;: Argon reached the API on 13 October, Carbon on 10 November, Hydrogen on 12 November and Neon on 18 November. The newer the model, the less community experience there is to lean on.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What they share&lt;/strong&gt;: a 1M-token context, up to 65,536 output tokens per response, and on our platform the same key and endpoint. Switching models means changing one model name.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Speed: at the same answer length, Hydrogen is about twice as fast
&lt;/h2&gt;

&lt;p&gt;At the same answer length, Gemini 4 Hydrogen is about twice as fast as Argon and Carbon from 500 to 4,000 tokens; only for answers over 4,000 tokens is Argon the fastest. Averages mislead here. Some people run long agent jobs on Hydrogen while others ask Argon short questions, so answer lengths vary a lot. We split real requests into four groups by answer length and looked at the median and the 90th percentile in each. Neon is too new to include.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F7tgdlcnb3dn3gvbr7ey2.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F7tgdlcnb3dn3gvbr7ey2.webp" alt="Real request latency by answer length for Hydrogen, Argon and Carbon" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The middle two groups belong to Hydrogen. For answers of 500 to 1,500 tokens its median was 15 seconds against 25 for Argon and 30 for Carbon. For 1,500 to 4,000 tokens the gap widens to 23 seconds against 44 and 49, and its 90th percentile was only 49 seconds, so even its slow requests stay reasonable.&lt;/p&gt;

&lt;p&gt;The ends of the chart tell a different story. For short answers under 500 tokens, all three medians sit between 9 and 16 seconds, but Carbon's slowest tenth took more than eight minutes: it can think for a long time before writing a short reply. For answers over 4,000 tokens Argon was actually the fastest, with a 94-second median against 113 for Hydrogen and 137 for Carbon.&lt;/p&gt;

&lt;p&gt;What this means in practice: if your program is an agent that calls the model step after step with a few thousand tokens per step, moving to Hydrogen roughly halves the run. That is how people on our platform use it, too. Hydrogen requests show far more long outputs and cache reuse than the other two, the signature of an agent loop rereading the same codebase. For one long report in a single call, Argon is not slow. Carbon is a poor fit anywhere a person is waiting on screen.&lt;/p&gt;

&lt;h2&gt;
  
  
  Capability: reading Google's own numbers
&lt;/h2&gt;

&lt;p&gt;By Google's published numbers, Gemini 4 Neon ranks first on the Artificial Analysis Coding Agent Index, Hydrogen ties Argon on the composite intelligence index, and Carbon ranks first on CursorBench 4.0 and Perplexity's WANDR. All of these are self-reported by Google, and each model was shown on different tests, so they cannot be ranked side by side. What they do show is the job Google built each one for.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Neon&lt;/strong&gt;: 65.2% on Terminal-Bench 4.1 (Hydrogen: 57%), first on the Artificial Analysis Coding Agent Index, and 61 on the Artificial Analysis Intelligence Index at its highest setting (Hydrogen at the same setting: 54).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hydrogen&lt;/strong&gt;: 51 on the Artificial Analysis Intelligence Index at its default setting, a point above Argon's 50, and 57% on Terminal-Bench 4.1, up from 18.2% for Gemini 3.8 Flash.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Carbon&lt;/strong&gt;: first on CursorBench 4.0 and on Perplexity's WANDR. Google says it spends more tokens exploring and checking its own work, which matches the slow tail in our chart.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Argon&lt;/strong&gt;: 77.9% on DeepSWE v1.1 and 91.7% on the LVBench long-video test.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The standout is Hydrogen. On Google's own composite index it ties Argon, while running about twice as fast and costing a quarter less per token. For most teams the most cost-efficient way to start is to run your own tasks on Hydrogen and send only the ones it gets wrong up a tier.&lt;/p&gt;

&lt;h2&gt;
  
  
  Neon's thinking levels: the default is high, and low saves half
&lt;/h2&gt;

&lt;p&gt;Moving Gemini 4 Neon from its default high thinking level to low cut the cost of our six tasks, at current prices, from 19.8 cents to 9.6 cents, with all 37 checks still passed. On high it will think even before replying "OK". On 19 November we ran six auto-graded tasks at both levels: write an interval-merging function, fix a bug in a parser for durations like "1h 30m 15s", pull the final order out of an email thread as JSON, analyse a table of monthly revenue by region, solve a friction-on-a-slope physics problem, and write a short Chinese product blurb with strict length and format rules. On high, the Chinese writing task alone burned 7,397 thinking tokens.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0m8s8ppy3pycgzcn5w95.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0m8s8ppy3pycgzcn5w95.webp" alt="Gemini 4 Neon default high versus low thinking on six graded tasks" width="800" height="246"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Half the price, yet the total time for all six was about the same: 280 seconds on high, 288 on low. The difference is when the answer starts. Artificial Analysis measured time to first answer token at 40.6 seconds on high and 13.9 seconds on low. Our advice: set Neon to low for everyday coding and raise it only for problems it cannot crack. In the OpenAI-compatible format, setting reasoning_effort to low does it; the top xhigh level is only available through thinkingLevel in Gemini's native format.&lt;/p&gt;

&lt;h2&gt;
  
  
  What one request costs
&lt;/h2&gt;

&lt;p&gt;A typical request that reads 20,000 tokens and writes 1,000, with no cache, costs about 2.1 cents on Gemini 4 Hydrogen, 2.75 cents on Argon or Carbon (5.5 cents from 1 December) and 6 cents on Neon:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzmjrjd4uwgtr32smo3es.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzmjrjd4uwgtr32smo3es.webp" alt="Cost of one typical request on Hydrogen, Argon, Carbon and Neon" width="800" height="278"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The formula is input tokens times the input price plus output tokens times the output price. For Hydrogen that is 20,000 × $0.825 / 1M + 1,000 × $4.125 / 1M, about 2.1 cents. Argon and Carbon come to 2.75 cents, or 5.5 cents from 1 December, and Neon to 6 cents. Per 1,000 such requests: about $20.6 on Hydrogen, $27.5 on Argon or Carbon ($55 from December) and $60 on Neon. Prices as of 20 November 2026.&lt;/p&gt;

&lt;p&gt;Two things push a real bill above this. Thinking tokens are charged at the output rate, and Carbon and Neon on its default high level think the most. Cache hits save money (cached input is $0.04125 per 1M on Hydrogen and $0.12 on Neon), but Google decides when a cache hit happens, so budget as if it will not. Failed requests are not charged.&lt;/p&gt;

&lt;h2&gt;
  
  
  Which one should you use
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Agent loops, bulk code edits, thousands of calls a day&lt;/strong&gt;: Hydrogen. About twice as fast, the lowest price per token, and level with Argon on Google's composite index.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Most coding and knowledge questions, when you are unsure&lt;/strong&gt;: Argon. Google's default recommendation, and on our platform the fastest for very long single answers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Multi-step debugging and open research where a wrong answer is expensive&lt;/strong&gt;: Carbon. Worth it if you can wait and pay for the thinking tokens.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Complex coding, if you want Google's top coding scores&lt;/strong&gt;: Neon. Start it on low and compare it with Hydrogen on your own tasks before moving everything over.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Chat and support where a person watches the screen&lt;/strong&gt;: Hydrogen. Carbon's slow tail and Neon's 40-second first token on high both hurt here.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Budgets after December&lt;/strong&gt;: Argon and Carbon double per token while Hydrogen stays put, so its price lead grows.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The most common setup is Hydrogen as the workhorse, with the small share of requests it gets wrong escalated to Argon or Carbon. The call names are gemini-4-hydrogen, gemini-4-argon, gemini-4-carbon and gemini-4-neon. On APIMODELS they share one API key and one endpoint, so switching is a one-field change; request formats are in the &lt;a href="https://apimodels.app/docs/llm" rel="noopener noreferrer"&gt;LLM docs&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  When to hold off
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Function calling and structured output on Neon&lt;/strong&gt;: we have not tested either on our platform yet. Run your own tool definitions through it before production.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Carbon behind an interactive UI&lt;/strong&gt;: its slowest tenth of requests take minutes, and users will think the app froze.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The cyber-security variant of Neon&lt;/strong&gt;: Google offers it only through its own partner programme. It is not available here.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Related models
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/gemini-3.8-flash" rel="noopener noreferrer"&gt;Gemini 3.8 Flash&lt;/a&gt;: the previous fast model that Hydrogen replaces, $0.45 / $2.25 per 1M tokens.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/claude-fable-5-2" rel="noopener noreferrer"&gt;Claude Fable 5.2&lt;/a&gt;: Anthropic's newest flagship, $4.80 / $24 per 1M tokens.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/gpt-6.2-sol" rel="noopener noreferrer"&gt;GPT-6.2 Sol&lt;/a&gt;: OpenAI's workhorse in this generation, $1.00 / $5.00 per 1M tokens.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/claude-sonnet-5-5" rel="noopener noreferrer"&gt;Claude Sonnet 5.5&lt;/a&gt;: the Claude workhorse many teams code with, $1.20 / $6.00 per 1M tokens.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/qwen4-max" rel="noopener noreferrer"&gt;Qwen4 Max&lt;/a&gt;: Alibaba's flagship, $1.50 / $4.50 per 1M tokens.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For the same workhorse-or-flagship question on the OpenAI side, see our &lt;a href="https://apimodels.app/blog/gpt-6-astra-api-tested" rel="noopener noreferrer"&gt;GPT-6 Astra test&lt;/a&gt;: on the same everyday tasks Astra, at 3.4 times the price, tied the workhorse. The lesson rhymes with this one: use the fast model day to day and bring in the big one for hard jobs.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Which is best: Gemini 4 Neon, Carbon, Hydrogen or Argon?
&lt;/h3&gt;

&lt;p&gt;It depends on the job. Hydrogen is best for agent loops and bulk work: on APIMODELS it answers about twice as fast as Argon at the same length and costs the least. Argon is the safe default, Carbon suits the hardest multi-step reasoning, and Neon has Google's top coding scores but the highest price per token, so trial it first.&lt;/p&gt;

&lt;h3&gt;
  
  
  How much does each Gemini 4 model cost on APIMODELS?
&lt;/h3&gt;

&lt;p&gt;Per 1M tokens, input / output: Hydrogen $0.825 / $4.125, Argon and Carbon $1.10 / $5.50 (from 1 December 2026, $2.20 / $11.00), and Neon $2.40 / $12.00. The first three are 45% below Google's list price and Neon is 20% below. Thinking tokens bill at the output rate, and failed requests are free.&lt;/p&gt;

&lt;h3&gt;
  
  
  How much faster is Gemini 4 Hydrogen than Argon?
&lt;/h3&gt;

&lt;p&gt;In real calls on APIMODELS over the last 30 days, Hydrogen took a median 23 seconds for answers of 1,500 to 4,000 tokens against 44 for Argon, and 15 against 25 seconds for 500 to 1,500 tokens. For answers over 4,000 tokens it flips: Argon's median was 94 seconds and Hydrogen's 113.&lt;/p&gt;

&lt;h3&gt;
  
  
  What thinking level should I use for Gemini 4 Neon?
&lt;/h3&gt;

&lt;p&gt;Start on low. In our six auto-graded tasks on 19 November 2026, at current prices the default high level cost 19.8 cents and low cost 9.6 cents, with all 37 checks passed both times and similar total time. Artificial Analysis measured time to first answer token dropping from 40.6 seconds to 13.9. Raise it only for problems low cannot solve.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can one API key call all four Gemini 4 models?
&lt;/h3&gt;

&lt;p&gt;Yes. On APIMODELS all four use the same API key and endpoint. The call names are gemini-4-hydrogen, gemini-4-argon, gemini-4-carbon and gemini-4-neon, so switching is a change to the model field, and the same key also calls Claude, GPT and image or video models.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;This article was first published on the &lt;a href="https://apimodels.app/blog/gemini-4-neon-vs-carbon-vs-hydrogen" rel="noopener noreferrer"&gt;APIMODELS blog&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>gemini</category>
      <category>api</category>
    </item>
    <item>
      <title>Kling 4.0 vs Seedance 2.5: Kling Followed the Prompt More Closely, Seedance Finished in a Third of the Time</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Thu, 19 Nov 2026 15:09:25 +0000</pubDate>
      <link>https://dev.to/super_lewis/kling-40-vs-seedance-25-kling-followed-the-prompt-more-closely-seedance-finished-in-a-third-of-13o8</link>
      <guid>https://dev.to/super_lewis/kling-40-vs-seedance-25-kling-followed-the-prompt-more-closely-seedance-finished-in-a-third-of-13o8</guid>
      <description>&lt;p&gt;The short answer: pick &lt;a href="https://apimodels.app/models/kling-4.0" rel="noopener noreferrer"&gt;Kling 4.0&lt;/a&gt; when details must match your prompt or you need 1080p; pick &lt;a href="https://apimodels.app/models/seedance-2.5" rel="noopener noreferrer"&gt;Seedance 2.5&lt;/a&gt; for speed, a photographic look or editing existing video. On three identical prompts, Kling tossed the noodles and got the green apron right; Seedance missed both but delivered each clip in about 2.7 minutes, against 5 to 19 for Kling. Both spoke the line word for word. At 720p Kling costs $0.157 per second and Seedance $0.270; Seedance's 480p tier is $0.120.&lt;/p&gt;

&lt;p&gt;Kling 4.0 is Kuaishou's newest Kling video model and Seedance 2.5 is ByteDance's long-form and editing tier. Both add sound and run up to 30 seconds, but they are built for slightly different jobs. Kling 4.0 is one model for text-to-video, multi-reference and keyframe work, and its strength is keeping named characters and voices consistent across clips. Seedance 2.5 leans towards long clips and editing: up to 50 reference assets in one job, plus the ability to edit or extend a video you already have.&lt;/p&gt;

&lt;p&gt;A word on who we are: we run apimodels.app, a platform where one API key calls Kling 4.0, Seedance 2.5 and other image, video, audio and language models. Every clip in this article was generated on that platform on 19 November 2026. The images are unretouched frames from the original videos, and the spoken lines were checked word for word with a speech-to-text model.&lt;/p&gt;

&lt;p&gt;How we tested: three everyday jobs, namely action and camera movement from text, turning a product photo into a short clip, and a person speaking one line to camera. Each pair used word-for-word identical prompts, one run per model, no cherry-picking. To keep costs down each model ran at its lowest setting. Kling 4.0 starts at 720p, so it ran 720p for 3 seconds; Seedance 2.5 ran 480p for 4 seconds, its minimum length. Because the resolutions differ, we do not judge sharpness, only how well each followed the prompt and how the motion and look came out.&lt;/p&gt;

&lt;h2&gt;
  
  
  The three tests at a glance
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Night-market wok&lt;/strong&gt;: Kling 4.0 tossed the noodles out of the wok, very close to the shot we described; Seedance 2.5 made a bigger fire but never showed the toss. 299 seconds against 162.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Product photo to video&lt;/strong&gt;: neither model warped the mug; Seedance 2.5 swept a patch of sunlight across it, while Kling 4.0 moved little beyond the steam, and neither did the orbit the prompt asked for. 1,136 seconds against 161.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Barista speaking to camera&lt;/strong&gt;: both spoke the line word for word and slid the cup forward; only Kling 4.0 got the green apron, while Seedance 2.5 looked more like a real cafe shoot. 395 seconds against 162.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Overall, Kling 4.0 followed details such as actions and colours more closely and looked like a polished ad; Seedance 2.5 was fast and consistent, delivering all three clips in about 2.7 minutes, and looked more like real footage.&lt;/p&gt;

&lt;h2&gt;
  
  
  How the two differ
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Resolution and length&lt;/strong&gt;: Kling 4.0 makes 720p or 1080p clips of 3 to 30 seconds. Seedance 2.5 makes 480p or 720p clips of 4 to 30 seconds, with no 1080p (that stays on Seedance 2.0), and it can pick the length itself.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sound&lt;/strong&gt;: every clip from either model comes with sound: dialogue, effects and ambience.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;References&lt;/strong&gt;: Kling 4.0 takes up to 10 images and 5 videos, and lets you name characters and voices and call them by &lt;a class="mentioned-user" href="https://dev.to/name"&gt;@name&lt;/a&gt; in the prompt. Seedance 2.5 takes up to 50 references per job: 30 images, 10 videos and 10 audio clips.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What only one does&lt;/strong&gt;: Kling has keyframe-to-video with a first frame, up to 8 middle frames and a last frame. Seedance can edit an existing video and extend it forwards or backwards.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Billing&lt;/strong&gt;: Kling bills per second, $0.157 at 720p and $0.235 at 1080p. Seedance bills on real usage converted to seconds, $0.120 at 480p and $0.270 at 720p. Neither charges for failed jobs.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Night-market wok: Kling tossed the noodles, Seedance filmed the fire
&lt;/h2&gt;

&lt;p&gt;On the night-market wok, Kling 4.0 tossed the noodles out of the wok as the prompt asked, while Seedance 2.5 made a bigger fire but no toss. The prompt: a night-market food stall where a vendor tosses noodles in a flaming wok, flames leaping, sparks and steam rising, while the camera slowly pushes in from a medium shot to a close-up of the wok, with the sound of sizzling oil, crackling fire, a clanging spatula and a lively crowd.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fl9gvzwtlvnjt3y5epsov.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fl9gvzwtlvnjt3y5epsov.webp" alt="Same prompt: Kling 4.0 on top, Seedance 2.5 below. Kling tosses the noodles out of the wok; Seedance fills the frame with fire" width="800" height="373"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Both got the setting right, with night, the stall and the flames, and both pushed the camera in. The difference is the toss. Kling opens with a big bundle of noodles flying out of the wok, then pushes in until you see the spatula turning the noodles, very close to the shot we described. Seedance's fire is much bigger and the vendor keeps stirring, with the camera ending inside the flames, but you never see the noodles and the toss never happens.&lt;/p&gt;

&lt;p&gt;There is one small flaw in the background. Kling's red neon signs look like Chinese characters, but up close they do not form real words. On Seedance's yellow sign the lettering is simply a blur. If a sign has to be legible, plan to fix it in post with either model. Kling took 299 seconds for this clip and Seedance 162.&lt;/p&gt;

&lt;h2&gt;
  
  
  Animating a product photo: both kept the mug intact, Seedance moved the sunlight
&lt;/h2&gt;

&lt;p&gt;Turning a product photo into video, neither Kling 4.0 nor Seedance 2.5 warped the mug, and Seedance showed more motion. For this one we first made a product photo with an image model: a matte sage-green ceramic mug with a small embossed leaf, on a light oak table by a window. It became the first frame, with this prompt: steam rises gently from the mug, morning sunlight slowly moves across the table, and the camera orbits slowly to the right, with quiet cafe ambience and birds outside.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1s4p2gchkcj2fxbtcmyw.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1s4p2gchkcj2fxbtcmyw.webp" alt="The first frame: a product photo made with an image model" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fz5zpvzy3of9eds8fzhe1.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fz5zpvzy3of9eds8fzhe1.webp" alt="Same first frame and prompt: Kling 4.0 on top, Seedance 2.5 below" width="800" height="373"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The worst thing in a product clip is a mug that warps or a logo that changes, and both held up: colour, shape and the embossed leaf stay the same throughout, and the steam rises in both. Seedance shows more motion, with a patch of sunlight sweeping across the mug from the left and a slight push-in. Kling barely moves apart from the steam. The prompt asked for an orbit to the right, though, and neither really orbited.&lt;/p&gt;

&lt;p&gt;The soundtracks differ in one way. When we ran the audio through a transcription model, Seedance's clip had people talking in the background, clear enough for a few words to be picked up; Kling's had no voices. The prompt said a quiet cafe, so if you want no speech, say "no voices" outright. The biggest gap here was waiting time: Kling took 1,136 seconds, close to 19 minutes, and Seedance 161.&lt;/p&gt;

&lt;h2&gt;
  
  
  A barista speaks to camera: both got the line exact, only Kling got the apron colour
&lt;/h2&gt;

&lt;p&gt;With a barista speaking to camera, Kling 4.0 and Seedance 2.5 both got the line word for word, but only Kling got the green apron. The prompt: a cheerful young barista in a green apron behind a cafe counter looks straight into the camera and says in English, "Your oat latte is ready, have a great morning!", then slides the paper cup across the counter, with espresso-machine hiss and soft chatter behind.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fvc7r6za6rxtyl1tgviby.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fvc7r6za6rxtyl1tgviby.webp" alt="Same prompt: Kling 4.0 on top, Seedance 2.5 below. Both say the line and slide the cup forward" width="800" height="373"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;This is where the two came closest. Transcribing both soundtracks gave the same word-perfect "Your oat latte is ready. Have a great morning.", the lips move with the words, and both end by pushing the cup towards the camera. Kling's 3 seconds just fit the line; Seedance's 4 left a short pause after it.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjwsxjjicdznbglgtybf2.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjwsxjjicdznbglgtybf2.webp" alt="How the people look: Kling 4.0 on the left, Seedance 2.5 on the right" width="800" height="435"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The differences are detail and style. Kling's barista wears the green apron we asked for over a white shirt, with polished make-up, hair and lighting, like an ad. Seedance's wears a brown apron over a navy T-shirt, missing the word "green", but the skin texture, natural light and shallow depth of field look like a real cafe shoot. For brand work with set colours, Kling is the safer bet; for a casual, filmed-on-the-spot feel, Seedance looks more natural.&lt;/p&gt;

&lt;h2&gt;
  
  
  What only one of them can do
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Kling 4.0&lt;/strong&gt;: 1080p output; named characters and voices called by &lt;a class="mentioned-user" href="https://dev.to/name"&gt;@name&lt;/a&gt;, so the same person and the same voice stay consistent across clips; keyframes, with a first frame, up to 8 middle frames and a last frame; and clips as short as 3 seconds.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Seedance 2.5&lt;/strong&gt;: editing an existing video, replacing, adding or removing things in the frame and editing the audio track; extending a video forwards or backwards over several rounds; up to 50 references in one job, including 10 audio clips; and a lower-cost 480p tier.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What a clip costs and how long it takes
&lt;/h2&gt;

&lt;p&gt;At prices as of 19 November 2026, Kling 4.0 costs $0.157 per second at 720p and $0.235 at 1080p; Seedance 2.5 costs $0.120 per second at 480p and $0.270 at 720p. In this test a 3-second 720p Kling clip cost 47.1 cents, and a 4-second 480p Seedance clip, billed on real usage, cost 48.6 cents.&lt;/p&gt;

&lt;p&gt;For budgeting, 100 five-second clips cost 100 × 5 × $0.157 = $78.5 on Kling at 720p, and 100 × 5 × $0.120 = $60 on Seedance at 480p, or $135 at 720p. At the same 720p, Kling costs about 60% of Seedance per second. Failed jobs are free on both, and jobs with a reference video are billed differently on each, so check the docs for the call name you use.&lt;/p&gt;

&lt;p&gt;Waiting time differs even more. All three Seedance clips arrived within 161 to 162 seconds, very consistent. The Kling clips took 299, 395 and 1,136 seconds, the longest close to 19 minutes. Each scene ran only once, so the sample is small, but if your users wait on screen for results, test this gap on your own jobs first.&lt;/p&gt;

&lt;h2&gt;
  
  
  Which one should you pick
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Colours, props and actions must match the prompt&lt;/strong&gt;: Kling 4.0. Across our three clips it got both the noodle toss and the green apron right.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You need 1080p&lt;/strong&gt;: Kling 4.0; Seedance 2.5 tops out at 720p.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The same character or voice must appear across several clips&lt;/strong&gt;: Kling 4.0, using &lt;a class="mentioned-user" href="https://dev.to/name"&gt;@name&lt;/a&gt; references.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You want a photographic look&lt;/strong&gt;: Seedance 2.5, with more natural skin, light and depth of field.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Fast drafts in bulk&lt;/strong&gt;: Seedance 2.5 at 480p, about 2.7 minutes a clip and $0.120 per second.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Editing or extending a video you already have&lt;/strong&gt;: only Seedance 2.5 does it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A 720p budget&lt;/strong&gt;: Kling 4.0, $0.157 per second against $0.270 for Seedance, about 40% less.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Using both is common: try shots and pacing quickly with Seedance 2.5 at 480p, then render the final in Kling 4.0 at 1080p, or extend it into a longer piece with Seedance 2.5. The call names are kling-4.0 and seedance-2.5, on the same API key and the same video endpoint; parameters are in the &lt;a href="https://apimodels.app/docs/kling-4-0" rel="noopener noreferrer"&gt;Kling 4.0 docs&lt;/a&gt; and the &lt;a href="https://apimodels.app/docs/seedance-2-5" rel="noopener noreferrer"&gt;Seedance 2.5 docs&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Related models
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/kling-4.0-flash" rel="noopener noreferrer"&gt;Kling 4.0 Flash&lt;/a&gt;: the lighter Kling 4.0 tier, 720p, 3 to 20 seconds, $0.094 per second.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/seedance-2.5-flash" rel="noopener noreferrer"&gt;Seedance 2.5 Flash&lt;/a&gt;: the faster Seedance 2.5 tier, from $0.091 per second.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/seedance-2.0" rel="noopener noreferrer"&gt;Seedance 2.0&lt;/a&gt;: the Seedance to use when you need 1080p, from $0.092 per second.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/wan-3.0-video" rel="noopener noreferrer"&gt;Wan 3.0&lt;/a&gt;: Alibaba's video model, from $0.045 per second.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://apimodels.app/models/kling-v3" rel="noopener noreferrer"&gt;Kling V3&lt;/a&gt;: the previous Kling generation, from $0.12 per second.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For a full test of another video model, see our &lt;a href="https://apimodels.app/blog/wan-3-0-api-tested" rel="noopener noreferrer"&gt;Wan 3.0 test&lt;/a&gt;: word-perfect Chinese dialogue, the most accurate first and last frames, and a fast tier that turned out slower than the standard one.&lt;/p&gt;

&lt;h2&gt;
  
  
  FAQ
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Which is better, Kling 4.0 or Seedance 2.5?
&lt;/h3&gt;

&lt;p&gt;It depends on the job. In our three identical tests Kling 4.0 followed the prompt more closely, getting the noodle toss and green apron right, and it offers 1080p. Seedance 2.5 looked more like real footage, delivered each clip in about 2.7 minutes and can edit or extend existing video. Both spoke the line word for word.&lt;/p&gt;

&lt;h3&gt;
  
  
  How much do Kling 4.0 and Seedance 2.5 cost?
&lt;/h3&gt;

&lt;p&gt;On APIMODELS, Kling 4.0 costs $0.157 per second at 720p and $0.235 at 1080p; Seedance 2.5 costs $0.120 per second at 480p and $0.270 at 720p, as of 19 November 2026. A 5-second 720p clip is 78.5 cents on Kling and $1.35 on Seedance. Failed jobs are not charged.&lt;/p&gt;

&lt;h3&gt;
  
  
  Which is faster, Kling 4.0 or Seedance 2.5?
&lt;/h3&gt;

&lt;p&gt;Seedance 2.5 was faster in our test: all three clips arrived in 161 to 162 seconds. Kling 4.0 took 299, 395 and 1,136 seconds. Each scene ran once, so test with your own jobs too.&lt;/p&gt;

&lt;h3&gt;
  
  
  Which one can edit or extend an existing video?
&lt;/h3&gt;

&lt;p&gt;Seedance 2.5 can: it replaces, adds or removes things in the frame, edits the audio track, and extends a clip forwards or backwards over several rounds. Kling 4.0 does not edit video, but it supports keyframe-to-video and fixed characters and voices called by &lt;a class="mentioned-user" href="https://dev.to/name"&gt;@name&lt;/a&gt;.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can one API key call both Kling 4.0 and Seedance 2.5?
&lt;/h3&gt;

&lt;p&gt;Yes. On APIMODELS both models use the same API key and video endpoint, with the call names kling-4.0 and seedance-2.5, and you do not need a Kuaishou or ByteDance account.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;This article was first published on the &lt;a href="https://apimodels.app/blog/kling-4-0-vs-seedance-2-5" rel="noopener noreferrer"&gt;APIMODELS blog&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>video</category>
      <category>api</category>
      <category>machinelearning</category>
    </item>
    <item>
      <title>Cost per task, not per token: a Python calculator for Qwen 4 Max vs GPT-6 Sol, including the 272K-token price step</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Tue, 17 Nov 2026 12:06:38 +0000</pubDate>
      <link>https://dev.to/super_lewis/cost-per-task-not-per-token-a-python-calculator-for-qwen-4-max-vs-gpt-6-sol-including-the-1lmn</link>
      <guid>https://dev.to/super_lewis/cost-per-task-not-per-token-a-python-calculator-for-qwen-4-max-vs-gpt-6-sol-including-the-1lmn</guid>
      <description>&lt;p&gt;Price per token is a poor guide to what a language model costs you. Qwen 4 Max lists below GPT-6 Sol on every line, yet cost more than twice as much on my seven test tasks, because it emits about five times the output tokens. Past 272,000 input tokens the result reverses. This post gives a calculator that handles both effects.&lt;/p&gt;

&lt;p&gt;Disclosure: the measurements come from apimodels.app, which is the API I work on. apimodels.app is a multi-model API gateway: one key and one OpenAI-compatible endpoint for image, video, audio and language models. I wrote this from my own test data, with AI assistance for drafting and editing.&lt;/p&gt;

&lt;h2&gt;
  
  
  The pricing rules
&lt;/h2&gt;

&lt;p&gt;List prices per million tokens, checked on November 17, 2026:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Qwen 4 Max: $1.50 input, $4.50 output, flat across a one-million-token context&lt;/li&gt;
&lt;li&gt;GPT-6 Sol: $2 input, $10 output. Above 272,000 tokens the whole request is billed at $4 input and $15 output&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The step applies to the entire request, not just the overflow. Going from 270K to 280K input tokens reprices everything.&lt;/p&gt;

&lt;h2&gt;
  
  
  The calculator
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;qwen4_max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;inp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;out&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;inp&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;1.50&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;out&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;4.50&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1_000_000&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;gpt6_sol&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;inp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;out&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;p_in&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;4.00&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;15.00&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;inp&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;272_000&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;2.00&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;10.00&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;inp&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_in&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;out&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1_000_000&lt;/span&gt;

&lt;span class="n"&gt;cases&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;  &lt;span class="c1"&gt;# name, input tokens, Qwen output, Sol output&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"short request"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;10_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;3_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;600&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"mid-size document"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;200_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;5_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1_000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"very long document"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;300_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;5_000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1_000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;inp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;out_q&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;out_s&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;cases&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"{name}: qwen4-max ${qwen4_max(inp, out_q):.4f}  "&lt;/span&gt;
          &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"gpt-6-sol ${gpt6_sol(inp, out_s):.4f}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Output:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;short request: qwen4-max $0.0285  gpt-6-sol $0.0260
mid-size document: qwen4-max $0.3225  gpt-6-sol $0.4100
very long document: qwen4-max $0.4725  gpt-6-sol $1.2150
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Why the output counts differ per model
&lt;/h2&gt;

&lt;p&gt;The two models do not spend the same number of tokens on the same task, so the calculator takes a separate output figure for each.&lt;/p&gt;

&lt;p&gt;On seven graded tasks (93 programmatic checks, all passed by both), Qwen 4 Max emitted about 22,100 output tokens and GPT-6 Sol about 4,350. On one set of counting puzzles Qwen 4 Max wrote 10,801 tokens, 10,777 of them thinking, while GPT-6 Sol wrote under 800. Thinking is billed as output.&lt;/p&gt;

&lt;p&gt;Total for the seven tasks at the platform's posted rates: about $0.21 for Qwen 4 Max and about $0.09 for GPT-6 Sol. Total time was 415 seconds against 189.&lt;/p&gt;

&lt;p&gt;To size your own workload, run a small batch on each model and feed the real &lt;code&gt;completion_tokens&lt;/code&gt; into the calculator:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;measure&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;stream&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stream_options&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"include_usage"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;prompt_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Three rules of thumb
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Short input, output-heavy work: output volume dominates, so GPT-6 Sol usually costs less and answers sooner.&lt;/li&gt;
&lt;li&gt;Long input, short answers: the input rate dominates and Qwen 4 Max pulls ahead. Past 272K the gap is more than double.&lt;/li&gt;
&lt;li&gt;Bulk work with no reasoning: Qwen 4 Max lets you turn thinking off per request, which leaves only the answer in the output. Check accuracy again afterwards. My results were measured with thinking on.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When the bill disagrees with the estimate
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Confirm you are reading real usage. Streams need &lt;code&gt;stream_options={"include_usage": True}&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Check whether the input crossed 272K. Conversation history accumulates, and turn N can cross the line without anyone noticing.&lt;/li&gt;
&lt;li&gt;Look at &lt;code&gt;completion_tokens&lt;/code&gt;, not the length of the answer. Thinking tokens are invisible in the reply and still billed.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When this comparison does not apply
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;You are not paying list price. Replace the rates with your own.&lt;/li&gt;
&lt;li&gt;Latency matters more than cost. Artificial Analysis measures GPT-6 Sol at 125 output tokens per second. Published figures for Qwen 4 Max range from 30 to 53.&lt;/li&gt;
&lt;li&gt;Long, difficult tasks. Mine were everyday difficulty and ran once each.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The full comparison, including GPT-6.1 Sol and the benchmark sources, is on the &lt;a href="https://apimodels.app/qwen-4-max-vs-gpt-6-sol" rel="noopener noreferrer"&gt;Qwen 4 Max vs GPT-6 Sol page at apimodels.app&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>python</category>
      <category>openai</category>
    </item>
    <item>
      <title>Don't let the model do date math: a refund-agent test where Gemini 4 Carbon broke a 30-day rule and Qwen 4 Max held it</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Tue, 17 Nov 2026 12:05:13 +0000</pubDate>
      <link>https://dev.to/super_lewis/dont-let-the-model-do-date-math-a-refund-agent-test-where-gemini-4-carbon-broke-a-30-day-rule-and-in8</link>
      <guid>https://dev.to/super_lewis/dont-let-the-model-do-date-math-a-refund-agent-test-where-gemini-4-carbon-broke-a-30-day-rule-and-in8</guid>
      <description>&lt;p&gt;A tool-calling agent that reads a policy correctly can still apply it wrongly. In my test, Gemini 4 Carbon fetched a 30-day return policy, then refunded an order delivered 46 days earlier, three runs out of three. Qwen 4 Max refused it three out of three. This post shows the test, the grader, and the validation that makes the question matter much less.&lt;/p&gt;

&lt;p&gt;Disclosure: I ran this on apimodels.app, which is the API I work on. apimodels.app is a multi-model API gateway: one key and one OpenAI-compatible endpoint for image, video, audio and language models, including both models here. I wrote this from my own test data, with AI assistance for drafting and editing.&lt;/p&gt;

&lt;h2&gt;
  
  
  The task
&lt;/h2&gt;

&lt;p&gt;The customer says the space bar on their keyboard is broken and asks for a refund. They also want to return one of two mice from the same order because they do not like it.&lt;/p&gt;

&lt;p&gt;Four tools, in the standard function-calling format:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;tools&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"get_order"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"description"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Look up an order by id."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"parameters"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"object"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="s2"&gt;"properties"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"required"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"get_refund_policy"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"description"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Return the current refund policy text."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"parameters"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"object"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"properties"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"issue_refund"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"description"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Refund one line item of an order."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"parameters"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"object"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"properties"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"sku"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="s2"&gt;"amount"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"number"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"reason"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="s2"&gt;"required"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"sku"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"amount"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"reason"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"function"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="s2"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"escalate_to_human"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"description"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Hand the case to a human agent."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s2"&gt;"parameters"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"object"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"properties"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"summary"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"type"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"string"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="s2"&gt;"required"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"summary"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The tools return fixed data. The order was delivered on October 2: one keyboard at $129, two mice at $39 each, $12 shipping. The policy says today is November 17, no-reason returns close 30 days after delivery, defective items can come back within 90 days, shipping is refunded only with a full-order return, and any single refund over $150 goes to a human.&lt;/p&gt;

&lt;p&gt;One outcome is correct: refund the keyboard for $129.00, refuse the mouse, escalate nothing.&lt;/p&gt;

&lt;h2&gt;
  
  
  The grader
&lt;/h2&gt;

&lt;p&gt;Seven checks, all on tool calls and arguments, none on wording except the last:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;get_order&lt;/code&gt; was called&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;get_refund_policy&lt;/code&gt; was called&lt;/li&gt;
&lt;li&gt;the keyboard was refunded exactly once&lt;/li&gt;
&lt;li&gt;the amount was 129.00, with no shipping added&lt;/li&gt;
&lt;li&gt;no refund was issued for the mouse&lt;/li&gt;
&lt;li&gt;nothing was escalated&lt;/li&gt;
&lt;li&gt;the final message tells the customer why the mouse was refused&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The loop is the usual one: execute each returned tool call, append the result as a &lt;code&gt;tool&lt;/code&gt; message, repeat until the model stops calling tools.&lt;/p&gt;

&lt;h2&gt;
  
  
  Results
&lt;/h2&gt;

&lt;p&gt;Qwen 4 Max: 7 of 7, three runs out of three, about 15 seconds each. Its reply noted that the no-reason window ended on November 1.&lt;/p&gt;

&lt;p&gt;Gemini 4 Carbon: 6 of 7, three runs out of three. It called both lookups, then refunded the keyboard and the mouse, and told the customer the mouse was within 30 days of the October 2 delivery.&lt;/p&gt;

&lt;p&gt;Across the full seven-task run this came from (93 checks), Qwen 4 Max passed 93 and Carbon passed 89. Carbon also miscounted in a log-analysis task and overran a character limit by one.&lt;/p&gt;

&lt;p&gt;For balance: public benchmarks favour Carbon clearly, 60 against 43 on the Artificial Analysis Intelligence Index, and it accepts audio and PDF input, which Qwen 4 Max does not. Benchmarks measure reach on hard problems. This test measures exact application of an easy rule. They are different skills.&lt;/p&gt;

&lt;h2&gt;
  
  
  Put the rule in the tool
&lt;/h2&gt;

&lt;p&gt;The practical lesson holds for any model. The model should work out what the customer wants, and the code should decide dates and amounts.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;datetime&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;date&lt;/span&gt;

&lt;span class="no"&gt;WINDOWS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"defective"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;90&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"no_reason"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;issue_refund&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;order&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sku&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;amount&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;today&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;date&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;reason&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="no"&gt;WINDOWS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"status"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rejected"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"error"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"reason must be defective or no_reason"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="n"&gt;item&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;next&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;order&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"items"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"sku"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;sku&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;days&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;today&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;order&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"delivered_at"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;days&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;days&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="no"&gt;WINDOWS&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"status"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rejected"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="s2"&gt;"error"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"outside the {WINDOWS[reason]}-day window "&lt;/span&gt;
                         &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"({days} days since delivery)"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;amount&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;item&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"unit_price"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"status"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rejected"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"error"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"amount exceeds the item price"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;amount&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;150&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"status"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"rejected"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"error"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"over the limit, escalate to a human"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nf"&gt;do_refund&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;order&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"order_id"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sku&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;amount&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;With this in place, a wrong judgment becomes a rejected call with a readable error, and the model usually corrects its reply. Make &lt;code&gt;reason&lt;/code&gt; an enum in the tool schema as well. With free text, the model can talk its way past the check.&lt;/p&gt;

&lt;h2&gt;
  
  
  When not to lean on this result
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Hard research or multi-step debugging: Carbon leads on public benchmarks.&lt;/li&gt;
&lt;li&gt;Audio or PDF input: only Carbon supports it.&lt;/li&gt;
&lt;li&gt;Small sample: the refund task ran three times, the other six once each.&lt;/li&gt;
&lt;li&gt;Pricing changes: Carbon moves from $2 and $10 per million tokens to $4 and $20 on December 1. Qwen 4 Max is $1.50 and $4.50.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The full comparison is on the &lt;a href="https://apimodels.app/qwen-4-max-vs-gemini-4-carbon" rel="noopener noreferrer"&gt;Qwen 4 Max vs Gemini 4 Carbon page at apimodels.app&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>agents</category>
      <category>python</category>
    </item>
    <item>
      <title>A/B test two LLMs with one Python script: Qwen 4 Max vs Claude Opus 5.5 on score, latency, tokens and cost</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Tue, 17 Nov 2026 12:04:10 +0000</pubDate>
      <link>https://dev.to/super_lewis/ab-test-two-llms-with-one-python-script-qwen-4-max-vs-claude-opus-55-on-score-latency-tokens-4d8o</link>
      <guid>https://dev.to/super_lewis/ab-test-two-llms-with-one-python-script-qwen-4-max-vs-claude-opus-55-on-score-latency-tokens-4d8o</guid>
      <description>&lt;p&gt;Comparing two language models fairly takes four numbers per request: time to first token, total time, output tokens and cost. This post gives a small script that collects them through one OpenAI-compatible client, plus what it showed for Qwen 4 Max and Claude Opus 5.5. Short answer: they tied on correctness for everyday tasks, Qwen 4 Max cost about a third as much, and public data favours Opus 5.5 once the work gets large.&lt;/p&gt;

&lt;p&gt;Disclosure: I ran this on apimodels.app, which is the API I work on. apimodels.app is a multi-model API gateway: one key and one OpenAI-compatible endpoint for image, video, audio and language models, which is why one client can reach both models. I wrote this from my own test data, with AI assistance for drafting and editing.&lt;/p&gt;

&lt;h2&gt;
  
  
  The script
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;
&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;openai&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;OpenAI&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;OpenAI&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;api_key&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"LLM_API_KEY"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="n"&gt;base_url&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"LLM_BASE_URL"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;timeout&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;900&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# List prices, USD per million tokens: (input, output)&lt;/span&gt;
&lt;span class="no"&gt;PRICE&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"qwen4-max"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;1.50&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;4.50&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"claude-opus-5-5"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;4.00&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;20.00&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;t0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;first&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;
    &lt;span class="n"&gt;stream&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;20000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;stream_options&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"include_usage"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="n"&gt;first&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;first&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;t0&lt;/span&gt;
            &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;p_in&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="no"&gt;PRICE&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="n"&gt;cost&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;prompt_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_in&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;1e6&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"answer"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s2"&gt;"first_token_s"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;first&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s2"&gt;"total_s"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;t0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s2"&gt;"output_tokens"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s2"&gt;"cost_usd"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;cost&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;prompts&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"prompts.txt"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;encoding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"utf-8"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"\n---\n"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;prompts&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;model&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="no"&gt;PRICE&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;r&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"model"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"first_token_s"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"total_s"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
              &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"output_tokens"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"cost_usd"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The script only collects. Grade correctness separately, with code: hidden test cases, assertions, or a comparison against a known answer. Reading an answer and deciding it looks right is how weak models pass evaluations.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I ran
&lt;/h2&gt;

&lt;p&gt;Seven tasks with 93 programmatic checks between them: a timeline-merging function against 50 hidden cases, a cache class with five planted bugs, a refund agent with tools and a policy, five exact questions over 1,500 log lines, a Chinese group chat converted to JSON, three counting puzzles that can be verified by enumeration, and Chinese product copy under five hard constraints. Both models on default thinking, each task once, on November 17, 2026.&lt;/p&gt;

&lt;h2&gt;
  
  
  Results
&lt;/h2&gt;

&lt;p&gt;Both models passed all 93 checks.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Total time: Qwen 4 Max 415 s, Opus 5.5 341 s&lt;/li&gt;
&lt;li&gt;Time to first token, puzzles excluded: Qwen 4 Max 15 to 62 s, Opus 5.5 8 to 26 s&lt;/li&gt;
&lt;li&gt;Output tokens including thinking: Qwen 4 Max about 22,100, Opus 5.5 about 37,700&lt;/li&gt;
&lt;li&gt;Cost at the platform's posted rates: about $0.21 against about $0.64&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;One thing to watch: on the puzzles Opus 5.5 used the whole 20,000-token output cap. Leave headroom in &lt;code&gt;max_tokens&lt;/code&gt; for thinking models, or the answer can be cut off before it starts.&lt;/p&gt;

&lt;h2&gt;
  
  
  API differences worth knowing
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Thinking: Qwen 4 Max lets you turn it off per request. Opus 5.5 does not, but you can lower its effort level from the default of medium.&lt;/li&gt;
&lt;li&gt;Input: Qwen 4 Max takes text, images and video. Opus 5.5 takes text and images.&lt;/li&gt;
&lt;li&gt;Context: one million tokens on both, with no long-prompt surcharge.&lt;/li&gt;
&lt;li&gt;Cached input, list price per million: $0.075 for Qwen 4 Max, $0.20 for Opus 5.5. In agent sessions that resend a long context, caching narrows the real gap.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What seven easy tasks cannot show
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;In Alibaba's sixteen-benchmark launch comparison, Qwen 4 Max leads six and Opus 5.5 leads ten. ProgramBench is 31.5 against 65.0 and Terminal-Bench 4.0 is 48.5 against 59.6. Qwen 4 Max leads the legal agent benchmark HLAB, 21.3 against 9.2.&lt;/li&gt;
&lt;li&gt;Kingy AI ran eight real GitHub issues twice each: 11 solved for Opus 5.5 and 9 for Qwen 4 Max, with median active time of 86 seconds against 431.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Picking one
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Single functions, bug fixes, structured extraction, rule-bound tool calls: either, and Qwen 4 Max costs about a third.&lt;/li&gt;
&lt;li&gt;Multi-file refactors, terminal agents, long coding sessions: Claude Opus 5.5.&lt;/li&gt;
&lt;li&gt;Legal or contract work, or video input: try Qwen 4 Max first.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When this result does not apply
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Hard, long tasks. Swap your own tasks into the script and measure.&lt;/li&gt;
&lt;li&gt;Escalation routing. Sending everything to the lower-cost model first and retrying failures on Opus 5.5 cost 2.8 times as much as Opus 5.5 alone in Kingy AI's test.&lt;/li&gt;
&lt;li&gt;Chinese-language quality. Both models got full marks on my two Chinese tasks, which is too few to draw on.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Benchmark tables and sources are on the &lt;a href="https://apimodels.app/qwen-4-max-vs-claude-opus-5-5" rel="noopener noreferrer"&gt;Qwen 4 Max vs Claude Opus 5.5 comparison page at apimodels.app&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>python</category>
      <category>testing</category>
    </item>
    <item>
      <title>Calling Qwen 4 Max from Python: streaming, real token usage, cost per request, and why it times out</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Tue, 17 Nov 2026 12:03:00 +0000</pubDate>
      <link>https://dev.to/super_lewis/calling-qwen-4-max-from-python-streaming-real-token-usage-cost-per-request-and-why-it-times-out-4gfe</link>
      <guid>https://dev.to/super_lewis/calling-qwen-4-max-from-python-streaming-real-token-usage-cost-per-request-and-why-it-times-out-4gfe</guid>
      <description>&lt;p&gt;Qwen 4 Max is Alibaba's flagship language model (model ID &lt;code&gt;qwen4-max&lt;/code&gt;): a one-million-token context, text, image and video input, and thinking switched on by default. This tutorial shows how to call it with the OpenAI SDK, read real token usage from a stream, estimate what a request costs, and avoid the timeout most people hit first.&lt;/p&gt;

&lt;p&gt;Disclosure: the measurements below come from apimodels.app, which is the API I work on. apimodels.app is a multi-model API gateway: one key and one OpenAI-compatible endpoint for image, video, audio and language models. The code works against any OpenAI-compatible endpoint that serves &lt;code&gt;qwen4-max&lt;/code&gt;. I wrote this from my own test data, with AI assistance for drafting and editing.&lt;/p&gt;

&lt;h2&gt;
  
  
  Setup
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Python 3.10+&lt;/li&gt;
&lt;li&gt;&lt;code&gt;pip install openai&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;LLM_API_KEY&lt;/code&gt; and &lt;code&gt;LLM_BASE_URL&lt;/code&gt; in your environment (the base URL ends in &lt;code&gt;/v1&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;Verified on November 17, 2026&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Stream everything
&lt;/h2&gt;

&lt;p&gt;Qwen 4 Max finishes thinking before it writes. A non-streaming request sends nothing down the connection while that happens, and a proxy with a 60-second idle timeout will cut it. Stream, and give the client a generous timeout.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;
&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;openai&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;OpenAI&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;OpenAI&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;api_key&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"LLM_API_KEY"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;base_url&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"LLM_BASE_URL"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;timeout&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;600&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;ask&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;20000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;t0&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;first_token_at&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;
    &lt;span class="n"&gt;parts&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;
    &lt;span class="n"&gt;stream&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;chat&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completions&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"qwen4-max"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"role"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"user"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;max_tokens&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;stream_options&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"include_usage"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;stream&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;                 &lt;span class="c1"&gt;# the final chunk carries usage&lt;/span&gt;
            &lt;span class="n"&gt;usage&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;first_token_at&lt;/span&gt; &lt;span class="k"&gt;is&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
                &lt;span class="n"&gt;first_token_at&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;t0&lt;/span&gt;
            &lt;span class="n"&gt;parts&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;choices&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;parts&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;first_token_at&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;t0&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two details that bite:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Without &lt;code&gt;stream_options={"include_usage": True}&lt;/code&gt; a stream carries no usage at all.&lt;/li&gt;
&lt;li&gt;The chunk that carries usage has an empty &lt;code&gt;choices&lt;/code&gt; list, so check &lt;code&gt;chunk.choices&lt;/code&gt; before indexing it.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Read the usage
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;completion_tokens&lt;/code&gt; already includes thinking tokens. If the endpoint returns the detail field, you can split them:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;split_output&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;details&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"completion_tokens_details"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;thinking&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;details&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"reasoning_tokens"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;details&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;thinking&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;thinking&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The widest split I saw: 10,777 thinking tokens for a 24-token answer, on a set of counting puzzles.&lt;/p&gt;

&lt;h2&gt;
  
  
  Estimate the cost
&lt;/h2&gt;

&lt;p&gt;List prices per million tokens: $1.50 input, $4.50 output, $0.075 for cached input. Thinking is billed as output.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;cost_usd&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p_in&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mf"&gt;1.50&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mf"&gt;4.50&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p_cached&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mf"&gt;0.075&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;details&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"prompt_tokens_details"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;None&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;cached&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;getattr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;details&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"cached_tokens"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;details&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
    &lt;span class="n"&gt;fresh&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;prompt_tokens&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;cached&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;fresh&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_in&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;cached&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_cached&lt;/span&gt;
            &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;completion_tokens&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p_out&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1_000_000&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Reference points from seven graded tasks, thinking on:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Chat log to JSON: 19 s, about $0.004&lt;/li&gt;
&lt;li&gt;Fix a cache class with five bugs: 27 s, about $0.009&lt;/li&gt;
&lt;li&gt;Write a function against 50 hidden tests: 51 s, about $0.012&lt;/li&gt;
&lt;li&gt;Five questions over about 57K tokens of logs: 63 s, about $0.120&lt;/li&gt;
&lt;li&gt;Three counting puzzles: 196 s, about $0.049&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;All 93 programmatic checks across the seven tasks passed, in 415 seconds and about $0.21 in total.&lt;/p&gt;

&lt;h2&gt;
  
  
  Troubleshooting
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;The request dies at around 60 seconds with no output.&lt;/strong&gt; A non-streaming call hit an idle timeout. Switch to streaming and raise the client timeout. Time to first token was 15 to 62 seconds on most tasks and 196 seconds on the puzzles.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The bill is higher than you estimated.&lt;/strong&gt; Print &lt;code&gt;completion_tokens&lt;/code&gt;. Most of it is thinking, billed at $4.50 per million. For work that needs no multi-step reasoning, turn thinking off for that request, then check accuracy again.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;No usage in the stream.&lt;/strong&gt; You either left out &lt;code&gt;stream_options&lt;/code&gt; or skipped the final chunk because its &lt;code&gt;choices&lt;/code&gt; list was empty.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Invented details in generated copy.&lt;/strong&gt; In my test it added a product weight and a charging time I never supplied. Put the real specs in the prompt and tell it to use only those.&lt;/p&gt;

&lt;h2&gt;
  
  
  When not to use Qwen 4 Max
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;A person is waiting on the reply and you cannot turn thinking off.&lt;/li&gt;
&lt;li&gt;Repository-scale coding or long terminal-agent sessions. Alibaba's own launch comparison shows it behind higher-priced models there.&lt;/li&gt;
&lt;li&gt;You need to send audio or PDF files directly. It accepts text, images and video.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The full review, with third-party benchmarks and a same-prompt comparison against three other models, is on the &lt;a href="https://apimodels.app/qwen-4-max-review" rel="noopener noreferrer"&gt;Qwen 4 Max review page at apimodels.app&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>python</category>
      <category>tutorial</category>
    </item>
    <item>
      <title>Animated GIFs and markup-guided edits with the GPT Image 2.6 API — real timings and per-call cost</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Thu, 05 Nov 2026 11:33:10 +0000</pubDate>
      <link>https://dev.to/super_lewis/animated-gifs-and-markup-guided-edits-with-the-gpt-image-26-api-real-timings-and-per-call-cost-2jmd</link>
      <guid>https://dev.to/super_lewis/animated-gifs-and-markup-guided-edits-with-the-gpt-image-26-api-real-timings-and-per-call-cost-2jmd</guid>
      <description>&lt;p&gt;&lt;strong&gt;Short answer:&lt;/strong&gt; the GPT Image 2.6 API can make animated GIFs and follow a hand-drawn markup layer, but GIFs have a catch. Every frame is drawn on one sheet whose long edge must be 3840 px or less and whose area must stay within 8,294,400 pixels, so six 1024×1024 frames are rejected while six at 832×832 worked in 25 seconds for $0.0309. A red-circle markup edit swapped two jars for a plant without painting the circle in, and SVG export, which failed on launch day, now works.&lt;/p&gt;

&lt;p&gt;Our first GPT Image 2.6 GIF request asked for six frames at 1024×1024 and was rejected before a single frame was drawn. The prompt was fine. The model lays every frame out on one sheet, and that sheet would have been 4096 px on its long side, 256 px over the limit.&lt;/p&gt;

&lt;p&gt;GPT Image 2.6 is OpenAI's November 2026 image model for ChatGPT, Codex and the API, offered to developers in two tiers: GPT-Image-2.6 Flare for speed and everyday work, and GPT-Image-2.6 Sunburst for quality, detail and consistency across edits. This tutorial uses its API to make a six-frame animated GIF, size the frames so the request is accepted, guide an edit with a markup layer, run a second edit round, and read what each call cost, with the timings from our launch-day runs and what each call comes to at today's prices.&lt;/p&gt;

&lt;p&gt;Disclosure: I work on apimodels.app, the API platform used for every test below. apimodels.app is a multi-model API gateway: one API key and one endpoint for 160 image, video, audio and language models. We ran all seven tests on its production API on 5 November 2026, the day GPT Image 2.6 went live there. An AI assistant helped turn our test notes into this post; every timing and cost comes from the requests themselves.&lt;/p&gt;

&lt;h2&gt;
  
  
  What OpenAI announced
&lt;/h2&gt;

&lt;p&gt;OpenAI's claims for Images 2.6, from &lt;a href="https://openai.com/index/introducing-images-2-6/" rel="noopener noreferrer"&gt;OpenAI's Images 2.6 announcement&lt;/a&gt;, are about 50% faster generation, text-to-GIF, steadier multi-round edits of people, products and brand details, ChatGPT's image markup in the API, SVG export, and a new setting OpenAI calls "complexity" that controls how much the model plans the scene before drawing. OpenAI says Flare can return an image in about 6 seconds at low quality. The timings in this post are what our own requests took on launch day and in a re-test that evening; they are not a benchmark of OpenAI's figure.&lt;/p&gt;

&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Node.js 18 or later (built-in &lt;code&gt;fetch&lt;/code&gt;), or just &lt;code&gt;curl&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;sharp&lt;/code&gt; for drawing the markup layer in Step 3: &lt;code&gt;npm install sharp&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;An apimodels.app API key in the &lt;code&gt;APIMODELS_API_KEY&lt;/code&gt; environment variable&lt;/li&gt;
&lt;li&gt;A place to host input images at a public URL (every &lt;code&gt;example.com&lt;/code&gt; URL below is a placeholder)&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  How a request works: submit, then poll
&lt;/h2&gt;

&lt;p&gt;GPT Image 2.6 requests on apimodels.app are asynchronous: you submit a job, get a task id, and poll until it finishes. &lt;code&gt;POST https://api.apimodels.app/v1/images/generations&lt;/code&gt; returns &lt;code&gt;{ data: { taskId } }&lt;/code&gt;. You then &lt;code&gt;GET&lt;/code&gt; the same path with &lt;code&gt;?task_id=...&lt;/code&gt; until &lt;code&gt;data.state&lt;/code&gt; is &lt;code&gt;"completed"&lt;/code&gt;, and read the files from &lt;code&gt;data.resultUrls&lt;/code&gt; and the charge from &lt;code&gt;data.credits&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;These are the parameters the steps below use:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;model&lt;/code&gt;: &lt;code&gt;gpt-image-2.6-flare&lt;/code&gt; or &lt;code&gt;gpt-image-2.6-sunburst&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;quality&lt;/code&gt;: &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;high&lt;/code&gt; or &lt;code&gt;auto&lt;/code&gt; (apimodels.app defaults to &lt;code&gt;medium&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;reasoning_effort&lt;/code&gt;: &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt; or &lt;code&gt;high&lt;/code&gt;, which is the setting OpenAI calls "complexity" (any other value returns 400)&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;aspect_ratio&lt;/code&gt; + &lt;code&gt;resolution&lt;/code&gt; (&lt;code&gt;1K&lt;/code&gt;, &lt;code&gt;2K&lt;/code&gt;, &lt;code&gt;4K&lt;/code&gt;), or an exact &lt;code&gt;image_size&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;output_format&lt;/code&gt;: &lt;code&gt;png&lt;/code&gt;, &lt;code&gt;jpeg&lt;/code&gt;, &lt;code&gt;webp&lt;/code&gt;, &lt;code&gt;gif&lt;/code&gt; or &lt;code&gt;svg&lt;/code&gt; (&lt;code&gt;svg&lt;/code&gt; is text-to-image only, one image per request)&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;frame_count&lt;/code&gt; (2–64) and &lt;code&gt;frame_duration_ms&lt;/code&gt; (20–2000) for GIFs&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;image_urls&lt;/code&gt; (up to 16 references; any reference turns the request into an edit), plus &lt;code&gt;markup_image_url&lt;/code&gt; or &lt;code&gt;mask_url&lt;/code&gt; for guided edits&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Every step reuses one small helper. It submits a body, polls every three seconds, and returns the result URLs with the elapsed time, the charge and the token breakdown:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// gpt26.mjs — example helper (Node.js 18+, no dependencies)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="no"&gt;ENDPOINT&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'https://api.apimodels.app/v1/images/generations'&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nc"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`Bearer ${process.env.APIMODELS_API_KEY}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="s1"&gt;'Content-Type'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'application/json'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;sleep&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ms&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Promise&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;resolve&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;setTimeout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;resolve&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ms&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;timeoutMs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;60_000&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;started&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;ENDPOINT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'POST'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;ok&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`HTTP ${res.status}: ${JSON.stringify(json)}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;taskId&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;

  &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;started&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="n"&gt;timeoutMs&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sleep&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;3000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;poll&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${ENDPOINT}?task_id=${encodeURIComponent(taskId)}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;poll&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'completed'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;seconds&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;started&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${body.model}: ${seconds}s, $${data.credits}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
      &lt;span class="c1"&gt;// usage is only present for png / jpeg / webp results, not for GIFs, markup or mask edits, or SVG&lt;/span&gt;
      &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;urls&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;resultUrls&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;credits&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;Number&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;credits&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;seconds&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'failed'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`Task ${taskId} failed: ${JSON.stringify(data)}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`Task ${taskId} is still running; poll it again instead of resubmitting`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The timeout only stops your loop, not the job. If it fires, keep the task id and poll again later rather than submitting the same request twice.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Request a six-frame GIF loop
&lt;/h2&gt;

&lt;p&gt;A GIF is an ordinary image request with &lt;code&gt;output_format: "gif"&lt;/code&gt;, a frame count and a per-frame duration. The settings below match our mascot test (Flare, low quality, six frames at 150 ms each); the prompt text is illustrative. With &lt;code&gt;curl&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -s https://api.apimodels.app/v1/images/generations \
  -H &lt;span class="s2"&gt;"Authorization: Bearer $APIMODELS_API_KEY"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{
    "model": "gpt-image-2.6-flare",
    "prompt": "A round blue robot mascot waves hello. Seamless loop, same framing in every frame.",
    "output_format": "gif",
    "frame_count": 6,
    "frame_duration_ms": 150,
    "quality": "low",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }'&lt;/span&gt;
&lt;span class="c"&gt;# returns { "data": { "taskId": "..." } }&lt;/span&gt;

curl -s &lt;span class="s2"&gt;"https://api.apimodels.app/v1/images/generations?task_id=TASK_ID"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Authorization: Bearer $APIMODELS_API_KEY"&lt;/span&gt;
&lt;span class="c"&gt;# once data.state is "completed": data.resultUrls[0] is the GIF, data.credits is the charge&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The same request through the helper:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;run&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'./gpt26.mjs'&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;mascot&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gpt-image-2.6-flare'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'A round blue robot mascot waves hello. Seamless loop, same framing in every frame.'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;output_format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gif'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;frame_count&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;frame_duration_ms&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;150&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'low'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;aspect_ratio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'1:1'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;resolution&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'1K'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// apimodels.app shrinks each frame to 960x960 so the sheet fits (Step 2)&lt;/span&gt;
  &lt;span class="c1"&gt;// or pin an exact frame size, e.g. the 832x832 our test used:&lt;/span&gt;
  &lt;span class="c1"&gt;// image_size: { width: 832, height: 832 },&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;mascot&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;urls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Our run used 832×832 frames, took 25 s and comes to $0.0309 at today's rates. It came back as a real six-frame animated GIF that loops at 150 ms per frame. The character, framing and background held still; only the arm moved.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5hnb96l3t1d8snrg3fnf.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5hnb96l3t1d8snrg3fnf.gif" alt="Six-frame animated GIF from GPT Image 2.6 Flare: a round blue robot mascot waving hello on a loop" width="480" height="480"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Animate an image you already have
&lt;/h3&gt;

&lt;p&gt;Adding a reference to &lt;code&gt;image_urls&lt;/code&gt; makes the same request animate your picture instead of inventing one. We passed a line drawing of a bird from an earlier Flare request and asked for a blink, a hop and a pink heart floating up, keeping the line style and adding only a pink blush.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fghss1n81rzscdjvw43j0.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fghss1n81rzscdjvw43j0.webp" alt="Black-and-white line art of a round bird on a leafy branch, used as the GIF reference" width="640" height="480"&gt;&lt;/a&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;bird&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gpt-image-2.6-flare'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s1"&gt;'Animate this drawing as a six-frame loop: the bird blinks, hops, and a small pink heart floats up. '&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
    &lt;span class="s1"&gt;'Keep the exact line style. The only colour you may add is a pink blush on the cheeks.'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;image_urls&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'https://example.com/bird-line-art.png'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// placeholder&lt;/span&gt;
  &lt;span class="n"&gt;output_format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gif'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;frame_count&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;frame_duration_ms&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;150&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'low'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;image_size&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;720&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// the frame size our test came back at&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This one took 22 s and comes to $0.0501. Every frame kept the line weight and style, the blush was the only colour added, and the three actions played in order. It costs $0.0192 more than the mascot although the frames hold about the same number of pixels. The reference image and the longer prompt add input tokens, but GIFs carry no token breakdown, and GIF cost also moves with the image itself: the text-only 976×672 loop in Step 2 comes to $0.0441.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flibndhfbvaym6d2w1fnt.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flibndhfbvaym6d2w1fnt.gif" alt="Six-frame animated GIF: the line-art bird blinks, hops and a pink heart floats up, with a pink blush as the only added colour" width="560" height="420"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Size the frames so the sheet fits
&lt;/h2&gt;

&lt;p&gt;GPT Image 2.6 draws all GIF frames on one sheet, and the sheet has two limits: its longest edge must be 3840 px or less, and it must hold no more than 8,294,400 pixels in total, the same budget as a single image. The frame count rounds up to a power of two and fills a grid: 6 frames take an 8-cell grid laid out 4×2 (wide) or 2×4 (tall), and 12 frames take a 16-cell 4×4 grid. A request fits if the whole grid stays within the pixel budget and either layout stays within 3840 px.&lt;/p&gt;

&lt;p&gt;The edge limit explains our first failure. Six frames at 1024×1024 make a 4096×2048 sheet laid out wide and a 2048×4096 sheet laid out tall; both are over the limit, and the upstream error listed exactly those two sheet sizes. The request was rejected and not charged.&lt;/p&gt;

&lt;p&gt;Checking both layouts matters for wide frames. To confirm it, we ran one more six-frame request at 976×672, a size that only fits tall: four frames across would be 3904 px, but two across and four down make a 1952×2688 sheet. It worked in 20 s and came back as a six-frame 976×672 GIF.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Frames&lt;/th&gt;
&lt;th&gt;Frame size&lt;/th&gt;
&lt;th&gt;Sheet&lt;/th&gt;
&lt;th&gt;Result&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;1024×1024&lt;/td&gt;
&lt;td&gt;4096×2048 wide or 2048×4096 tall: long edge too big&lt;/td&gt;
&lt;td&gt;Rejected, not charged&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;832×832&lt;/td&gt;
&lt;td&gt;3328×1664 or 1664×3328&lt;/td&gt;
&lt;td&gt;Worked: 25 s, $0.0309&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;960×720&lt;/td&gt;
&lt;td&gt;3840×1440 wide&lt;/td&gt;
&lt;td&gt;Worked: 22 s, $0.0501 (with a reference image)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;976×672&lt;/td&gt;
&lt;td&gt;wide 3904×1344 too big; tall 1952×2688 fits&lt;/td&gt;
&lt;td&gt;Worked: 20 s, $0.0441&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;9&lt;/td&gt;
&lt;td&gt;960×960&lt;/td&gt;
&lt;td&gt;laid out 3×3: 2880×2880, exactly 8,294,400 px&lt;/td&gt;
&lt;td&gt;Worked: $0.0833&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;12&lt;/td&gt;
&lt;td&gt;960×960&lt;/td&gt;
&lt;td&gt;4×4: 3840×3840, 14.7 million px, over the budget&lt;/td&gt;
&lt;td&gt;Rejected, not charged&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;12&lt;/td&gt;
&lt;td&gt;720×720&lt;/td&gt;
&lt;td&gt;4×4: 2880×2880, exactly 8,294,400 px&lt;/td&gt;
&lt;td&gt;Worked: $0.0501&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;A correction: we first read the rule as "960×960 frames fit up to 16 per GIF", with only the edge limit in play, and that was wrong. Later on 5 November a real 12-frame request at 960×960 was rejected for exceeding the pixel budget, because a 4×4 grid of 960×960 frames is a 3840×3840 sheet. Our nine-frame 960×960 loop had worked only because it was laid out 3×3, which sits exactly at the cap. Don't count on that tighter layout.&lt;/p&gt;

&lt;p&gt;These are the per-frame limits that follow from both rules:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;code&gt;frame_count&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;Grid&lt;/th&gt;
&lt;th&gt;Per-frame limit&lt;/th&gt;
&lt;th&gt;Fits, for example&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;2×1 or 1×2&lt;/td&gt;
&lt;td&gt;doubled side ≤ 1920, other side ≤ 3840, ≤ 4,147,200 px&lt;/td&gt;
&lt;td&gt;1920×2160, 1920×1088&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3–4&lt;/td&gt;
&lt;td&gt;2×2&lt;/td&gt;
&lt;td&gt;both sides ≤ 1920, ≤ 2,073,600 px&lt;/td&gt;
&lt;td&gt;1440×1440, 1920×1072&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5–8&lt;/td&gt;
&lt;td&gt;4×2 or 2×4&lt;/td&gt;
&lt;td&gt;short side ≤ 960, long side ≤ 1920, ≤ 1,036,800 px&lt;/td&gt;
&lt;td&gt;960×960, 1344×768&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;9–16&lt;/td&gt;
&lt;td&gt;4×4&lt;/td&gt;
&lt;td&gt;both sides ≤ 960, ≤ 518,400 px&lt;/td&gt;
&lt;td&gt;720×720, 944×528&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;17–32&lt;/td&gt;
&lt;td&gt;8×4 or 4×8&lt;/td&gt;
&lt;td&gt;short side ≤ 480, long side ≤ 960, ≤ 259,200 px&lt;/td&gt;
&lt;td&gt;480×480, 672×384&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;33–64&lt;/td&gt;
&lt;td&gt;8×8&lt;/td&gt;
&lt;td&gt;both sides ≤ 480, ≤ 129,600 px&lt;/td&gt;
&lt;td&gt;352×352&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The common 16:9 size 1360×768 is just over for 5–8 frames (1,044,480 px), so drop to 1344×768. We tested 6, 9 and 12 frames; the other rows follow from the same rule, and we did not test more than 16 frames.&lt;/p&gt;

&lt;p&gt;The simplest fix is to let the server pick the frame size. When you pass &lt;code&gt;aspect_ratio&lt;/code&gt; + &lt;code&gt;resolution&lt;/code&gt;, apimodels.app shrinks each frame to the largest size that fits, so 6 frames at 1:1 1K come back at 960×960 and 12 frames at 720×720. If you pin an exact &lt;code&gt;image_size&lt;/code&gt;, it is sent as-is, a frame that is too large fails without a charge, and the check is yours. This example pre-flight function encodes both limits:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Example: check that a GIF request fits on one frame sheet: long edge &amp;lt;= 3840 px&lt;/span&gt;
&lt;span class="c1"&gt;// and no more than 8,294,400 px in total. It assumes the power-of-two grid, so it is&lt;/span&gt;
&lt;span class="c1"&gt;// conservative for counts the server may lay out more tightly (our 9-frame run went 3x3).&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;frames&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;maxEdge&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;3840&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;maxPixels&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;8_294_400&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;ceil&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log2&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;frames&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;          &lt;span class="c1"&gt;// 6 -&amp;gt; 8 cells, 12 -&amp;gt; 16 cells&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;a&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;**&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;ceil&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;**&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;floor&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;// 8 cells -&amp;gt; 4 and 2, 16 -&amp;gt; 4 and 4&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt; &lt;span class="o"&gt;**&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;width&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;maxPixels&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;         &lt;span class="c1"&gt;// the whole grid counts, empty cells too&lt;/span&gt;
  &lt;span class="c1"&gt;// the grid can be laid out a×b or b×a; the sheet fits if either orientation stays within maxEdge&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;a&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;a&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;some&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;cols&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;cols&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;width&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="n"&gt;maxEdge&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="n"&gt;rows&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="n"&gt;maxEdge&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// false: 4096 px either way&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;832&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;832&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;// true:  3328 x 1664&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;720&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;// true:  3840 x 1440&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;976&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;672&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;// true:  only tall, 1952 x 2688&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1360&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;768&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;// false: 8 x 1360 x 768 = 8,355,840 px, just over&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;// false: 3840 x 3840 is 14.7 million px&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;720&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;720&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;// true:  2880 x 2880, exactly 8,294,400 px&lt;/span&gt;
&lt;span class="nf"&gt;gifSheetFits&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;9&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;960&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;// false: conservative; don't rely on a 3x3 layout&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The function only checks the sheet. An exact size also has to pass the general size rules: both sides multiples of 16 and a ratio of 3:1 or less.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Draw a markup PNG
&lt;/h2&gt;

&lt;p&gt;A markup image is a transparent PNG, the same size as the image you are editing, that contains only your annotations: circles, arrows and short notes. It is the API version of the ChatGPT image markup that OpenAI announced. The API takes it as &lt;code&gt;markup_image_url&lt;/code&gt;; you can send a markup image or a mask (&lt;code&gt;mask_url&lt;/code&gt;, white = change, black = keep), not both.&lt;/p&gt;

&lt;p&gt;Our source was the Sunburst poster from the cost comparison in Step 6, at 1360×768. The markup circled two jars, added an arrow and the note "swap for a small potted plant". This script draws the same kind of layer with &lt;code&gt;sharp&lt;/code&gt;; the coordinates are placeholders, so move them to wherever your object is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// make-markup.mjs — example: a transparent PNG with only annotations&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'sharp'&lt;/span&gt;

&lt;span class="c1"&gt;// The markup layer must be the same size as the image you are editing.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;height&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'poster.png'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;// Placeholder coordinates: move the circle, arrow and note to your own object.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;red&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'#e53935'&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;svg&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sb"&gt;`
&amp;lt;svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"&amp;gt;
  &amp;lt;defs&amp;gt;
    &amp;lt;marker id="head" viewBox="0 0 10 10" refX="5" refY="5"
            markerWidth="4" markerHeight="4" orient="auto"&amp;gt;
      &amp;lt;path d="M0,0 L10,5 L0,10 z" fill="${red}"/&amp;gt;
    &amp;lt;/marker&amp;gt;
  &amp;lt;/defs&amp;gt;
  &amp;lt;ellipse cx="1235" cy="440" rx="115" ry="150"
           fill="none" stroke="${red}" stroke-width="8"/&amp;gt;
  &amp;lt;line x1="1110" y1="250" x2="1160" y2="315"
        stroke="${red}" stroke-width="8" marker-end="url(#head)"/&amp;gt;
  &amp;lt;text x="830" y="228" font-family="Helvetica, Arial, sans-serif"
        font-size="38" fill="${red}"&amp;gt;swap for a small potted plant&amp;lt;/text&amp;gt;
&amp;lt;/svg&amp;gt;`&lt;/span&gt;

&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;svg&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'markup.png'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;meta&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'markup.png'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;meta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;meta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;height&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;meta&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;hasAlpha&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// must match the source; alpha must be true&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For our 1360×768 poster, the last line prints &lt;code&gt;1360 768 true&lt;/code&gt;. If the size does not match the source, or the background is not transparent, fix that before you send anything. Do not flatten the marks onto the photo; the layer should carry the annotations and nothing else.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 4: Send the markup-guided edit
&lt;/h2&gt;

&lt;p&gt;The edit passes the original as the first reference and the layer as &lt;code&gt;markup_image_url&lt;/code&gt;. Upload both files somewhere the API can fetch them first:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;round1&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gpt-image-2.6-sunburst'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="s1"&gt;'Apply the marked change: replace the circled jars with a small potted plant. '&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
    &lt;span class="s1"&gt;'Keep everything else exactly as it is.'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;image_urls&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'https://example.com/poster.png'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;     &lt;span class="c1"&gt;// placeholder: the image to edit&lt;/span&gt;
  &lt;span class="n"&gt;markup_image_url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'https://example.com/markup.png'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// placeholder: same size as poster.png&lt;/span&gt;
  &lt;span class="n"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'medium'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Sunburst replaced exactly the circled objects with a plant in a speckled pot, and it did not paint the red marks into the result. The headline, the dripper, the window and the light were unchanged. The call took 35 s and comes to $0.0391.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fatjrgex7n0sj8az82b91.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fatjrgex7n0sj8az82b91.webp" alt="Three panels: the original Slow Mornings poster, the same poster with a red circle, arrow and note over two jars, and the Sunburst result with a small potted plant in their place" width="800" height="149"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;An edit without a size keeps the input's shape but not necessarily its pixel size. Ours came back at 1668×943, slightly larger than the 1360×768 input. If later code expects fixed dimensions, set the size yourself, for example &lt;code&gt;aspect_ratio: '16:9', resolution: '1K'&lt;/code&gt;, which gave 1360×768 for the text-to-image posters. We did not pin the size in this test.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 5: Run a second edit round
&lt;/h2&gt;

&lt;p&gt;A second round is another edit whose first reference is the previous result. No markup this time; the prompt names the one thing to change:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;round2&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'gpt-image-2.6-sunburst'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Repaint only the wall a soft sage green. Keep everything else.'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;image_urls&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;round1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;urls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'medium'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Only the wall changed. The typography, the glaze pattern, the plant from round 1 and the shadows matched the previous round. The call took 25 s and comes to $0.0399. Because this round is a plain prompt edit with a PNG result, it also returns &lt;code&gt;usage&lt;/code&gt;; the markup edit in round 1 does not.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fw2wljrv2nnz6c2dw9iyj.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fw2wljrv2nnz6c2dw9iyj.webp" alt="Two panels: round one of the edit with a cream wall, and round two with the wall repainted sage green while the dripper, plant and headline stay the same" width="799" height="224"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 6: Read what each call cost
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;data.credits&lt;/code&gt; is the exact amount each request was charged, which is why the helper returns it. Summing it gives the bill for a whole run:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;calls&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;mascot&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bird&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;round1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;round2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`total: $${calls.reduce((sum, call) =&amp;gt; sum + call.credits, 0).toFixed(4)}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;round2&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;usage&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;cost&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// { currency, amount, discount, charged }; undefined for GIFs and markup edits&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;GPT Image 2.6 has no fixed per-image price on apimodels.app; it is billed per token, at the same rates as OpenAI's official API:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Image output: $30 per 1M tokens&lt;/li&gt;
&lt;li&gt;Image input: $8 per 1M tokens ($2 cached)&lt;/li&gt;
&lt;li&gt;Text input: $5 per 1M tokens ($1.25 cached)&lt;/li&gt;
&lt;li&gt;Text output: $10 per 1M tokens&lt;/li&gt;
&lt;li&gt;Each request is rounded up to $0.0001&lt;/li&gt;
&lt;li&gt;SVG is the exception: a flat $0.035 per image&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Quality, size, GIF frame count, reference and markup images, and prompt length all change the token count. When you submit, an upper bound is held from your balance, and the unused part is released when the image is ready. Failed requests are not charged, which is why our rejected GIFs and our launch-day SVG attempts cost nothing. Not every request succeeds, either: moderation refusals and upstream errors happen.&lt;/p&gt;

&lt;p&gt;Completed PNG, JPEG and WebP results, from text-to-image or a plain edit, also carry &lt;code&gt;usage&lt;/code&gt;: input and output tokens split into text and image, in the OpenAI Images shape. Inside it, &lt;code&gt;cost&lt;/code&gt; has &lt;code&gt;amount&lt;/code&gt; (the official-rate price before any account discount), &lt;code&gt;discount&lt;/code&gt; (your account's price multiplier, 1 for none) and &lt;code&gt;charged&lt;/code&gt;, which equals &lt;code&gt;credits&lt;/code&gt;; rely on &lt;code&gt;charged&lt;/code&gt;. You get it from the task query, the task callback, and the synchronous OpenAI-compatible responses of &lt;code&gt;/v1/images/generations&lt;/code&gt; and &lt;code&gt;/v1/images/edits&lt;/code&gt;. GIFs, markup or mask edits, SVG and failed tasks don't include it.&lt;/p&gt;

&lt;p&gt;Here are all seven launch-day tests, run on 5 November 2026. Time is what each request took that day; cost is that request's token usage at today's prices, since prices moved to OpenAI's official rates after these tests:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;#&lt;/th&gt;
&lt;th&gt;Test&lt;/th&gt;
&lt;th&gt;Model&lt;/th&gt;
&lt;th&gt;Settings&lt;/th&gt;
&lt;th&gt;Time&lt;/th&gt;
&lt;th&gt;Cost&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;Product poster: ceramic pour-over dripper, headline "SLOW MORNINGS", line "Hand-glazed in Kyoto"&lt;/td&gt;
&lt;td&gt;Flare&lt;/td&gt;
&lt;td&gt;1K, 16:9, medium (1360×768)&lt;/td&gt;
&lt;td&gt;16 s&lt;/td&gt;
&lt;td&gt;$0.0257&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;Same prompt&lt;/td&gt;
&lt;td&gt;Sunburst&lt;/td&gt;
&lt;td&gt;Same&lt;/td&gt;
&lt;td&gt;28 s&lt;/td&gt;
&lt;td&gt;$0.0257&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;Line art of a bird on a branch&lt;/td&gt;
&lt;td&gt;Flare&lt;/td&gt;
&lt;td&gt;1K, low, 4:3 (1152×864)&lt;/td&gt;
&lt;td&gt;11 s&lt;/td&gt;
&lt;td&gt;$0.0184&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;Six-frame GIF loop: robot mascot waves hello&lt;/td&gt;
&lt;td&gt;Flare&lt;/td&gt;
&lt;td&gt;6 frames, 832×832, low, 150 ms/frame&lt;/td&gt;
&lt;td&gt;25 s&lt;/td&gt;
&lt;td&gt;$0.0309&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;Test 3 as reference: six-frame loop, bird blinks, hops, heart floats up&lt;/td&gt;
&lt;td&gt;Flare&lt;/td&gt;
&lt;td&gt;6 frames, 960×720, low&lt;/td&gt;
&lt;td&gt;22 s&lt;/td&gt;
&lt;td&gt;$0.0501&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;Markup edit on the Sunburst poster: swap two jars for a potted plant&lt;/td&gt;
&lt;td&gt;Sunburst&lt;/td&gt;
&lt;td&gt;Medium, size follows input (1668×943)&lt;/td&gt;
&lt;td&gt;35 s&lt;/td&gt;
&lt;td&gt;$0.0391&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;7&lt;/td&gt;
&lt;td&gt;Second round on test 6: repaint only the wall sage green&lt;/td&gt;
&lt;td&gt;Sunburst&lt;/td&gt;
&lt;td&gt;Medium&lt;/td&gt;
&lt;td&gt;25 s&lt;/td&gt;
&lt;td&gt;$0.0399&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The seven come to $0.2298. Plain 1K images now usually report fewer tokens than these launch-day calls, so a similar 1K image today typically costs less: about $0.008–0.016 at low quality, about $0.016 at high, and about $0.016 for a 1K edit with one reference. At 2K, low quality came to $0.0283 and medium to $0.0516. Timings moved too: in a re-test that evening, a plain 1K text-to-image took about 20 s (about 27 s at high quality), a 1K edit with one reference 22–58 s, and 2K and 4K images, high quality included, 13–25 s.&lt;/p&gt;

&lt;p&gt;The two tiers cost the same for the same poster. Identical settings used the same tokens, so Sunburst's extra ~12 s bought detail, not a bigger bill. Both tiers spelled the poster text correctly; Flare staged the dripper on a glass server with coffee, and Sunburst gave the glaze more texture and a sparser scene.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd8lqocfwd64d5gz5x9ju.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd8lqocfwd64d5gz5x9ju.webp" alt="Two posters side by side: Flare on the left with the dripper on a glass coffee server, Sunburst on the right with a more textured glaze and a sparser scene" width="799" height="224"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  SVG failed on launch day, and works now
&lt;/h2&gt;

&lt;p&gt;OpenAI lists SVG export for Images 2.6, but on launch day every SVG request we sent failed upstream. That held on both tiers and even for a three-word prompt, "a red apple". None of those requests were billed.&lt;/p&gt;

&lt;p&gt;SVG has since been enabled on apimodels.app. &lt;code&gt;output_format: "svg"&lt;/code&gt; works for text-to-image only, one image per request, at a flat $0.035 per image, and the quality setting has no effect on it. Most SVGs come back in 13–18 s, though we saw one take about two minutes. The result is a static vector with no scripts or embedded raster, which suits icons, logos and flat illustrations rather than detailed artwork.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where apimodels.app fits
&lt;/h2&gt;

&lt;p&gt;apimodels.app handled three things in this walkthrough that you would otherwise handle yourself. It shrinks GIF frames to fit the sheet when you pass &lt;code&gt;aspect_ratio&lt;/code&gt; + &lt;code&gt;resolution&lt;/code&gt;. It rejects requests that cannot work with a 400 up front, such as an SVG request with a reference image or a &lt;code&gt;reasoning_effort&lt;/code&gt; other than &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt; or &lt;code&gt;high&lt;/code&gt;. And it reports what each request cost in &lt;code&gt;data.credits&lt;/code&gt;, with the token breakdown in &lt;code&gt;usage&lt;/code&gt; for PNG, JPEG and WebP results. The official OpenAI SDK also works against it with &lt;code&gt;base_url&lt;/code&gt; set to &lt;code&gt;https://api.apimodels.app/v1&lt;/code&gt;, where an exact &lt;code&gt;WxH&lt;/code&gt; size makes &lt;code&gt;images.generate&lt;/code&gt; synchronous and the response carries &lt;code&gt;usage&lt;/code&gt; at the top level. Every parameter, size table and limit is in the &lt;a href="https://apimodels.app/docs/gpt-image-2-6" rel="noopener noreferrer"&gt;GPT Image 2.6 API docs on apimodels.app&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  When not to use GPT Image 2.6
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;You need a fixed, predictable price per image for budgeting.&lt;/strong&gt; GPT Image 2.6 is billed per token, so the cost moves with size, quality, frames and inputs. GPT Image 2.5 on apimodels.app is sold per image by resolution × quality.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You need detailed vector artwork.&lt;/strong&gt; Its SVG output is a simple static vector for icons and flat illustrations (see above).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;You want video.&lt;/strong&gt; The GIFs are short loops of small movements, like a wave, a blink or a hop, not clips with camera moves or a story.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Common errors
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Six 1024×1024 frames get rejected.&lt;/strong&gt; The sheet would be 4096 px whichever way it is laid out. For 5–8 frames keep the short side at 960 px or less, the long side at 1920 px or less and each frame at 1,036,800 px or less (run &lt;code&gt;gifSheetFits&lt;/code&gt; from Step 2), or pass &lt;code&gt;aspect_ratio&lt;/code&gt; + &lt;code&gt;resolution&lt;/code&gt; and let apimodels.app size them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Twelve 960×960 frames get rejected.&lt;/strong&gt; The long edge is exactly 3840 px, but the 4×4 sheet holds 14.7 million pixels, over the 8,294,400 budget. For 9–16 frames keep each frame at 518,400 px or less, for example 720×720.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;output_format: "svg"&lt;/code&gt; returns 400.&lt;/strong&gt; SVG works for text-to-image only, one image per request. Drop the reference images and ask for a single image.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;reasoning_effort: "xhigh"&lt;/code&gt; or &lt;code&gt;"max"&lt;/code&gt; returns 400.&lt;/strong&gt; Only &lt;code&gt;low&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt; and &lt;code&gt;high&lt;/code&gt; are accepted.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The response has an image instead of a &lt;code&gt;taskId&lt;/code&gt;.&lt;/strong&gt; An exact &lt;code&gt;WxH&lt;/code&gt; &lt;code&gt;size&lt;/code&gt; makes the call synchronous and returns the OpenAI Images response shape. For the polling flow, use &lt;code&gt;aspect_ratio&lt;/code&gt; + &lt;code&gt;resolution&lt;/code&gt; or &lt;code&gt;image_size&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Markup and mask in the same request.&lt;/strong&gt; Send &lt;code&gt;markup_image_url&lt;/code&gt; or &lt;code&gt;mask_url&lt;/code&gt;, not both.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The markup layer does not match the source.&lt;/strong&gt; It must be the same size as the first reference image. Build it from the source's own metadata, as in Step 3.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The edited image has different dimensions.&lt;/strong&gt; An edit with no size follows the input image, and ours grew from 1360×768 to 1668×943. Set the size if your pipeline needs exact pixels.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Limits
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The numbers come from one day of testing (5 November 2026), one result per setting. Your timings will vary.&lt;/li&gt;
&lt;li&gt;Costs are each launch-day request's token usage at today's prices, which match OpenAI's official per-token rates.&lt;/li&gt;
&lt;li&gt;The GIF sheet rule was confirmed for 6 frames (both layouts), 9 frames and 12 frames. The behaviour for other counts follows from the same rule but was not tested.&lt;/li&gt;
&lt;li&gt;We did not test &lt;code&gt;mask_url&lt;/code&gt; or &lt;code&gt;num_images&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Has anyone pushed &lt;code&gt;frame_count&lt;/code&gt; past 16 yet? I would like to know whether the sheet rule holds the way the math says it should.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;I work on apimodels.app. The full launch-day write-up, with all seven test images, is the &lt;a href="https://apimodels.app/blog/gpt-image-2-6-api-tested" rel="noopener noreferrer"&gt;GPT Image 2.6 API test write-up on the apimodels.app blog&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>api</category>
      <category>openai</category>
      <category>tutorial</category>
    </item>
    <item>
      <title>7 Patterns From 204 Muse Video Prompts Shared on X, Plus a Node.js Script to Run Them</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Wed, 04 Nov 2026 13:03:53 +0000</pubDate>
      <link>https://dev.to/super_lewis/7-patterns-from-204-muse-video-prompts-shared-on-x-plus-a-nodejs-script-to-run-them-3imn</link>
      <guid>https://dev.to/super_lewis/7-patterns-from-204-muse-video-prompts-shared-on-x-plus-a-nodejs-script-to-run-them-3imn</guid>
      <description>&lt;p&gt;&lt;strong&gt;Short answer:&lt;/strong&gt; the realistic Muse Video prompts shared on X follow seven patterns: lock the person with one reference sheet, write the body in time steps and cut on the beat, make the camera a person for POV, repeat a block for whatever must not change, ask for a phone camera's flaws, split anything longer than 20 seconds, and keep one-liners for the Muse app rather than the API. All 204 prompts are in an open-source, credited library linked below.&lt;/p&gt;

&lt;p&gt;Over the past few weeks my X feed filled up with Muse Video clips: handheld selfies, vlogs and "boyfriend POV" shorts that look like they were filmed on a phone. The prompts behind them were scattered across hundreds of posts, many cut off behind "Show more", split across replies, or quietly swapped for a translation.&lt;/p&gt;

&lt;p&gt;So I collected them. &lt;strong&gt;muse-video-prompts is an open-source library of 204 Muse Video prompts shared on X, each credited to its creator and linked to the original post, sorted into 13 categories.&lt;/strong&gt; This post covers what's in it, one scraping gotcha worth knowing about, the seven patterns the best prompts share, and a short Node.js script that runs any of them through an API.&lt;/p&gt;

&lt;p&gt;Disclosure up front: I build apimodels.app, which sells API access to Muse Video (among other models) and hosts a copy of this library with the clips playing inline.&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/apimodels" rel="noopener noreferrer"&gt;
        apimodels
      &lt;/a&gt; / &lt;a href="https://github.com/apimodels/muse-video-prompts" rel="noopener noreferrer"&gt;
        muse-video-prompts
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      204 Muse Video prompts collected from X, each credited to its creator and linked to the original post. Searchable page, one file per prompt, JSON data. Curated by apimodels.app.
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;Muse Video Prompts: 204 Real Prompts from X&lt;/h1&gt;
&lt;/div&gt;
&lt;p&gt;English · &lt;a href="https://github.com/apimodels/muse-video-prompts/README.zh-CN.md" rel="noopener noreferrer"&gt;简体中文&lt;/a&gt; · &lt;a href="https://apimodels.app/muse-video-prompts" rel="nofollow noopener noreferrer"&gt;Watch them with the videos on apimodels.app&lt;/a&gt; · &lt;a href="https://apimodels.github.io/muse-video-prompts/" rel="nofollow noopener noreferrer"&gt;Search and copy them on GitHub Pages&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;204 prompts that creators posted on X after running them in Meta's Muse, each credited to its creator and linked to the original post. They were posted between 2026-09-17 and 2026-11-04 by 68 creators, mostly in Chinese, some in English and Japanese. Where a prompt was split between a post and the author's own replies, the parts are joined back into one prompt; copies of the same prompt reposted by other accounts are merged into one entry and listed as "also posted by".&lt;/p&gt;
&lt;p&gt;Disclosure: this collection is curated by &lt;a href="https://apimodels.app" rel="nofollow noopener noreferrer"&gt;apimodels.app&lt;/a&gt;, the API platform I work on. apimodels.app is a multi-model API gateway, and it offers &lt;a href="https://apimodels.app/models/muse-video" rel="nofollow noopener noreferrer"&gt;Muse Video through an API&lt;/a&gt;; the limits of that API are listed under &lt;a href="https://github.com/apimodels/muse-video-prompts#running-these-prompts-through-the-api" rel="noopener noreferrer"&gt;Running these prompts&lt;/a&gt;…&lt;/p&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/apimodels/muse-video-prompts" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;h2&gt;
  
  
  What's in the library
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;204 prompts&lt;/strong&gt;, each with the creator's handle, the post date and a link to the original post.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Full text or excerpt.&lt;/strong&gt; A prompt is quoted in full when its author invited people to reuse it (22) or when it is 600 characters or shorter (54). The other 128 are word-for-word excerpts from the beginning, marked as excerpts, with the full text one click away in the original post.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Original languages:&lt;/strong&gt; 154 Chinese, 38 English, 8 Japanese, 4 mixed. Muse reads all of them, so nothing is translated.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;13 categories:&lt;/strong&gt; boyfriend POV (39), multi-shot beat cuts built on a reference sheet (31), selfie and vlog (28), Chinese period pieces (22), dance (14), fantasy, animation and CG (14), fashion portrait (12), one-liners (12), long-form multi-clip scripts (11), documentary and landscape (9), transitions (5), cinematic story (5) and ASMR (2).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Formats:&lt;/strong&gt; one Markdown file per prompt under &lt;code&gt;prompts/&amp;lt;category&amp;gt;/&lt;/code&gt;, everything in &lt;code&gt;data/prompts.json&lt;/code&gt;, and a single-file &lt;code&gt;index.html&lt;/code&gt; that searches, filters and copies. The same page is on &lt;a href="https://apimodels.github.io/muse-video-prompts/" rel="noopener noreferrer"&gt;GitHub Pages&lt;/a&gt;, and a version with the original clips playing inline is on &lt;a href="https://apimodels.app/muse-video-prompts" rel="noopener noreferrer"&gt;apimodels.app/muse-video-prompts&lt;/a&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  A scraping gotcha: the text you scrape from X may be a translation
&lt;/h2&gt;

&lt;p&gt;Reading post text from X's web client is not the same as reading the original post. With X's automatic translation, or a translation extension, in the loop, my first pass came back with Japanese prompts already rendered in English, and some English prompts with a Chinese translation appended. The text looked plausible, so nothing failed loudly.&lt;/p&gt;

&lt;p&gt;The fix was to rebuild every prompt from the original post text returned by a public embed API (&lt;code&gt;api.fxtwitter.com/&amp;lt;user&amp;gt;/status/&amp;lt;id&amp;gt;&lt;/code&gt;), and keep the scraped text only when its language and length matched the original. Dozens of records changed. If you scrape user-generated text from a site that translates for you, check each record's language against the source before you trust it.&lt;/p&gt;

&lt;h2&gt;
  
  
  7 patterns the best prompts share
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;1. Lock the person with one reference sheet.&lt;/strong&gt; The most-copied format starts from a single composite image: a headshot on the left and a three-view outfit sheet on the right. The prompt points at it section by section (face from the headshot, outfit from the turnaround) and repeats that the face and outfit must not change in any shot. Through an API, send that sheet as a reference image, not as a first frame.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Write the body in time steps and cut on the beat.&lt;/strong&gt; These prompts describe each shot in short steps (weight shift, where each hand is, where the eyes go) and list the cut points, such as 1.80 s, 3.50 s and 5.10 s, against the beats of the music. "She poses" on its own gets you a stiff loop.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. For POV, make the camera a person.&lt;/strong&gt; The boyfriend-POV series opens every episode with the same rule: the camera is his eyes, and he never appears except for a hand or forearm. Then the action in 0–2 s / 2–5 s / 5–8 s / 8–10 s, one line of dialogue, and a handheld 9:16 phone look.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;4. Repeat a block for whatever must not change.&lt;/strong&gt; The long English prompts open with a format lock (aspect ratio and source resolution) and a master block that fixes the character and costume word for word, pasted into every clip. Dance prompts add a tempo lock: the BPM and the timestamp of every downbeat.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;5. Ask for the flaws of a phone camera.&lt;/strong&gt; Selfie and vlog prompts get their realism by asking for handheld shake, focus breathing, noise-reduction smear, platform compression and 720p, and by banning HDR, studio retouching and a face that stays sharp the whole time.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;6. Split anything longer than 20 seconds.&lt;/strong&gt; Several prompts describe films of 30 seconds to a minute. On the API each request is 4 to 20 seconds and up to 4,000 characters, so split by clip, keep the character block identical in every request, and edit the clips together.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;7. One-liners need the app, not the API.&lt;/strong&gt; Instructions such as "turn the images in this post into a video" work in Meta's Muse app because the agent opens the link and writes its own prompt. A video API only sees the text you send, so write the shots out.&lt;/p&gt;

&lt;p&gt;Put together, the shape most of the strong prompts follow is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Format (aspect ratio, length) + who (locked by a reference image) + scene + light
+ camera position + shots written in time steps + style + sound + what to avoid
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A short example in that shape (mine, not from the library):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;9:16, 10 seconds, handheld phone selfie. The woman from the reference image, same face,
hair and outfit throughout. A quiet bookshop aisle in the late afternoon, warm window light
from the left. 0–3 s: she pulls a book from the shelf and glances at the lens. 3–6 s: she
lifts it to hide half her face and laughs. 6–10 s: she lowers it, looks straight into the
lens and says "Found it." Slight handheld shake, natural skin texture, the soft sound of
pages. Avoid: on-screen text, extra fingers, a second person.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Run a prompt from the library with Node.js
&lt;/h2&gt;

&lt;p&gt;What you need:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Node.js 18 or later (for the built-in &lt;code&gt;fetch&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;A clone of the repo: &lt;code&gt;git clone https://github.com/apimodels/muse-video-prompts&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;An apimodels.app API key in &lt;code&gt;APIMODELS_API_KEY&lt;/code&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The script below picks a prompt by id from &lt;code&gt;data/prompts.json&lt;/code&gt;, refuses excerpts and anything over the API's 4,000-character limit, maps the library's aspect ratios onto the two the API accepts, creates the task, polls it and saves the MP4. Save it in the repo root as &lt;code&gt;run-prompt.mjs&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// run-prompt.mjs: run one prompt from the library through the muse-video API.&lt;/span&gt;
&lt;span class="c1"&gt;// Usage: APIMODELS_API_KEY=your_key node run-prompt.mjs MV039&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;readFile&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;writeFile&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'node:fs/promises'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="no"&gt;API&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'https://api.apimodels.app/v1/video/generations'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nc"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`Bearer ${process.env.APIMODELS_API_KEY}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="s1"&gt;'Content-Type'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'application/json'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="s1"&gt;'MV039'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;prompts&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;readFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'data/prompts.json'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'utf8'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;prompts&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;x&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`No prompt ${id}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text_status&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'excerpt'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${id} is an excerpt. Copy the full prompt from ${p.url}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;4000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${id} is ${p.text.length} characters; split it by clip.`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;needs_reference&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;warn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${id} was written for reference images: add up to 4 in "images".`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// The API takes 16:9 or 9:16 only, and 4 to 20 whole seconds.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;aspect_ratio&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'16:9'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'4:3'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;aspect&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="s1"&gt;'16:9'&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'9:16'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;duration&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;min&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;20&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;seconds&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;created&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;API&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'POST'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'muse-video'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;aspect_ratio&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;created&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;code&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;created&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// a 400 creates no task and costs nothing&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;taskId&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;created&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`task ${taskId}: ${duration} s × $0.037 = $${(duration * 0.037).toFixed(3)}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Promise&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;setTimeout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;12_000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// poll every 10-15 s&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${API}?task_id=${taskId}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;headers&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'failed'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;failMsg&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// failed tasks are not charged&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'completed'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;mp4&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;resultUrls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;arrayBuffer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;writeFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${id}.mp4`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;mp4&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`saved ${id}.mp4`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;MV039&lt;/code&gt; is a 10-second, 9:16 boyfriend-POV prompt whose author invited reuse, so the full text is in the repo. Run it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;your_key node run-prompt.mjs MV039
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The script prints the task id and the cost ($0.370 for 10 seconds), then &lt;code&gt;pending&lt;/code&gt;, &lt;code&gt;processing&lt;/code&gt; and finally &lt;code&gt;completed&lt;/code&gt;. Clips of up to 10 seconds usually take one to two minutes; 15 to 20 seconds usually take three to seven.&lt;/p&gt;

&lt;h2&gt;
  
  
  Verify the clip
&lt;/h2&gt;

&lt;p&gt;Check the size and whether the clip has sound:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ffprobe -v error -select_streams v:0 -show_entries &lt;span class="nv"&gt;stream&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;width,height -of &lt;span class="nv"&gt;csv&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;p&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;0 MV039.mp4
&lt;span class="c"&gt;# 720,1280&lt;/span&gt;
ffprobe -v error -select_streams a -show_entries &lt;span class="nv"&gt;stream&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;codec_name -of &lt;span class="nv"&gt;csv&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;p&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;0 MV039.mp4
&lt;span class="c"&gt;# aac when there is an audio track, nothing when the clip is silent&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Muse generates sound together with the picture, but not every clip comes back with an audio track, so check it if your pipeline needs audio.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where apimodels.app fits, and when to skip it
&lt;/h2&gt;

&lt;p&gt;apimodels.app is a multi-model API gateway: one API key and one endpoint for 150+ image, video, audio and language models. Muse Video is the model id &lt;code&gt;muse-video&lt;/code&gt; on &lt;code&gt;POST /v1/video/generations&lt;/code&gt;, and here are its limits as of November 2026:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Input:&lt;/strong&gt; a prompt of up to 4,000 characters in any language, plus either one first frame or up to four reference images (not both).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Output:&lt;/strong&gt; 720p H.264 MP4 at 24 fps, 16:9 (1280×720) or 9:16 (720×1280). No 1080p, no square.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Length:&lt;/strong&gt; 4 to 20 whole seconds. 5, 6, 8, 10, 15 and 20 come out exact; other values round up to the next step.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Price:&lt;/strong&gt; $0.037 per requested second, so 10 seconds is $0.37. Failed tasks are not charged.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reliability:&lt;/strong&gt; not every request succeeds. The model can refuse a prompt or an image, and generations occasionally hit temporary errors, so build in a retry. There is no &lt;code&gt;seed&lt;/code&gt; and no &lt;code&gt;negative_prompt&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;When to skip it: if you only want a handful of clips for yourself, paste these prompts into Meta's Muse app; the one-liners only work there anyway. And if you need 1080p, square video or a single clip longer than 20 seconds, Muse Video won't do it; pick another model.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://apimodels.app/models/muse-video" rel="noopener noreferrer"&gt;Muse Video model page&lt;/a&gt; has a browser playground and 18 sample clips with the exact prompts sent, and the &lt;a href="https://apimodels.app/docs/muse-video" rel="noopener noreferrer"&gt;API reference&lt;/a&gt; lists every field and error.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common errors
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;prompt must be at most 4000 characters&lt;/code&gt;&lt;/strong&gt;: several long-form prompts are longer than that. Split them by clip and keep the character block identical in each request.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;muse-video supports 16:9 (1280x720) or 9:16 (720x1280) only — set aspect_ratio to 16:9 or 9:16&lt;/code&gt;&lt;/strong&gt;: six prompts in the library were written for 4:3 or 3:4. The script maps them to the nearest supported ratio.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;muse-video does not support negative_prompt — describe what you want in prompt instead&lt;/code&gt;&lt;/strong&gt;: keep the "Avoid:" lines inside the prompt text, the way the library's prompts do.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;muse-video takes either a first frame (image_url) or reference images (images), not both&lt;/code&gt;&lt;/strong&gt;: use &lt;code&gt;images&lt;/code&gt; for a recurring character, &lt;code&gt;image_url&lt;/code&gt; only when the clip should start from that exact picture.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A task that ends in &lt;code&gt;failed&lt;/code&gt;&lt;/strong&gt;: read &lt;code&gt;data.failMsg&lt;/code&gt;. A refusal usually needs a rewritten prompt or a different image; a temporary error usually works on a retry a little later. Neither is charged.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Contribute
&lt;/h2&gt;

&lt;p&gt;Missing a prompt you liked, spotted a wrong credit, or wrote one of these and want it removed? Open an issue on the &lt;a href="https://github.com/apimodels/muse-video-prompts/issues" rel="noopener noreferrer"&gt;repo&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Which category should I dig into next: dance, POV or the long multi-clip scripts?&lt;/p&gt;




&lt;p&gt;I'm Lewis, and I build &lt;a href="https://apimodels.app" rel="noopener noreferrer"&gt;apimodels.app&lt;/a&gt;. The previous post in this series shows how to keep one character consistent across clips: &lt;a href="https://dev.to/super_lewis/build-a-consistent-ai-influencer-with-muse-image-and-muse-video-in-nodejs-039-per-clip-2cl0"&gt;Build a Consistent AI Influencer with Muse Image and Muse Video in Node.js&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance. The counts, limits and error messages were checked against the repo and the API reference on November 4, 2026.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>promptengineering</category>
      <category>opensource</category>
      <category>node</category>
    </item>
    <item>
      <title>Build a Consistent AI Influencer with Muse Image and Muse Video in Node.js, $0.39 per Clip</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Mon, 02 Nov 2026 00:43:20 +0000</pubDate>
      <link>https://dev.to/super_lewis/build-a-consistent-ai-influencer-with-muse-image-and-muse-video-in-nodejs-039-per-clip-2cl0</link>
      <guid>https://dev.to/super_lewis/build-a-consistent-ai-influencer-with-muse-image-and-muse-video-in-nodejs-039-per-clip-2cl0</guid>
      <description>&lt;p&gt;Muse Image has no seed, so the same prompt never draws the same person twice. That makes a recurring AI character, the kind an influencer account needs, the hard part. This tutorial builds one in about a hundred lines of Node.js: generate a character sheet with &lt;strong&gt;Muse Image&lt;/strong&gt;, cut it into a headshot and a turnaround, and hand both to &lt;strong&gt;Muse Video&lt;/strong&gt; as reference images to get a 10-second vertical clip of the same woman.&lt;/p&gt;

&lt;p&gt;Muse Image is Meta's image model (text-to-image, or one to four reference images, about 2.5 megapixels per image). Muse Video is Meta's video model (720p, 4 to 30 seconds, landscape or portrait, with an optional first frame or up to four reference images). The script calls both through one HTTP API.&lt;/p&gt;

&lt;p&gt;Disclosure: the endpoints and prices below are from apimodels.app, the API I work on. apimodels.app is a multi-model API gateway: one key and one OpenAI-compatible endpoint for 110+ image, video, audio and language models; the two Muse models are &lt;code&gt;muse-image&lt;/code&gt; and &lt;code&gt;muse-video&lt;/code&gt; there. This post is AI-assisted: drafted with an AI model from our own docs and test notes, then checked by hand.&lt;/p&gt;

&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Node.js 18 or newer (the script uses the built-in &lt;code&gt;fetch&lt;/code&gt; and top-level &lt;code&gt;await&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;sharp&lt;/code&gt; for cropping: &lt;code&gt;npm install sharp&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;An API key in &lt;code&gt;APIMODELS_API_KEY&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;About $0.39 per run: $0.02 for the sheet and $0.037 per requested second for the clip (10 seconds = $0.37), at list prices on 1 November 2026. Failed tasks are not charged.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 1: one character sheet, not one portrait
&lt;/h2&gt;

&lt;p&gt;Instead of asking for a nice photo, ask for a sheet: a large headshot in the left third and a front, side and back turnaround of the same woman on the right, on a plain light-grey background. One image, one person, every angle the video model needs.&lt;/p&gt;

&lt;p&gt;Three things in the prompt matter more than the rest:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;A concrete adult age.&lt;/strong&gt; "A 25-year-old woman." In our tests, words like "18", "student" or "freshman" made Muse draw someone visibly younger, so every character we make is 25.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The outfit with its limits spelled out.&lt;/strong&gt; Our date outfits show shoulders, arms and legs, and the prompt also says "modest neckline, no cleavage".&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;"Same face, same hair and same outfit in every view."&lt;/strong&gt; The sheet is only useful if the views agree.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Muse Image takes &lt;code&gt;aspect_ratio&lt;/code&gt; (&lt;code&gt;2:1&lt;/code&gt; here) and renders about 2.5 megapixels, so a 2:1 sheet comes back around 2240 x 1120. One request returns one image; &lt;code&gt;n&lt;/code&gt; above 1 is rejected.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: cut the sheet in two
&lt;/h2&gt;

&lt;p&gt;We pass the headshot and the turnaround as two separate reference images, each described in the video prompt. The cut is not at a fixed fraction: on our sheets the headshot ended anywhere between 39% and 44% of the width, and on one of them it touched the turnaround with no gap at all.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;splitSheet()&lt;/code&gt; in the script finds the first background gap to the right of the headshot. When there is no gap, it cuts where the two overlap least and prints a warning. We checked it against four of our own sheets: it landed inside the gap on the three that had one, and within a few pixels of our hand-made cut on the one that did not. It is still a heuristic, so open &lt;code&gt;ref-head.jpg&lt;/code&gt; and &lt;code&gt;ref-turnaround.jpg&lt;/code&gt; before you pay for a video.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: a time-coded video prompt with both references
&lt;/h2&gt;

&lt;p&gt;The video prompt starts by saying what each image is for (image 1 is the face, image 2 is the outfit and body), repeats the age, and then reads like a shot list: scene, camera, one beat per second and a half, how she behaves, the sound, the style, and an Avoid line. References go in &lt;code&gt;images&lt;/code&gt; as public URLs or base64 data URIs (PNG, JPEG or WebP, up to 20 MB each). The script sends data URIs, so nothing needs hosting.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;duration: 10&lt;/code&gt; with &lt;code&gt;aspect_ratio: "9:16"&lt;/code&gt; returns a 720 x 1280 MP4. Clips up to 10 seconds usually finish in one to two minutes; 15 to 30 seconds take three to seven.&lt;/p&gt;

&lt;h2&gt;
  
  
  The whole script
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// muse-influencer.mjs — Node 18+. Install: npm install sharp&lt;/span&gt;
&lt;span class="c1"&gt;// Run:     APIMODELS_API_KEY=your_key node muse-influencer.mjs&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;writeFile&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;node:fs/promises&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;API&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://api.apimodels.app&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;H&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`Bearer &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Content-Type&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;application/json&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt;

&lt;span class="c1"&gt;// Create a task and return its id. 4xx responses carry the reason in msg.&lt;/span&gt;
&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;API&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;POST&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;H&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;ok&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;code&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;status&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;j&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;// Poll until the task finishes. Failed tasks are not charged.&lt;/span&gt;
&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;wait&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;everyMs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;5000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;limitMs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;60&lt;/span&gt;&lt;span class="nx"&gt;_000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;until&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;limitMs&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nb"&gt;Date&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;until&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;data&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;API&lt;/span&gt;&lt;span class="p"&gt;}${&lt;/span&gt;&lt;span class="nx"&gt;path&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;?task_id=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;H&lt;/span&gt; &lt;span class="p"&gt;})).&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`unknown task &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;completed&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;failed&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;failMsg&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;failed&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; (not charged)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Promise&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setTimeout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;everyMs&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`still running after &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;limitMs&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;1000&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;s: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;// Split a Muse character sheet into the headshot (left) and the turnaround (right).&lt;/span&gt;
&lt;span class="c1"&gt;// The cut goes into the first background gap right of the headshot; if the headshot&lt;/span&gt;
&lt;span class="c1"&gt;// touches the turnaround, it goes where they overlap least. Always look at both crops.&lt;/span&gt;
&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;splitSheet&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;info&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;greyscale&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;resolveWithObject&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;info&lt;/span&gt;
  &lt;span class="c1"&gt;// Background grey = median of a thin strip along the top of the right half.&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;strip&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;h&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.03&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
  &lt;span class="nx"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sort&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;a&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;a&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;bg&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="c1"&gt;// Share of a column's pixels that are clearly not background.&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;busy&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;y&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;abs&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;y&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;bg&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;25&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.3&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;to&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.55&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;
  &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="nx"&gt;to&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;busy&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mf"&gt;0.05&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.005&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="k"&gt;break&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="nx"&gt;start&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;split&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;min&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;Infinity&lt;/span&gt;
    &lt;span class="k"&gt;for &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mf"&gt;0.5&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;busy&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;x&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;b&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nx"&gt;min&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;min&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;x&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;warn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`No clean gap after the headshot; cutting at x=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;, where they overlap least.`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;crop&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;left&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
    &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;buf&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;extract&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;left&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;top&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;jpeg&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;quality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;92&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;head&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;crop&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="na"&gt;turnaround&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;crop&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;SHEET_PROMPT&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`Character reference sheet, photorealistic photo, plain light-grey studio background, soft even lighting, no text, no labels, no watermark. Left third of the image: a large head-and-shoulders portrait (headshot) of the woman facing the camera. Right two-thirds: a full-body three-view turnaround of the same woman, front view, side view and back view, standing upright in a relaxed pose, evenly spaced, with clear space between the headshot and the turnaround. The woman is a 25-year-old American woman with a polished Instagram influencer look: soft glam makeup, glowing sun-kissed skin, groomed brows, glossy lips, a fit and slim figure. Long dark-brown hair in loose glossy waves. Outfit (a light summer date outfit that shows her shoulders, arms and legs but has a modest neckline, no cleavage): a white off-the-shoulder ribbed knit top, a high-waisted light-blue denim mini skirt, small gold hoop earrings, white low-top sneakers. Same face, same hair and same outfit in every view.`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;VIDEO_PROMPT&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`Reference images: image 1 is her headshot (face, features, hair, makeup); image 2 is a front / side / back three-view of the same woman in a light summer outfit (outfit, accessories, shoes, body). Keep exactly this face, hair and outfit in every frame. She is a 25-year-old woman with a polished Instagram look.

Outdoor café date. Scene: a sunny café terrace on a quiet European-style street, a small round marble table with two cappuccinos and a croissant, a striped awning, potted flowers, soft morning sun.
Camera: the viewer's point of view sitting across the small table, very close to her, eye level.
0.0–1.5 s: she rests her chin on her interlaced fingers, watching the lens with a slow half-smile.
1.5–3.0 s: she reaches across, takes the viewer's cappuccino instead of her own and sips it, eyes on the lens over the cup.
3.0–4.5 s: she wipes a little milk foam from her lip with her thumb and laughs.
4.5–6.0 s: she says, teasing: "Mine's better." and slides her own cup toward the camera.
6.0–8.0 s: she leans in close to the lens on her elbows, her bare shoulders catching the sun, lightly bites her lower lip and holds eye contact.
8.0–10.0 s: she leans back, tucks her hair behind her ear and gives one playful wink.
Lighting: soft warm morning sun, gentle highlights on her hair and shoulders.
Flirt cues (natural and playful, never explicit): long lingering eye contact with the lens, a slow half-smile, lightly biting her lower lip once, glancing down and then back up through her lashes, leaning in close to the lens as if sharing a secret, at most one playful wink. She is clearly enjoying the viewer's company.

Audio: light French café jazz and soft street ambience; her line is clear, natural American English; no other voices, no laugh track.
Style: realistic Instagram Reel shot on an iPhone, vertical 9:16, warm natural colors, crisp focus on her face, gentle handheld motion, one continuous take.
Avoid: changing her face or outfit, cleavage, lingerie, swimwear, see-through fabric, kissing, touching her own body suggestively, extra fingers, warped hands, strangers staring at the camera, on-screen text, subtitles, watermark.`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// 1. One character sheet: $0.02.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;sheet&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;wait&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/v1/images/generations&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/v1/images/generations&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;muse-image&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;SHEET_PROMPT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;aspect_ratio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;2:1&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}));&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;sheetBuf&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;sheet&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;resultUrls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;])).&lt;/span&gt;&lt;span class="nf"&gt;arrayBuffer&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;writeFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;sheet.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;sheetBuf&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="c1"&gt;// 2. Split it into two reference images. Open both files before going on.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;head&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;turnaround&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;splitSheet&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;sheetBuf&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;writeFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ref-head.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;head&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;writeFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ref-turnaround.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;turnaround&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`sheet saved, cut at x=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;split&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="c1"&gt;// 3. A 10-second vertical clip with both references: 10 x $0.037 = $0.37.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;dataUri&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;data:image/jpeg;base64,&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toString&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;base64&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;video&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;wait&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/v1/video/generations&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/v1/video/generations&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;muse-video&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;VIDEO_PROMPT&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;images&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nf"&gt;dataUri&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;head&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="nf"&gt;dataUri&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;turnaround&lt;/span&gt;&lt;span class="p"&gt;)],&lt;/span&gt;
  &lt;span class="na"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;aspect_ratio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;9:16&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}));&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;writeFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;clip.mp4&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;video&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;resultUrls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;])).&lt;/span&gt;&lt;span class="nf"&gt;arrayBuffer&lt;/span&gt;&lt;span class="p"&gt;()));&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;saved clip.mp4&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Check the result
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Open &lt;code&gt;sheet.jpg&lt;/code&gt;: one woman, a headshot on the left, three full-body views on the right, no text.&lt;/li&gt;
&lt;li&gt;Open the two crops: the whole face in &lt;code&gt;ref-head.jpg&lt;/code&gt;, all three views in &lt;code&gt;ref-turnaround.jpg&lt;/code&gt;. A sliver of the other half at the edge is fine.&lt;/li&gt;
&lt;li&gt;Watch &lt;code&gt;clip.mp4&lt;/code&gt;: same face, hair and outfit as the sheet, 720 x 1280, and the spoken line from the prompt.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2xthnmawqn7x8urkxbn8.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2xthnmawqn7x8urkxbn8.jpg" alt="A Muse Image character sheet like the one Step 1 produces: a headshot on the left and a side, front and back turnaround on the right. AI-generated with Muse Image." width="800" height="400"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9zvafsq4rgptl7z3mrr2.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F9zvafsq4rgptl7z3mrr2.jpg" alt="A frame from a clip made with this pipeline and this video prompt: a woman at an outdoor café table drinking from a pink cup and looking at the camera. AI-generated with Muse Video." width="720" height="1280"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Errors you will probably hit
&lt;/h2&gt;

&lt;p&gt;All of these come back as HTTP 400 with the reason in &lt;code&gt;msg&lt;/code&gt;, before anything is generated or charged:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;muse-video takes either a first frame (image_url) or reference images (images), not both&lt;/code&gt;: pick one. An array of images always means references.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;duration must be a whole number of seconds from 4 to 30&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;muse-video supports 16:9 (1280x720) or 9:16 (720x1280) only — set aspect_ratio to 16:9 or 9:16&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;muse-image generates one image per request (got n=2); submit one request per image&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;muse-image does not support seed: results are not repeatable&lt;/code&gt;: there is no seed, which is the reason this tutorial exists.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Limits worth knowing before you build on it
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Muse Image: about 2.5 megapixels, no 4K, no transparent background, no negative prompt, no seed, no masks.&lt;/li&gt;
&lt;li&gt;Muse Video: 720p only, 16:9 or 9:16 only, at most four reference images, and either references or one first frame.&lt;/li&gt;
&lt;li&gt;Past ten seconds, Muse cuts to a new shot around the 10- and 20-second marks, so a 30-second clip is three shots.&lt;/li&gt;
&lt;li&gt;If the prompt states a total length that disagrees with &lt;code&gt;duration&lt;/code&gt; (say "about 7.5 seconds" on an 8-second request), Muse follows the prompt and the clip comes back shorter.&lt;/li&gt;
&lt;li&gt;Not every request succeeds. Failures are not charged, but build a retry.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When not to use this
&lt;/h2&gt;

&lt;p&gt;Skip it if you need 4K stills, a single unbroken shot longer than ten seconds, or guaranteed output on every request. And do not build the character from a real person's photos: an AI influencer should be invented, not copied from someone who never agreed to it.&lt;/p&gt;

&lt;p&gt;The model pages list every parameter and limit: &lt;a href="https://apimodels.app/models/muse-image" rel="noopener noreferrer"&gt;Muse Image on apimodels.app&lt;/a&gt; and &lt;a href="https://apimodels.app/models/muse-video" rel="noopener noreferrer"&gt;Muse Video on apimodels.app&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;How are you keeping a recurring character consistent across clips: reference sheets, first frames, or something else?&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Your AI Eraser Redraws the Whole Photo: Inside a Label-Then-Edit Object Remover</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Thu, 22 Oct 2026 13:55:15 +0000</pubDate>
      <link>https://dev.to/super_lewis/your-ai-eraser-redraws-the-whole-photo-inside-a-label-then-edit-object-remover-g07</link>
      <guid>https://dev.to/super_lewis/your-ai-eraser-redraws-the-whole-photo-inside-a-label-then-edit-object-remover-g07</guid>
      <description>&lt;p&gt;This week two of our own help pages contradicted each other. MagicRemover's passersby page promised that only the area you brush changes; the people page said the whole image may shift slightly. Only one could be true, so I read our pipeline end to end instead of trusting either page.&lt;/p&gt;

&lt;p&gt;The people page was right. An instruction-based eraser doesn't fill a hole: it re-renders the entire photo from a text instruction, and your brush stroke only decides what that instruction says. This post walks through how that pipeline works in production, why it was worth switching to, and what it costs the pixels you never touched.&lt;/p&gt;

&lt;p&gt;Disclosure: I build MagicRemover, the browser-based AI eraser this post is about. The draft was written with AI assistance and every code excerpt and number was checked against the repository and production logs.&lt;/p&gt;

&lt;h2&gt;
  
  
  Two ways to build an eraser
&lt;/h2&gt;

&lt;p&gt;There are two broad designs, and they fail in opposite ways.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Mask inpainting&lt;/strong&gt; takes the image plus a binary mask. The model generates pixels only inside the mask, and the pipeline copies everything outside it straight from the original. Outside the brush, the result is pixel-identical to your upload. The weakness is context: if you brush a person but not their shadow, the shadow stays, because the model was only allowed to touch the mask.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Instruction editing&lt;/strong&gt; takes the image plus a sentence such as "remove the man in the blue shirt". The model returns a complete new image. Because it understands the scene, it can remove the shadow and the reflection you didn't brush. The cost is that every pixel in the output was generated, including the ones you wanted left alone.&lt;/p&gt;

&lt;p&gt;MagicRemover's photo tools ran on mask inpainting until May 2026. In early May we added a labelling step; in June we replaced the backend with an instruction-following image editor that takes only an image and a prompt. Fills got noticeably more coherent, especially around shadows. What we didn't do was update every sentence on the site that still described the old behaviour.&lt;/p&gt;

&lt;h2&gt;
  
  
  How a brush stroke becomes a sentence
&lt;/h2&gt;

&lt;p&gt;Here is the path a removal takes today.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. The browser shrinks the photo to about 1 megapixel
&lt;/h3&gt;

&lt;p&gt;Every upload goes through one helper before anything leaves the browser:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="cm"&gt;/** Cap uploads at ~1 megapixel (matches the model's ~1MP working resolution). */&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;MAX_PIXELS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="nx"&gt;_000_000&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="cm"&gt;/** Secondary edge cap for very wide panoramas. */&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;MAX_EDGE&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2048&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;fitTarget&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;number&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kr"&gt;number&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;pixels&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;pixels&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;MAX_PIXELS&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sqrt&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;MAX_PIXELS&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;pixels&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;longest&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;h&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;longest&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;MAX_EDGE&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt; &lt;span class="o"&gt;*=&lt;/span&gt; &lt;span class="nx"&gt;MAX_EDGE&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="nx"&gt;longest&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;width&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;w&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt;&lt;span class="p"&gt;)),&lt;/span&gt;
    &lt;span class="na"&gt;height&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;max&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;h&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;scale&lt;/span&gt;&lt;span class="p"&gt;)),&lt;/span&gt;
  &lt;span class="p"&gt;};&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A 4000×3000 phone photo becomes 1155×866. There is no point sending more: the editing model works at roughly one megapixel and returns an image at that size, so extra pixels would only make the request slower and bigger.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. The browser sends two copies
&lt;/h3&gt;

&lt;p&gt;The editor posts the clean, downscaled original and a second copy with the user's brush strokes filled solid red. The red copy is never edited; it exists so the next step can see what was marked.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. A vision model names what is under the red
&lt;/h3&gt;

&lt;p&gt;A vision-language model receives both images and a tool-specific instruction. The people tool's instruction starts like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Identify the person or people inside the red-marked region of image 2.
Your reply MUST uniquely identify ONLY the red-marked subjects so they can
be deleted without affecting any similar-looking person ...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It answers with a short label, along the lines of "the man in the blue shirt on the left". In the nine removals logged since our latest deploy, all nine got a label, and the labelling step took about 2.5 seconds on average. That's a small sample, but it matches what we see day to day.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. The editor gets the clean photo and a sentence
&lt;/h3&gt;

&lt;p&gt;The label is dropped into a per-tool template. The people tool uses:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Completely remove {label} from the photo, leaving no trace, shadow, or
outline, and realistically reconstruct the background and scene behind
them. Keep everyone and everything else exactly unchanged.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The editor receives the clean original, never the red copy, so there's no risk of red pixels leaking into the result.&lt;/p&gt;

&lt;h3&gt;
  
  
  5. If labelling fails, fall back to the red copy
&lt;/h3&gt;

&lt;p&gt;When the vision model can't produce a label, the editor gets the red-marked copy and a generic instruction instead:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Completely remove whatever the red area covers, then remove the red marking
itself and fill the space with background that naturally matches the
surroundings. Leave no trace, shadow, or outline. Keep everything outside
the red area exactly unchanged.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;That keeps the tool working when the labeller is down, at the cost of slightly worse results, because "the red area" is a vaguer target than "the man in the blue shirt".&lt;/p&gt;

&lt;h2&gt;
  
  
  Why the whole photo changes
&lt;/h2&gt;

&lt;p&gt;Notice the last sentence of both prompts: "Keep everything else exactly unchanged." It's a request, not a guarantee. The model regenerates the full frame, and nothing in the pipeline copies the original pixels back.&lt;/p&gt;

&lt;p&gt;In practice the untouched parts of the photo look the same, but they aren't bit-identical. The things most likely to drift are fine repeating textures (fabric, foliage, gravel), small text away from the brushed area, and faces in the background. Colour can shift slightly across the whole image too.&lt;/p&gt;

&lt;p&gt;That's acceptable for the use most people have: a holiday photo going to Instagram or a chat. It's not acceptable for an e-commerce product shot that has to match its colour profile, or a scanned document where every other character must survive untouched. So the pages now say it plainly: changes concentrate in the brushed area, the rest looks the same but isn't pixel-identical.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why we don't paste the original back (yet)
&lt;/h2&gt;

&lt;p&gt;The obvious fix is to composite: keep the edited pixels inside the brushed area, take the original's pixels everywhere else. It's about twenty lines with sharp. This is an example, not production code; it's tested with sharp 0.34.5 on Node 24:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;sharp&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;sharp&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;original.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="c1"&gt;// 1. Grow the brushed area so the seam lands outside the object's edge:&lt;/span&gt;
&lt;span class="c1"&gt;//    blur the mask, then turn every non-black pixel white.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;blurred&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;mask.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;blur&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;grown&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;blurred&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;threshold&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="c1"&gt;// 2. Feather the grown edge and keep a single raw channel to use as alpha.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;alpha&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;grown&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;blur&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;extractChannel&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="c1"&gt;// 3. The edited image at the original's size, with that alpha channel.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;rgb&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;edited.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;resize&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;removeAlpha&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;patch&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;rgb&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;joinChannel&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;alpha&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;width&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;height&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;channels&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;png&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
  &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toBuffer&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;

&lt;span class="c1"&gt;// 4. Lay the patch over the untouched original.&lt;/span&gt;
&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;sharp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;original.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;composite&lt;/span&gt;&lt;span class="p"&gt;([{&lt;/span&gt; &lt;span class="na"&gt;input&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;patch&lt;/span&gt; &lt;span class="p"&gt;}]).&lt;/span&gt;&lt;span class="nf"&gt;toFile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;result.png&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two gotchas cost me time while testing it. sharp applies operations in a fixed internal order, not in the order you chain them, so blur, threshold and blur again only behave as written when each runs in its own pipeline. And &lt;code&gt;removeAlpha()&lt;/code&gt; chained after &lt;code&gt;joinChannel()&lt;/code&gt; quietly strips the channel you just joined, which is why step 3 builds the RGB buffer first.&lt;/p&gt;

&lt;p&gt;So why isn't this in production? Because it gives back what instruction editing bought us.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Shadows come back.&lt;/strong&gt; The editor removes a person's shadow even if the user brushed only the person. Composite outside the mask and the shadow is pasted right back from the original. Growing the mask helps a little; it can't know where a long evening shadow ends.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Seams appear.&lt;/strong&gt; The editor relights the area it rebuilt. Where its version meets the original, a feathered edge turns a sharp seam into a soft halo, but on a flat sky or a white wall you can still see the step in brightness.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Resolution stays the same.&lt;/strong&gt; Compositing keeps the original pixels outside the mask, but if you composite onto the downscaled original, the output is still about one megapixel. To get full resolution back you'd upscale the patch onto the full-size upload, and a 1 MP patch dropped into a 12 MP photo looks soft next to its neighbours.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A hybrid is on our list: composite only when the brushed area is small and far from strong shadows, and leave the full regeneration otherwise. Until then, the honest move was to change the copy rather than the pipeline.&lt;/p&gt;

&lt;h2&gt;
  
  
  When an instruction editor is the wrong tool
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;You need everything outside the mask to stay bit-identical: product photos with strict colour, documents, anything used as a record. Use mask inpainting with compositing, or Photoshop's Remove Tool on the full-resolution file.&lt;/li&gt;
&lt;li&gt;You need print resolution. Any eraser that works at about one megapixel, MagicRemover included, will hand you back a smaller image.&lt;/li&gt;
&lt;li&gt;The image is dense with text you want to keep. Regenerating the frame can subtly alter characters far from the brush.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Where MagicRemover fits
&lt;/h2&gt;

&lt;p&gt;MagicRemover is a browser-based AI eraser: you upload a photo, brush over a person, object, text, sticker or watermark, and it returns the photo with that thing removed, usually in well under a minute. It's built for photos headed to the web and social media, with 2 free removals a day without an account and 2 more after Google sign-in. Don't use it when you need full resolution or pixel-exact output outside the brushed area; for those jobs a desktop editor on the original file is the right call.&lt;/p&gt;

&lt;p&gt;The tool walkthroughs, including the people remover discussed above, are at &lt;a href="https://magicremover.org/remove-people-from-photo" rel="noopener noreferrer"&gt;magicremover.org&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;If you've shipped an eraser yourself: do you composite the original back, and how do you deal with shadows that fall outside the user's mask?&lt;/p&gt;

</description>
      <category>ai</category>
      <category>machinelearning</category>
      <category>showdev</category>
      <category>softwaredevelopment</category>
    </item>
    <item>
      <title>FLUX 3 Max Keyframes Explained: 24 fps Frame Math, Validation Rules and a Node.js Helper</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Wed, 21 Oct 2026 01:30:12 +0000</pubDate>
      <link>https://dev.to/super_lewis/flux-3-max-keyframes-explained-24-fps-frame-math-validation-rules-and-a-nodejs-helper-4pjm</link>
      <guid>https://dev.to/super_lewis/flux-3-max-keyframes-explained-24-fps-frame-math-validation-rules-and-a-nodejs-helper-4pjm</guid>
      <description>&lt;p&gt;FLUX 3 Max is a fast video generation model by Black Forest Labs (a latency-optimized variant of FLUX 3 Video). Its keyframes-to-video mode lets you pin 1 to 10 images to exact positions in a 5 to 20 second clip and have the model generate the motion between them. This post is about that mode only: how positions are counted, which requests get rejected and why, and a small Node.js helper that turns a list of images into valid keyframes.&lt;/p&gt;

&lt;p&gt;Disclosure: I work on apimodels.app, a multi-model API where FLUX 3 Max is available as &lt;code&gt;flux-3-max&lt;/code&gt;. The request shapes and error messages below are the ones that API returns; I tested them on 20 October 2026.&lt;/p&gt;

&lt;h2&gt;
  
  
  Positions are frame numbers at 24 fps
&lt;/h2&gt;

&lt;p&gt;A keyframe is an image plus a position, and the position is a frame number in the 24 fps output, not a timestamp:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"https://example.com/a.jpg"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"frame_index"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;72&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The rules that follow from that:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Frame &lt;code&gt;0&lt;/code&gt; is the first frame of the video.&lt;/li&gt;
&lt;li&gt;The last frame is &lt;code&gt;duration × 24&lt;/code&gt;. A 5-second clip ends at frame 120, a 10-second clip at 240, the 20-second maximum at 480.&lt;/li&gt;
&lt;li&gt;A position must be a whole number in that range, and two keyframes cannot share one.&lt;/li&gt;
&lt;li&gt;Order in the array does not matter; they are sorted by position before generation.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Converting from seconds is &lt;code&gt;Math.round(seconds × 24)&lt;/code&gt;, so 2.5 s is frame 60 and 3 s is frame 72. apimodels.app accepts &lt;code&gt;{ image_url, time }&lt;/code&gt; with &lt;code&gt;time&lt;/code&gt; in seconds and does that conversion for you, which is handy when your storyboard is written in seconds. You can mix both forms in one array.&lt;/p&gt;

&lt;h2&gt;
  
  
  Keyframes replace first and last frame
&lt;/h2&gt;

&lt;p&gt;FLUX 3 Max has a separate image-to-video mode driven by &lt;code&gt;first_frame_url&lt;/code&gt; and an optional &lt;code&gt;last_frame_url&lt;/code&gt;. The two modes do not combine: if a request carries both a &lt;code&gt;keyframes&lt;/code&gt; array and a first or last frame, the API returns 400 rather than guessing which one you meant.&lt;/p&gt;

&lt;p&gt;To lock both ends and something in the middle, put all of them in &lt;code&gt;keyframes&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="nl"&gt;"keyframes"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"https://example.com/start.jpg"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"time"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"https://example.com/middle.jpg"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"time"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"image_url"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"https://example.com/end.jpg"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"time"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;with &lt;code&gt;"duration": 6&lt;/code&gt;, so the last image sits on frame 144, the final frame.&lt;/p&gt;

&lt;h2&gt;
  
  
  The 400s you will meet
&lt;/h2&gt;

&lt;p&gt;Every one of these is checked before the task is created, so a rejected request costs nothing. The messages are what apimodels.app returns:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;You sent&lt;/th&gt;
&lt;th&gt;Message&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;keyframes: []&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;keyframes must be a non-empty array of {image_url, frame_index} (or {image_url, time} in seconds)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;11 or more keyframes&lt;/td&gt;
&lt;td&gt;keyframes accepts at most 10 images (got 11)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;time: 7&lt;/code&gt; with &lt;code&gt;duration: 6&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;keyframes[2] frame position must be a whole frame from 0 to 144 (duration × 24 fps; got 7)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Two keyframes at frame 72&lt;/td&gt;
&lt;td&gt;keyframes[1] repeats frame 72; each keyframe needs its own position&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;A keyframe with no position&lt;/td&gt;
&lt;td&gt;keyframes[0] needs frame_index (24 fps frame number) or time (seconds)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;keyframes&lt;/code&gt; plus &lt;code&gt;first_frame_url&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Send either keyframes or first_frame_url / last_frame_url, not both&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Several images in &lt;code&gt;images&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;takes one first frame (plus an optional last frame) or a keyframes array, not 3 reference images&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The out-of-range one is the most common: you shorten &lt;code&gt;duration&lt;/code&gt; from 10 to 6 and forget that a keyframe at 8 seconds no longer fits. The fix is to compute positions from the duration instead of hardcoding them.&lt;/p&gt;

&lt;h2&gt;
  
  
  A helper that spaces images evenly
&lt;/h2&gt;

&lt;p&gt;Most storyboards are "these images, in this order, evenly across the clip". This helper does that and stays inside the rules: first image on frame 0, last image on the final frame, the rest spread between them, no duplicates.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;FPS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;24&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// images: array of URLs in story order (1 to 10)&lt;/span&gt;
&lt;span class="c1"&gt;// duration: whole seconds, 5 to 20&lt;/span&gt;
&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;evenKeyframes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;1 to 10 images&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;last&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;duration&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;FPS&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[{&lt;/span&gt; &lt;span class="na"&gt;image_url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="na"&gt;frame_index&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="p"&gt;}];&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;i&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;image_url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;frame_index&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;round&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;i&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nx"&gt;last&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;images&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)),&lt;/span&gt;
  &lt;span class="p"&gt;}));&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;evenKeyframes&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;a.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;b.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;c.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;d.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
&lt;span class="c1"&gt;// frames 0, 48, 96, 144&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Even spacing is a starting point, not a rule. If a shot needs to linger, move its keyframe later; the model has more frames to work with on that stretch.&lt;/p&gt;

&lt;h2&gt;
  
  
  Full request with polling
&lt;/h2&gt;

&lt;p&gt;The API is asynchronous: create a task, then poll the same endpoint with the task id (or pass &lt;code&gt;callback_url&lt;/code&gt; to get the result POSTed to you).&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;API&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://api.apimodels.app/v1/video/generations&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;headers&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`Bearer &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Content-Type&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;application/json&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;};&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;duration&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;create&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;API&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;POST&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="na"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;flux-3-max&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;A smooth cinematic transition from a casual kitchen snapshot to a premium &lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
      &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;studio product shot, light sweeps across the product&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nx"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;resolution&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;720p&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;keyframes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;evenKeyframes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
      &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://example.com/start.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://example.com/mid.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://example.com/end.jpg&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
      &lt;span class="nx"&gt;duration&lt;/span&gt;
    &lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="na"&gt;generate_audio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}),&lt;/span&gt;
&lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;create&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;code&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;create&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="c1"&gt;// the 400s above land here&lt;/span&gt;

&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;task&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;do&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Promise&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;setTimeout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;3000&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="nx"&gt;task&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;API&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;?task_id=&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;create&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;taskId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;headers&lt;/span&gt; &lt;span class="p"&gt;}).&lt;/span&gt;&lt;span class="nf"&gt;then&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;())).&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;while &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;pending&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;failed&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;failMsg&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;task&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;resultUrls&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;]);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In my run (two square product images at 0 s and 5 s, 5 seconds, 720p, audio off, &lt;code&gt;reasoning_level: "low"&lt;/code&gt;) the video was ready 19 seconds after the create request, at 960×960. One run is a spot check, not a benchmark. With &lt;code&gt;aspect_ratio&lt;/code&gt; left at &lt;code&gt;auto&lt;/code&gt; the output follows the first image, so square inputs give a square video.&lt;/p&gt;

&lt;h2&gt;
  
  
  Prompting between keyframes
&lt;/h2&gt;

&lt;p&gt;The keyframes fix what the frames look like; the prompt is where you describe the motion that connects them. A few things that help:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Describe the transition, not the images. "Light sweeps across as the camera pushes in" tells the model something the images cannot.&lt;/li&gt;
&lt;li&gt;Keep subject, lighting and lens consistent across keyframe images when you want continuity. Very different images force a transition the model has to invent.&lt;/li&gt;
&lt;li&gt;Leave &lt;code&gt;generate_audio&lt;/code&gt; on and describe the sound ("soft whoosh, quiet room tone") if you want audio that follows the motion; turn it off if you will score the video yourself.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  When keyframes are the wrong tool
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;You want the opening image to drive the whole clip and do not care about intermediate frames: use plain image-to-video with &lt;code&gt;first_frame_url&lt;/code&gt;, which is a simpler request.&lt;/li&gt;
&lt;li&gt;You need the same character across many separate shots, or more than 20 seconds in one pass: FLUX 3 Max takes at most 10 images and 20 seconds. Seedance 2.5 accepts up to 50 reference assets and 30 seconds.&lt;/li&gt;
&lt;li&gt;You need to transfer motion from a reference video: FLUX 3 Max does not accept reference videos.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Cost
&lt;/h2&gt;

&lt;p&gt;On apimodels.app FLUX 3 Max is billed per second of output, and keyframes cost the same as the other modes: $0.221/s at 720p and $0.377/s at 1080p, so the 6-second 720p example is $1.33. Until 7 November 2026 (00:00 UTC) there is a special price of $0.085/s and $0.145/s. Failed generations and rejected requests are not charged.&lt;/p&gt;

&lt;p&gt;Parameters, pricing and a comparison with Seedance 2.5, Kling V3 and Veo 3.1 are in the &lt;a href="https://apimodels.app/flux-3-max-api" rel="noopener noreferrer"&gt;FLUX 3 Max API guide&lt;/a&gt;; the playground with a keyframe uploader is on the &lt;a href="https://apimodels.app/models/flux-3-max" rel="noopener noreferrer"&gt;FLUX 3 Max model page&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Written with AI assistance for structure and wording; the code, error messages and timing come from my own test runs.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>javascript</category>
      <category>machinelearning</category>
      <category>node</category>
    </item>
    <item>
      <title>Build a Grok Voice 3.0 Voice Agent in Node.js: Mic In, Speaker Out, Live Transcripts</title>
      <dc:creator>Super Lewis</dc:creator>
      <pubDate>Sat, 17 Oct 2026 15:46:39 +0000</pubDate>
      <link>https://dev.to/super_lewis/build-a-grok-voice-30-voice-agent-in-nodejs-mic-in-speaker-out-live-transcripts-5al6</link>
      <guid>https://dev.to/super_lewis/build-a-grok-voice-30-voice-agent-in-nodejs-mic-in-speaker-out-live-transcripts-5al6</guid>
      <description>&lt;p&gt;You open a WebSocket to a speech-to-speech model, start streaming your microphone, and three things go wrong at once: the model answers itself because it hears its own voice through your speakers, your transcript prints the same sentence a dozen times, and when you ask "who are you?" it describes its origin wrong. All three have small, specific fixes, and this tutorial builds them in from the start.&lt;/p&gt;

&lt;p&gt;Grok Voice 3.0 is xAI's speech-to-speech model for realtime voice agents, released on 14 October 2026: you stream 16-bit PCM audio over one WebSocket and the same model answers with audio, using events that xAI describes as compatible with the OpenAI Realtime API. By the end you will have a terminal voice agent in Node.js that listens to your mic, plays replies, prints live transcripts and calls a function, plus the browser variant that never exposes your API key.&lt;/p&gt;

&lt;p&gt;Disclosure: I work on apimodels.app, the API gateway the examples connect to, and the relay behaviour described below comes from its source code.&lt;/p&gt;

&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Node.js 18 or newer and the &lt;code&gt;ws&lt;/code&gt; package 8.x (&lt;code&gt;pnpm add ws&lt;/code&gt; or &lt;code&gt;npm install ws&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;SoX on your PATH for microphone and speaker I/O: &lt;code&gt;brew install sox&lt;/code&gt; on macOS, &lt;code&gt;sudo apt install sox&lt;/code&gt; on Debian or Ubuntu. The script uses its &lt;code&gt;rec&lt;/code&gt; and &lt;code&gt;play&lt;/code&gt; commands.&lt;/li&gt;
&lt;li&gt;An apimodels.app API key in the &lt;code&gt;APIMODELS_API_KEY&lt;/code&gt; environment variable, with at least one minute of balance ($0.104), which the server checks before it accepts the connection&lt;/li&gt;
&lt;li&gt;Headphones. With open speakers the model hears its own voice and keeps answering itself.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  How a Grok Voice session flows
&lt;/h2&gt;

&lt;p&gt;A Grok Voice 3.0 session is a single WebSocket that carries JSON events in both directions, with audio inside the events as base64. You connect, send one &lt;code&gt;session.update&lt;/code&gt; to set the voice, instructions and turn detection, then keep appending microphone audio with &lt;code&gt;input_audio_buffer.append&lt;/code&gt;. With &lt;code&gt;turn_detection: {"type": "server_vad"}&lt;/code&gt; the server decides when you stopped talking and starts answering on its own; you never send a "done" signal.&lt;/p&gt;

&lt;p&gt;The answer arrives as a stream: &lt;code&gt;response.output_audio.delta&lt;/code&gt; events carry base64 PCM chunks to play in order, &lt;code&gt;response.output_audio_transcript.delta&lt;/code&gt; events carry the text of what the model is saying, and &lt;code&gt;response.done&lt;/code&gt; closes the turn. Your own speech comes back as &lt;code&gt;conversation.item.input_audio_transcription.updated&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;That last event is where the "same sentence a dozen times" bug comes from. xAI's input transcription is cumulative: each &lt;code&gt;updated&lt;/code&gt; event carries the whole transcript so far, which may correct earlier words, not a delta to append. Code written for OpenAI-style incremental deltas prints every partial version.&lt;/p&gt;

&lt;p&gt;The default audio format is 16-bit PCM, 24 kHz, mono, little-endian, in both directions, so 100 ms of audio is 2,400 samples or 4,800 bytes.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Connect and surface handshake errors
&lt;/h2&gt;

&lt;p&gt;Save the four blocks in Steps 1 to 4 into one file, &lt;code&gt;voice-agent.mjs&lt;/code&gt;, in order. This first block opens the socket with your key in the &lt;code&gt;Authorization&lt;/code&gt; header and prints the server's reason if the handshake is rejected.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// voice-agent.mjs (example). Node 18+, ws 8.x, SoX on PATH. Use headphones.&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;spawn&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;node:child_process&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nx"&gt;WebSocket&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ws&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;URL&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;wss://api.apimodels.app/v1/realtime?model=grok-voice-3.0&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;SOX&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-q&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-t&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;raw&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-r&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;24000&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-e&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;signed-integer&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-b&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;16&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-c&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;1&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;-&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ws&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;WebSocket&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;URL&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`Bearer &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;send&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;readyState&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;WebSocket&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;OPEN&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;event&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;

&lt;span class="c1"&gt;// A rejected handshake is a plain HTTP response with a JSON body:&lt;/span&gt;
&lt;span class="c1"&gt;// 401 bad key, 400 wrong model, 402 less than one minute of balance, 429 more than 5 sessions.&lt;/span&gt;
&lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;unexpected-response&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;_req&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;""&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;data&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="nx"&gt;c&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
  &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;end&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`handshake rejected: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;statusCode&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;body&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;exit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;With a wrong or missing key you see &lt;code&gt;handshake rejected: 401 {"error":{"type":"invalid_api_key","code":"invalid_api_key","message":"Invalid or missing API key / client secret."}}&lt;/code&gt; and nothing is charged.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Configure the session, identity included
&lt;/h2&gt;

&lt;p&gt;As soon as the socket opens, send &lt;code&gt;session.update&lt;/code&gt;. The &lt;code&gt;voice&lt;/code&gt;, &lt;code&gt;instructions&lt;/code&gt; and &lt;code&gt;turn_detection&lt;/code&gt; fields sit directly under &lt;code&gt;session&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;open&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;session.update&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;session&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;voice&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;eve&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="c1"&gt;// one of 28 built-in voices; each one speaks every supported language&lt;/span&gt;
      &lt;span class="na"&gt;instructions&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;You are Grok Voice 3.0, a realtime voice assistant built by xAI, &lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt;
        &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;answering for the Acme help desk. Keep answers under three sentences.&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;turn_detection&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;server_vad&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;audio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="na"&gt;input&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;audio/pcm&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;rate&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;24000&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="na"&gt;output&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;audio/pcm&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;rate&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;24000&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="na"&gt;tools&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="p"&gt;{&lt;/span&gt;
          &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;function&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;get_order_status&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="na"&gt;description&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Look up an order by its id&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
          &lt;span class="na"&gt;parameters&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;object&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="na"&gt;properties&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;order_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;string&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
            &lt;span class="na"&gt;required&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;order_id&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
          &lt;span class="p"&gt;},&lt;/span&gt;
        &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first sentence of &lt;code&gt;instructions&lt;/code&gt; is the fix for the third bug. Setting custom instructions replaces the model's default persona, and without an identity in your prompt the model may describe its origin incorrectly when a caller asks who it is. If your product has its own persona ("Mia from Acme"), write that instead; just write something.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Stream the microphone in 100 ms frames
&lt;/h2&gt;

&lt;p&gt;Start the mic only after the server confirms the session with &lt;code&gt;session.updated&lt;/code&gt;, so your first words are not processed with default settings. SoX's &lt;code&gt;rec&lt;/code&gt; writes raw PCM to stdout; the code cuts it into 4,800-byte frames so no 16-bit sample is ever split across two events.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;mic&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;startMic&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;mic&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;spawn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;rec&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;SOX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;stdio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ignore&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;pipe&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ignore&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt; &lt;span class="c1"&gt;// raw 16-bit PCM, 24 kHz, mono&lt;/span&gt;
  &lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;pending&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;alloc&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;mic&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;data&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nx"&gt;pending&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;concat&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="nx"&gt;pending&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;chunk&lt;/span&gt;&lt;span class="p"&gt;]);&lt;/span&gt;
    &lt;span class="k"&gt;while &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;pending&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;4800&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="c1"&gt;// 100 ms = 2,400 samples x 2 bytes&lt;/span&gt;
      &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;input_audio_buffer.append&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;audio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;pending&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;subarray&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;4800&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;toString&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;base64&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt;
      &lt;span class="nx"&gt;pending&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;pending&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;subarray&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4800&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;newSpeaker&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;spawn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;play&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;SOX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;stdio&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;pipe&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ignore&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;ignore&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt; &lt;span class="c1"&gt;// reads raw PCM on stdin&lt;/span&gt;
  &lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdin&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;error&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{});&lt;/span&gt; &lt;span class="c1"&gt;// ignore EPIPE after we kill it for a barge-in&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;p&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;speaker&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;newSpeaker&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 4: Play replies, print transcripts, answer function calls
&lt;/h2&gt;

&lt;p&gt;One message handler does the rest. Note the transcription case: it overwrites the current line instead of appending, because each event already holds the full sentence.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;message&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ev&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toString&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;
  &lt;span class="k"&gt;switch &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;type&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;session.updated&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;mic&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nf"&gt;startMic&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;listening... (Ctrl+C to hang up)&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;input_audio_buffer.speech_started&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="c1"&gt;// Caller started talking over the model: drop queued audio.&lt;/span&gt;
      &lt;span class="c1"&gt;// (Our browser playground handles this event the same way.)&lt;/span&gt;
      &lt;span class="nx"&gt;speaker&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
      &lt;span class="nx"&gt;speaker&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;newSpeaker&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;conversation.item.input_audio_transcription.updated&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;conversation.item.input_audio_transcription.completed&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="c1"&gt;// Cumulative: overwrite the line, never append.&lt;/span&gt;
      &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\r\x1b[2Kyou:  &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;transcript&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="dl"&gt;""&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.created&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="s2"&gt;grok: &lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.output_audio_transcript.delta&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.output_audio.delta&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="nx"&gt;speaker&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdin&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;Buffer&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;delta&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;base64&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.done&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.function_call_arguments.done&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;args&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;arguments&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;{}&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;result&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;order_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;order_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;shipped&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt; &lt;span class="c1"&gt;// replace with your lookup&lt;/span&gt;
      &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;
        &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;conversation.item.create&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="na"&gt;item&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;function_call_output&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;call_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;call_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;output&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;result&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;},&lt;/span&gt;
      &lt;span class="p"&gt;});&lt;/span&gt;
      &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;response.create&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;});&lt;/span&gt; &lt;span class="c1"&gt;// ask the model to speak the result&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;error&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\n[error] &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nx"&gt;code&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;: &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;ev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;error&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nx"&gt;message&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
      &lt;span class="k"&gt;break&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;

&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;hangUp&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;mic&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="nx"&gt;speaker&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;close&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;SIGINT&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;hangUp&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="nx"&gt;ws&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;on&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;close&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;code&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`\nsession closed (&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;code&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;reason&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="nx"&gt;mic&lt;/span&gt;&lt;span class="p"&gt;?.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="nx"&gt;speaker&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="p"&gt;});&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Closing the socket is not cleanup trivia: it is what stops the billing clock. Sessions are billed by connected time, and the relay only treats a session as idle after 10 minutes with no client events at all. A process that keeps streaming microphone audio, even silence, is never idle and runs until the 60-minute cap.&lt;/p&gt;

&lt;h2&gt;
  
  
  Verify it works
&lt;/h2&gt;

&lt;p&gt;Run it with headphones on:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;your_key_here node voice-agent.mjs
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You should see &lt;code&gt;listening...&lt;/code&gt;, then your own words appear on a &lt;code&gt;you:&lt;/code&gt; line that updates in place while you speak. Ask "Who are you, and where is order A-1001?" The reply should introduce itself as Grok Voice 3.0 built by xAI (from your instructions), and the function call should come back as a spoken "shipped". Press Ctrl+C; the session appears as one record in your console call history with its duration and cost.&lt;/p&gt;

&lt;h2&gt;
  
  
  Do the same from a browser
&lt;/h2&gt;

&lt;p&gt;Browsers cannot set headers on a WebSocket, so never put the API key in front-end code. Your server mints a short-lived token and the page passes it as a subprotocol.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// On your server (example): exchange the key for a token valid 10 to 600 seconds (default 60)&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;mintRealtimeToken&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;https://api.apimodels.app/v1/realtime/client_secrets&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;POST&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;Authorization&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`Bearer &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;APIMODELS_API_KEY&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;Content-Type&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;application/json&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
    &lt;span class="na"&gt;body&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="na"&gt;expires_after&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;seconds&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;60&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}),&lt;/span&gt;
  &lt;span class="p"&gt;});&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt; &lt;span class="c1"&gt;// { value, expires_at }&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// In the browser (example), from a click handler so audio is allowed to start&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;/api/realtime-token&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="na"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;POST&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="p"&gt;})).&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;ws&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;WebSocket&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;wss://api.apimodels.app/v1/realtime?model=grok-voice-3.0&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt;&lt;span class="s2"&gt;xai-client-secret.&lt;/span&gt;&lt;span class="dl"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The token only governs when a connection can be opened; an open session keeps running after it expires. The rest of the event handling is the same as in Node. For microphone capture, use an AudioWorklet and resample to 24 kHz yourself: Firefox refuses to connect a microphone to an AudioContext created at a non-default sample rate, which is why our own browser playground captures at the device rate and resamples in JavaScript. The &lt;a href="https://apimodels.app/docs/grok-voice?utm_source=dev" rel="noopener noreferrer"&gt;Grok Voice 3.0 API docs on apimodels.app&lt;/a&gt; have a complete browser example.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where apimodels.app fits
&lt;/h2&gt;

&lt;p&gt;apimodels.app is a multi-model API gateway: one API key and OpenAI-compatible endpoints for 140+ image, video, audio and language models. Most mainstream models there have multiple upstream channels with automatic failover, failed requests are not charged, long jobs run asynchronously with webhooks, and any request's charge can be looked up with &lt;code&gt;GET /v1/records/{id}&lt;/code&gt;. Grok Voice 3.0 itself has a single upstream route, so there is no failover for it; a session that cannot reach the model is not charged.&lt;/p&gt;

&lt;p&gt;For this tutorial it supplied the endpoint, the key and the billing: $0.104 per minute of connected session, billed per second (a 90-second call costs $0.156), $0.0052 per typed text message, and no extra fee for function calls. You can also talk to the model with your microphone on the &lt;a href="https://apimodels.app/models/grok-voice-3.0?utm_source=dev" rel="noopener noreferrer"&gt;Grok Voice 3.0 model page&lt;/a&gt; before writing any code.&lt;/p&gt;

&lt;p&gt;Do not route through it if you only use xAI, already have direct xAI access and want the lowest per-minute price: connect to xAI directly, where the same events work. The same goes if you need sessions longer than 60 minutes, more than 5 concurrent sessions per account, or xAI's server-side tools (&lt;code&gt;web_search&lt;/code&gt;, &lt;code&gt;x_search&lt;/code&gt;, &lt;code&gt;file_search&lt;/code&gt;, &lt;code&gt;mcp&lt;/code&gt;) inside the voice session, which the relay rejects.&lt;/p&gt;

&lt;h2&gt;
  
  
  Common errors
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;handshake rejected: 401 ... invalid_api_key&lt;/code&gt;&lt;/strong&gt;: missing or wrong key, or a browser trying to send the key as a header. Use the &lt;code&gt;Authorization&lt;/code&gt; header from Node, or a client secret from a browser.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;handshake rejected: 400 ... "Model gpt-realtime is not available for realtime. Use grok-voice-3.0."&lt;/code&gt;&lt;/strong&gt;: the &lt;code&gt;model&lt;/code&gt; query parameter is wrong. Use &lt;code&gt;grok-voice-3.0&lt;/code&gt; (or &lt;code&gt;grok-voice-latest&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;handshake rejected: 404 ... Unknown API endpoint: GET /api/v1/realtime&lt;/code&gt;&lt;/strong&gt;: you connected to &lt;code&gt;apimodels.app/api/v1/realtime&lt;/code&gt;. The endpoint only exists on &lt;code&gt;api.apimodels.app&lt;/code&gt;, because the main site's hosting layer cannot proxy WebSockets.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;402 &lt;code&gt;insufficient_balance&lt;/code&gt;&lt;/strong&gt; at connect, or an &lt;code&gt;error&lt;/code&gt; event with that code mid-call: balance below one minute. Each minute is charged when it starts, so the session closes when the next minute cannot be covered.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;429 &lt;code&gt;too_many_sessions&lt;/code&gt;&lt;/strong&gt;: more than 5 open sessions on one account. Close sockets you no longer use.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;[error] unsupported_tool&lt;/code&gt;&lt;/strong&gt;: your &lt;code&gt;session.update&lt;/code&gt; included &lt;code&gt;web_search&lt;/code&gt;, &lt;code&gt;x_search&lt;/code&gt;, &lt;code&gt;file_search&lt;/code&gt; or &lt;code&gt;mcp&lt;/code&gt;. Only &lt;code&gt;function&lt;/code&gt; tools are accepted.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The model keeps answering itself&lt;/strong&gt;: speaker echo. Use headphones, or echo cancellation in the browser.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The same sentence printed many times&lt;/strong&gt;: you appended cumulative transcription events. Overwrite instead.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Limits
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;This script is an example built from the documented event protocol; run it once with headphones before you build on it. SoX device handling differs by OS, and the SoX arguments above are the only platform-specific part.&lt;/li&gt;
&lt;li&gt;Barge-in via &lt;code&gt;input_audio_buffer.speech_started&lt;/code&gt; is what our browser playground uses; xAI's documentation page does not list that event, so treat it as best-effort.&lt;/li&gt;
&lt;li&gt;Sessions end at 60 minutes with a &lt;code&gt;session_limit&lt;/code&gt; error; reconnect to continue.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;What did you use for audio I/O in Node: SoX, a native addon, or a browser-only setup? I'd like to know what held up in production.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;This post was written with AI assistance from the apimodels.app source code and public docs, and reviewed before publishing.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>javascript</category>
      <category>node</category>
      <category>tutorial</category>
    </item>
  </channel>
</rss>
