---

name: gpt-image-gif description: >- Turn a still, mascot, logo or a plain prompt into a looping animated GIF with GPT Image 2.6 on varg (output_format gif): the sprite-sheet pixel budget with a measured table of frame sizes that fit 2, 4, 6, 9, 12 and 16 frames, the approve-a-still-first workflow, loop-lock prompt wording, frame_duration_ms, transparent backgrounds, the failure modes (text in frames, fast motion, boiling backgrounds) and post-processing to animated WebP and MP4 with scripts/gif2web.sh. Use when someone asks for a GIF, an animated mascot or logo, a looping wave, blink or bounce, a reaction GIF, "animate this image" as a GIF, or a GIF that was rejected or came back broken. Not for sticker packs per messenger (gpt-image-sticker-pack), game sprite sheets and atlases (gpt-image-sprite-sheet) or real video clips (varg-ai, kling-4-prompting). license: MIT metadata: author: vargHQ version: "1.0.0" openclaw: requires: anyBins: - curl - ffmpeg homepage: https://varg.ai/how-to compatibility: >- Needs a VARG_API_KEY with curl (see the varg-ai skill) or the varg MCP connection (https://mcp.varg.ai/mcp). A GIF costs the same as one image: 3-7 credits (measured 2026-11-05). scripts/gif2web.sh needs ffmpeg and ffprobe, plus gif2webp or ImageMagick 7 for the WebP. allowed-tools: Bash(curl:) Bash(jq:) Bash(ffmpeg:) Bash(ffprobe:) Bash(magick:) Bash(bash:) Read Write Edit

Looping GIFs with GPT Image 2.6

GPT Image 2.6 returns a real animated GIF when you set output_format: "gif". It draws all frames as one sprite sheet, then cuts the sheet into frames (@op7418 on ChatGPT; the API errors below show the same sheet). That one fact explains most of what follows: the frames share one image's pixel budget, and one image's price. Model guide and prices: gpt-image-2-6.

Examples made on varg with gpt_image_2_6 (2026-11-04/05):

| Example | Made from | Settings | |---|---|---| | Paper boat on a night sea | a prompt only | 9 frames, default 4:3 (1024×768), 150 ms | | Mascot "Pip" waves and hops | the approved still in files | 9 frames of 768×768, 140 ms | | Sticker "LOL" | the same still | 6 frames of 768×768, 160 ms, transparent | | Failure: "ON MY WAY!" | the same still | three words garbled from frame to frame | | Ball bounce, 12 frames | a prompt only | 12 frames of 768×768, quality: low, 3 credits, default 200 ms |

Frame times are read from the files.

1. The pixel budget (measured 2026-11-05 on varg)

image_size (or the aspect_ratio preset) sets the size of each frame. fal lays the frames out on a grid and checks the whole sheet:

• the sheet's longest edge must be ≤ 3840 px,
• the sheet must be ≤ 8,294,400 px (3840×2160), and so must frames × frame area,
• the sheet must be ≥ 655,360 px (9 frames of 256×256 were "below the minimum pixel budget", @KakiponzuX),
• frame sides are multiples of 16.

Which grids fal tries, read from its error messages (we sent oversize requests, which fail for free):

| Frames | Grids fal tries | Measured | |---|---|---| | 2-8 | 4×2 or 2×4 (eight cells, even for 2 frames) | 2, 4, 6, 8 | | 9 | 3×3 | 9 | | 12 | 4×3, 3×4 or 4×4 | 12 | | 16 | 4×4 | 16 | | 10, 11, 13-15 | not measured | |

So a square frame can be at most 960 px for 2-9 frames (four or three cells across 3840 px), 816 px for 12 and 720 px for 16. 9 frames of 960² and 16 frames of 720² both worked: their sheets are exactly 8,294,400 px, so the limit includes the boundary. What fits:

| Frames | Largest square frame | Worked (measured) | Rejected (measured) | 4:3 preset (1024×768) | 16:9 preset | 1:1 preset (1024×1024) | |---|---|---|---|---|---|---| | 2 | 960 (computed) | — | 2048² | fits (2×4 grid, computed) | fits (computed) | no (4096 px sheet, computed) | | 4 | 960 (computed) | — | 2048² | fits (computed) | fits (computed) | no (computed) | | 6 | 960 (computed) | 768² | 1024² | fits (computed) | fits (computed) | no | | 9 | 960 (measured) | 960², 768², 1024×768, 512² (@KakiponzuX) | 1024², 256² (@KakiponzuX) | fits | fits (computed) | no | | 12 | 816 (computed) | 768² | 1024² | no (computed) | fits (3×4 grid, computed) | no | | 16 | 720 (measured) | 720² | 976×528 (sheet 3904 px wide) | no (computed) | no (computed) | no (computed) |

"Computed" follows from the rules above; we did not run it. Safe defaults: image_size: {"width": 768, "height": 768} for 2-12 frames, 720×720 or smaller for 16, or the default 4:3 preset for up to 9 frames. num_images above 1 splits the same budget across all outputs (fal).

The error text names the sheet it tried, e.g. No supported sheet fits 6 GIF frames at size '1024x1024'. Invalid size '4096x2048'. The longest edge must be less than or equal to 3840. Divide the sheet by the frame size to see the grid, then shrink the frame.

2. Workflow: approve a still first

