announcements

GIF output in Images 2.6: use cases, request parameters, and capability limits

PoYo Team
4 min read
Share:

GIF output in Images 2.6: use cases, request parameters, and capability limits

In Introducing Images 2.6, OpenAI lists animated GIF as a core addition for creators and marketing: animate a brand mascot or character, turn a product still into an attention-grabbing loop, or probe character motion with animated storyboards before video production. The API Changelog (November 4, 2026) likewise records animated GIF generation for GPT‑Image‑2.6 Flare/Sunburst. The image generation guide specifies requesting animation by setting output_format to "gif" on POST /v1/images/generations.

👉 Try the GPT Image 2.6 API on PoYo: per-image pricing and online playground.

Draw the product boundary first: OpenAI positions GIF as a “motion format inside the image-generation path,” not a full video model such as Sora. The edits endpoint (/v1/images/edits) does not support GIF output; streaming, partial images, custom output_compression, and prompt_rewriter also cannot be combined with GIF. Claiming GIF “already replaces the video API” or “supports arbitrary-length finished films” exceeds what this article can verify in the docs.

Official example use cases

Directions on the product page include: marketers and creators animating brand mascots for campaigns; reaction and meme GIFs for social; probing character motion with animated storyboards before video; turning simple sketches into expressive characters for video or games. Early adopters such as OpenArt are quoted emphasizing “a single prompt can produce social-ready GIFs.” Customers such as Town are described as using the API to explore animated character personality in work settings. These are announcement examples and customer quotes; results still depend on prompts and parameters and should not be treated as a uniform quality guarantee or industry benchmark.

On prompting, the image prompting guide suggests: for a smooth loop, describe the path that returns the character to the start pose, and say whether the camera moves. In one example, Sunburst at size="512x512", quality="high", default high complexity, frame_count=9, and frame_duration_ms=200 yields an about 1.8-second lantern animation loop. The product page also shows loops prompted in a sprite-sheet style, but API integration should still key off output_format: "gif" and the frame parameters—do not assume you must first emit a grid still and assemble frames yourself.

Request fields and limits

Per the image generation docs, GIF-related fields are:

FieldValuesDefault
output_format"gif"(must be set explicitly)
frame_count2–64 frames9
frame_duration_ms20–2000 ms per frame, rounded to 10 ms200
sizeauto, or WIDTHxHEIGHT with both sides multiples of 16auto

size describes the dimensions of each completed frame. Frame count, frame size, and animation count must fit model size limits and the request’s total pixel budget; if over limit, lower frame_count, shrink frame size, or reduce n. Using auto lets the API choose frame size within model limits. frame_count and frame_duration_ms apply only for GIF output. Response b64_json should be base64-decoded and saved as a .gif file. Both Flare and Sunburst can generate GIFs via the Image API; model pages list animated GIF output as a shared capability. Selection can still follow the usual speed-vs-precision logic: short social loops can try Flare first; higher character consistency or detail needs can then compare Sunburst.

Prudent usage boundaries

First, GIF is a generations-side capability—do not expect the edits endpoint to “turn a still into a GIF.” Second, complex prompts can still incur high latency on image models (docs note complex prompts can take up to about two minutes); motion requests are subject to the same. Third, content moderation and the moderation parameter apply to GIF requests; when blocked, do not blindly retry without changing the prompt. Fourth, do not write GIF capability as “already replacing the video API”: OpenAI maintains a separate video product line; Images 2.6 GIF solves short loops, lightweight motion, and social distribution—not long-take narrative or high-frame-rate finished films. Fifth, billing still follows model-page image-token rules; more frames and higher resolution usually mean more output consumption—measure per-item cost on representative prompts before launch.

From an engineering-acceptance view, build a fixed prompt set covering “loop back to start pose” and “camera still vs camera move,” and record look, file size, and latency across frame_count/frame_duration_ms combinations. Docs give no single “best frame rate”; nine frames at two hundred milliseconds each is only a starting point. If loop seams are visible, prefer fixing start/end pose language in the prompt over endlessly raising frame count; more frames hit the pixel budget sooner and raise output-token cost.

In short, Images 2.6 GIF output puts “short looping motion” on the Image API’s formal format list. Integrate with output_format: "gif" and frame parameters, respect edits unsupported and no-streaming limits, and productize without overstating capability.

Share: