GPT Image 2.6 Sunburst API
Create looping 360-degree product turntable GIFs from a photo.
POST /v2/gpt-image-2.6-sunburst · submit + poll 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3import segmind
4
5# Async (v2): submit to the queue and block until COMPLETED.
6# run() returns the final result dict (600s deadline, 1.0s poll by default).
7result = segmind.run(
8 "gpt-image-2.6-sunburst",
9 prompt="Animate this exact carved wooden dragon figurine as a smooth 360-degree turntable rotation on the same seamless pale-grey backdrop. The dragon turns at a steady speed around its vertical axis, one full revolution across the loop, so the horns, whiskers, clawed feet gripping the pearl and the curling tail pass in and out of view. Keep the rows of overlapping carved scales, the jade-green paint with gold-leaf edging along the spine ridge and horns, the deep-red mouth, the proportions and the even studio lighting consistent in every frame; fixed camera, no zoom. The last frame flows back into the first. No text, no logos, no labels.",
10 size="960x960",
11 quality="high",
12 complexity="high",
13 background="opaque",
14 moderation="auto",
15 output_format="gif",
16 frame_count=9,
17 frame_duration_ms=200,
18 output_compression=100,
19 image_urls=["https://segmind-resources.s3.amazonaws.com/input/gpt-image-2.6-sunburst-input-dragon-dcf844f7.jpg"],
20)
21print(result["status"]) # COMPLETED
22print(result.get("output")) # model output (e.g. media URL)
23print(result["metrics"]["inference_time"]) # server compute seconds
24
25# --- Or submit + poll manually (track request_id, control the cadence) ---
26from segmind import SegmindClient, InferenceFailed, InferenceTimeout
27
28client = SegmindClient() # reads SEGMIND_API_KEY
29payload = {
30 "prompt": "Animate this exact carved wooden dragon figurine as a smooth 360-degree turntable rotation on the same seamless pale-grey backdrop. The dragon turns at a steady speed around its vertical axis, one full revolution across the loop, so the horns, whiskers, clawed feet gripping the pearl and the curling tail pass in and out of view. Keep the rows of overlapping carved scales, the jade-green paint with gold-leaf edging along the spine ridge and horns, the deep-red mouth, the proportions and the even studio lighting consistent in every frame; fixed camera, no zoom. The last frame flows back into the first. No text, no logos, no labels.",
31 "size": "960x960",
32 "quality": "high",
33 "complexity": "high",
34 "background": "opaque",
35 "moderation": "auto",
36 "output_format": "gif",
37 "frame_count": 9,
38 "frame_duration_ms": 200,
39 "output_compression": 100,
40 "image_urls": ["https://segmind-resources.s3.amazonaws.com/input/gpt-image-2.6-sunburst-input-dragon-dcf844f7.jpg"],
41}
42job = client.submit_async("gpt-image-2.6-sunburst", **payload)
43print(job.request_id) # available immediately
44try:
45 result = job.wait(timeout=600, interval=1.0)
46except InferenceTimeout as e:
47 print("still running:", e.request_id)
48except InferenceFailed as e:
49 print("failed:", e.detail) 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3import segmind
4
5# Async (v2): submit to the queue and block until COMPLETED.
6# run() returns the final result dict (600s deadline, 1.0s poll by default).
7result = segmind.run(
8 "gpt-image-2.6-sunburst",
9 prompt="Animate this exact carved wooden dragon figurine as a smooth 360-degree turntable rotation on the same seamless pale-grey backdrop. The dragon turns at a steady speed around its vertical axis, one full revolution across the loop, so the horns, whiskers, clawed feet gripping the pearl and the curling tail pass in and out of view. Keep the rows of overlapping carved scales, the jade-green paint with gold-leaf edging along the spine ridge and horns, the deep-red mouth, the proportions and the even studio lighting consistent in every frame; fixed camera, no zoom. The last frame flows back into the first. No text, no logos, no labels.",
10 size="960x960",
11 quality="high",
12 complexity="high",
13 background="opaque",
14 moderation="auto",
15 output_format="gif",
16 frame_count=9,
17 frame_duration_ms=200,
18 output_compression=100,
19 image_urls=["https://segmind-resources.s3.amazonaws.com/input/gpt-image-2.6-sunburst-input-dragon-dcf844f7.jpg"],
20)
21print(result["status"]) # COMPLETED
22print(result.get("output")) # model output (e.g. media URL)
23print(result["metrics"]["inference_time"]) # server compute seconds
24
25# --- Or submit + poll manually (track request_id, control the cadence) ---
26from segmind import SegmindClient, InferenceFailed, InferenceTimeout
27
28client = SegmindClient() # reads SEGMIND_API_KEY
29payload = {
30 "prompt": "Animate this exact carved wooden dragon figurine as a smooth 360-degree turntable rotation on the same seamless pale-grey backdrop. The dragon turns at a steady speed around its vertical axis, one full revolution across the loop, so the horns, whiskers, clawed feet gripping the pearl and the curling tail pass in and out of view. Keep the rows of overlapping carved scales, the jade-green paint with gold-leaf edging along the spine ridge and horns, the deep-red mouth, the proportions and the even studio lighting consistent in every frame; fixed camera, no zoom. The last frame flows back into the first. No text, no logos, no labels.",
31 "size": "960x960",
32 "quality": "high",
33 "complexity": "high",
34 "background": "opaque",
35 "moderation": "auto",
36 "output_format": "gif",
37 "frame_count": 9,
38 "frame_duration_ms": 200,
39 "output_compression": 100,
40 "image_urls": ["https://segmind-resources.s3.amazonaws.com/input/gpt-image-2.6-sunburst-input-dragon-dcf844f7.jpg"],
41}
42job = client.submit_async("gpt-image-2.6-sunburst", **payload)
43print(job.request_id) # available immediately
44try:
45 result = job.wait(timeout=600, interval=1.0)
46except InferenceTimeout as e:
47 print("still running:", e.request_id)
48except InferenceFailed as e:
49 print("failed:", e.detail)API Endpoint
https://api.segmind.com/v1/gpt-image-2.6-sunburstParameters
promptrequiredstringDescribes the image or animation, with legible in-image text. For turntables, state the rotation and name details that must stay constant.
"A straight-down product still-life photograph on a brushed grey concrete surface. A glossy black vinyl record is half-slid out of a matte kraft-brown album sleeve. The sleeve is a modernist jazz cover: a large clean title 'MIDNIGHT LATITUDES' across the top in condensed sans-serif, an artist line 'The Corner Sessions Quartet' beneath it, and a five-song tracklist down the right edge reading '1. Blue Meridian 2. Harbor Lights 3. Slow Tide 4. Northbound 5. Last Call'. The record's cream paper center label reads 'SIDE A' with a catalog number 'CS-014'. Concentric grooves catch a low raking light; faint paper grain on the cardboard and light dust on the vinyl. Colour palette of deep teal, mustard and off-white."backgroundoptionalstringBackground fill: opaque, transparent or auto. Use transparent with png, webp or gif for stickers and overlays; jpeg stays opaque.
"opaque""opaque""transparent""auto"complexityoptionalstringHow much Sunburst plans before rendering (high when omitted). Use low to cut wait times sharply; high for intricate subjects.
"high""low""medium""high"frame_countoptionalintegerGIF only: number of frames, 2 to 16 (default 9). Use 9 at 960x960 for crisp spins; up to 16 at Auto for smoother rotation.
9Range: 2 - 16frame_duration_msoptionalintegerGIF only: how long each frame shows, in milliseconds (default 200). Use 100-150 for a brisk spin, 300+ for a slow showcase.
200Range: 20 - 2000image_urlsoptionalstring[]Optional reference image URLs; adding any switches to edit mode. Add one clean product photo to edit it or animate a turntable.
[]mask_image_urloptionalstring (uri)Optional alpha-channel PNG mask matching the first reference; transparent areas are regenerated. Use it to repaint one region precisely.
moderationoptionalstringContent-filter strictness: auto or low. Keep auto for most work; use low only for permitted use cases.
"auto""low""auto"output_compressionoptionalintegerCompression 0-100 for jpeg and webp. Keep 100 for crisp text; lower it to shrink files. Ignored for png and gif.
100Range: 0 - 100output_formatoptionalstringFile type: png, jpeg, webp or gif. Use gif for turntables and loops, png for crisp text, webp for smaller files.
"png""png""jpeg""webp""gif"qualityoptionalstringRendering fidelity: low, medium, high or auto. Use high for turntables and fine detail; low only for quick drafts.
"high""low""medium""high""auto"sizeoptionalstringOutput size; for GIF it is one frame. Use 1536x1024 for detailed stills, 960x960 for crisp GIF turntables up to 9 frames.
"1536x1024""1024x1024""1536x1024""1024x1536""1280x960""960x1280""1536x864""864x1536""1280x720""720x1280""960x960"+6 moreResponse Type
Returns: Text/JSON
Asynchronous requests (v2)
Use Async for video, long-running (>~60s), or high-concurrency workloads; Sync is simplest for fast image & LLM calls. Async submits a request and you poll it to completion.
- 1
POST /v2/gpt-image-2.6-sunburstSubmit — returns request_id, status_url, response_url
- 2
GET /v2/requests/{id}/statusPoll — until COMPLETED or FAILED
- 3
GET /v2/requests/{id}Result — final response body
Status states
- A FAILED request is served as HTTP 422 — the body still carries the error detail.
- An unknown or expired request_id returns HTTP 404.
- Results are retained for 1 hour, then expire.
- Content / RAI blocks surface as FAILED, not a separate state.
- Track completion by polling the status endpoint.
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out