1. Make or pick the still. For a mascot or logo, one clean still on a plain or transparent background (background: "transparent", PNG). Approve it before any GIF: when the GIF is made from the same still every time, the character and colours drift less (@yyf940515: without a saved reference, faces and colours drift after 5-6 GIFs). 6 credits.
2. Upload it (create_upload on the MCP, or POST /v2/files), so you have an https://s3.varg.ai/… URL. The upload tools list PNG, JPEG and WebP for images, not GIF.
3. Make the GIF from the still on the edit route: the still in files, output_format: "gif", a frame count and a size from the table, the motion prompt (section 3). 6-7 credits.
4. Check the frames, not just the preview: magick in.gif -coalesce +append strip.png puts them side by side. Look for a changing face, moving text, a boiling background and a jump from the last frame to the first.
5. Fix one thing and rerun: smaller motion, a fixed background, fewer words. Keep the rest of the prompt identical.
6. Convert for the web: scripts/gif2web.sh in.gif (section 6).

The call (MCP):

call_tool({
  "tool": "image",
  "input": {
    "model": "gpt_image_2_6",
    "prompt": "Animate the character from the reference image. Motion: Pip waves its right paw twice, then does one small hop. 9 frames. The first and last frame show the same resting pose, so the loop has no jump. Same size, position and ground line in every frame; fixed camera, no zoom. Plain white background that stays the same in every frame. Flat colours, no text.",
    "files": [{"url": "https://s3.varg.ai/files/194b94d0-58ff-4e8b-91de-4f1959d04013/file_5ed17708b8d2.png"}],
    "provider_options": {"fal": {
      "output_format": "gif",
      "frame_count": 9,
      "image_size": {"width": 768, "height": 768},
      "frame_duration_ms": 140,
      "quality": "high"
    }}
  },
  "wait": true
})

Over REST the same input goes to POST https://api.varg.ai/v2/image (see gpt-image-2-6 section 6). Text only (no files) works the same way on the text-to-image route.

3. Prompt: the motion and the loop lock

OpenAI's advice: "Start with the artwork and describe the motion you want. Try a wave, a double take, or a victory dance that loops back to the starting pose" (@OpenAIDevs).

Template:

Animate the [character / logo / object] from the reference image.
Motion: [ONE simple action: waves twice / blinks and sways / bounces once / turns its head and back].
[N] frames.
The first and last frame show the same resting pose, so the loop has no jump.
Same size, position and ground line in every frame; fixed camera, no zoom, no camera move.
[Plain white | transparent] background that stays the same in every frame.
Flat colours, no gradients, no text.

The loop-lock lines come from people who measured the difference: writing "loop first/last frame identical + lock character proportions" into the prompt made API GIFs much better for @freeman1266; @goan999999 asks for "固定人物大小和位置" (keep the figure's size and position fixed) and "最后一帧能接回第一帧" (the last frame can join back to the first) (prompt).

Short motions people liked:

• 「まばたきして、ふわっと揺れて」 "blink and sway softly" (@IHayato)
• 「このキャラの喜怒哀楽のGIFよろ」 "GIFs of this character's joy, anger, sorrow and fun, please" (@tetumemo): four GIFs, one emotion each
• a wave, a double take, a victory dance (OpenAI, above)

reasoning_effort matters more for motion than for stills: at low complexity Flare skipped the rotation frames of a backflip; high was smoother (@gabrielchua, an OpenAI engineer). Use reasoning_effort: "high" for GIFs.

4. Timing, size and background

• frame_duration_ms: 20-2000, "rounded to 10 ms" (fal). Default 200 ms (measured: our 12-frame GIF without it played at 200 ms). Loop length = frames × duration: 9 × 200 ms = 1.8 s. 120-160 ms reads as lively, 200 ms as calm. A GIF's frame delay is stored in 1/100 s, so use multiples of 10 ms.
• Frames: 6-9 is enough for a wave or a blink. 2-8 frames all use the same eight-cell sheet, so 8 frames take no more pixels than 2. Above 9, each frame gets smaller (section 1), and more frames do not help if the motion itself is choppy.
• background: "transparent" works: our sticker GIFs came back with 54-62% transparent pixels. GIF has 1-bit alpha, so edges are hard; on dark chats a white fringe can show. If you need soft edges, make a PNG sprite sheet instead and assemble it yourself (gpt-image-sprite-sheet).
• Colours: a GIF frame has 256 colours, so gradients and soft edges band; flat-colour characters work best (@pyy_invest).

5. Failure → fix

| What you see | Fix | |---|---| | A sentence in the frames garbles ("ON MY WAY!" broke; "LOL" and "THANKS!" held; measured) | One short word per GIF, or no text in the GIF and add the caption later | | A still image with motion lines instead of an animation (ChatGPT, @goan999999) | In the API, output_format: "gif" always returns frames; in ChatGPT ask for the frames first | | Fast or complex motion is wrong: a 360 kickflip (@justynclark), a backflip at low effort (@gabrielchua) | One slow action; reasoning_effort: "high"; for real action use a video model | | Choppy motion, few in-between poses (@798145343h; our boat and wave GIFs) | Smaller motion over the same frame count; or accept it as a sticker look | | The background boils, clouds and feathers change every frame (@pigeon__s) | Plain or transparent background, "stays the same in every frame" | | Still and moving parts in one GIF break ([@AM09_21](https://x.com/AM09_21/sta