Publish scheduled APIMART engineering guides

guides/ai-image-api-rate-limit-handling.md

@@ -0,0 +1,80 @@
+# AI Image API Rate Limit Handling for Batch Workloads
+
+Control image API concurrency with rate-limit headers, bounded queues, jittered backoff, and per-model throughput records.
+
+> Test note: model behavior and pricing change. Record the model ID, parameters, date, latency, retries, and accepted output count for every run.
+
+## Why this guide exists
+
+Batch systems should respond to provider limits without dropping job provenance or creating retry storms, so this guide separates admission control, worker concurrency, backoff, and accepted-output accounting across slow image requests.
+
+## Starter fixtures
+
+### Minimal coffee packaging
+
+**Goal:** Packaging concept  
+**Aspect ratio:** 3:4
+
+```text
+Premium whole-bean coffee pouch standing on dark walnut, uncoated cream paper with a small black label area, morning side light, restrained props, realistic folds, front panel fully visible, no invented text.
+```
+
+### Smart speaker studio
+
+**Goal:** Consumer electronics hero  
+**Aspect ratio:** 1:1
+
+```text
+Compact smart speaker in graphite fabric on a deep charcoal pedestal, subtle violet rim light, precise mesh texture, controlled reflections, high-end consumer electronics launch photography, centered composition.
+```
+
+### Summer drink social ad
+
+**Goal:** Mobile social creative  
+**Aspect ratio:** 4:5
+
+```text
+Bright summer beverage can on crushed ice, coral and turquoise color blocking, hard flash photography, realistic condensation, product occupies the lower two-thirds, clean space above for campaign copy, no text.
+```
+
+## Measured evidence
+
+- [GPT Image vs Flux vs Gemini: Product Photography Test](../comparisons/gpt-image-vs-flux-vs-gemini-product-photography.md) — GPT Image 2 delivered the strongest editorial staging, Flux followed the literal window-light direction most closely, and Gemini produced the cleanest but least distinctive pack shot.
+- [AI Billboard Image Generation Comparison](../comparisons/ai-billboard-image-generation-comparison.md) — GPT most closely matched the minimal no-lettering direction. Flux invented label marks, while Gemini drifted toward a literal outdoor billboard scene.
+
+## Python quickstart
+
+```python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.environ["APIMART_API_KEY"],
+    base_url="https://api.apimart.ai/v1",
+)
+
+response = client.images.generate(
+    model="gpt-image-1-official",
+    prompt="YOUR_PROMPT",
+    size="1024x1024",
+    n=1,
+)
+```
+
+## Run through one API gateway
+
+APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload.
+
+[Create an APIMart account and run this workflow](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-register-47639944) | [API documentation](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-en-quickstart-e3cffa72)
+
+## Review checklist
+
+- Did the output follow the requested composition and protected attributes?
+- Were the model identifier, parameters, and test date recorded?
+- How many retries were required for one accepted output?
+- Does the output contain invented text, marks, or unwanted objects?
+- Can another contributor reproduce the request from the stored fixture?
+
+## Disclosure
+
+This open-source benchmark is maintained by APIMart Labs. Links to APIMart are promotional and directly related to running the documented API examples.

guides/async-image-generation-api-polling.md

@@ -0,0 +1,80 @@
+# Async Image Generation API Polling with Bounded Backoff
+
+Poll asynchronous image-generation jobs with bounded backoff, terminal-state handling, timeouts, and durable request metadata.
+
+> Test note: model behavior and pricing change. Record the model ID, parameters, date, latency, retries, and accepted output count for every run.
+
+## Why this guide exists
+
+Long-running image jobs need a polling loop that distinguishes queued, running, completed, failed, and expired states while limiting unnecessary requests and preserving enough metadata to resume safely after a worker restart.
+
+## Starter fixtures
+
+### Ceramic skincare hero
+
+**Goal:** Clean premium product hero  
+**Aspect ratio:** 1:1
+
+```text
+Editorial product photograph of a matte ceramic skincare bottle on pale limestone, soft north-window light, delicate contact shadow, warm neutral palette, 85mm lens compression, no text, no logo.
+```
+
+### Running shoe impact
+
+**Goal:** Dynamic footwear campaign  
+**Aspect ratio:** 4:5
+
+```text
+Technical running shoe frozen above a red clay track at impact, fine dust particles suspended in air, directional hard sunlight, visible outsole detail, energetic diagonal composition, commercial sports photography.
+```
+
+### Coastal house at dusk
+
+**Goal:** Exterior visualization  
+**Aspect ratio:** 16:9
+
+```text
+Low modern coastal house at blue hour, weathered cedar and board-formed concrete, dune grasses moving in sea wind, warm interior light, realistic architectural photography, human-scale lens.
+```
+
+## Measured evidence
+
+- [AI Running Shoe Ad Model Comparison](../comparisons/ai-running-shoe-ad-model-comparison.md) — GPT created the most polished commercial crop, Flux showed the strongest outsole and track realism, while Gemini removed the athlete and emphasized a floating product shot.
+- [AI Architecture Rendering Model Comparison](../comparisons/ai-architecture-rendering-model-comparison.md) — All three produced convincing architecture. Gemini completed in 32 seconds, while GPT delivered richer detail but required 159 seconds for this fixture.
+
+## Python quickstart
+
+```python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.environ["APIMART_API_KEY"],
+    base_url="https://api.apimart.ai/v1",
+)
+
+response = client.images.generate(
+    model="gpt-image-1-official",
+    prompt="YOUR_PROMPT",
+    size="1024x1024",
+    n=1,
+)
+```
+
+## Run through one API gateway
+
+APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload.
+
+[Create an APIMart account and run this workflow](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-register-47639944) | [API documentation](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-en-quickstart-e3cffa72)
+
+## Review checklist
+
+- Did the output follow the requested composition and protected attributes?
+- Were the model identifier, parameters, and test date recorded?
+- How many retries were required for one accepted output?
+- Does the output contain invented text, marks, or unwanted objects?
+- Can another contributor reproduce the request from the stored fixture?
+
+## Disclosure
+
+This open-source benchmark is maintained by APIMart Labs. Links to APIMart are promotional and directly related to running the documented API examples.

guides/image-generation-api-webhook-processing.md

@@ -0,0 +1,80 @@
+# Image Generation API Webhook Processing and Verification
+
+Process image-job webhooks with signature verification, idempotent updates, asset downloads, and replay-safe event records.
+
+> Test note: model behavior and pricing change. Record the model ID, parameters, date, latency, retries, and accepted output count for every run.
+
+## Why this guide exists
+
+Webhook delivery can be duplicated, delayed, or reordered, so the receiver should authenticate each event, preserve its provider identifier, update one durable job record, and download expiring assets only after a verified completion state.
+
+## Starter fixtures
+
+### Ceramic skincare hero
+
+**Goal:** Clean premium product hero  
+**Aspect ratio:** 1:1
+
+```text
+Editorial product photograph of a matte ceramic skincare bottle on pale limestone, soft north-window light, delicate contact shadow, warm neutral palette, 85mm lens compression, no text, no logo.
+```
+
+### Forest ranger character sheet
+
+**Goal:** Identity consistency fixture  
+**Aspect ratio:** 3:2
+
+```text
+Character sheet for Mara, a forest ranger with cropped auburn hair, olive field jacket, brass compass and worn canvas backpack; front, profile and three-quarter views; neutral studio background; consistent facial features.
+```
+
+### Climate intelligence dashboard
+
+**Goal:** Dense editorial interface  
+**Aspect ratio:** 16:10
+
+```text
+Editorial analytics dashboard for a climate intelligence product, dense but legible information hierarchy, off-white canvas, dark graphite type, acid green data accents, modular card grid, desktop viewport.
+```
+
+## Measured evidence
+
+- [Consistent Character AI Model Comparison](../comparisons/consistent-character-ai-model-comparison.md) — All three maintained the ranger identity across views. GPT added the richest close-up and prop detail; Flux and Gemini produced cleaner, simpler turnaround sheets.
+- [AI Dashboard UI Generation Comparison](../comparisons/ai-dashboard-ui-generation-comparison.md) — GPT produced the most legible information hierarchy. Gemini offered the strongest cost-latency compromise, while Flux contained more pseudo-text.
+
+## Python quickstart
+
+```python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.environ["APIMART_API_KEY"],
+    base_url="https://api.apimart.ai/v1",
+)
+
+response = client.images.generate(
+    model="gpt-image-1-official",
+    prompt="YOUR_PROMPT",
+    size="1024x1024",
+    n=1,
+)
+```
+
+## Run through one API gateway
+
+APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload.
+
+[Create an APIMart account and run this workflow](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-register-47639944) | [API documentation](https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-en-quickstart-e3cffa72)
+
+## Review checklist
+
+- Did the output follow the requested composition and protected attributes?
+- Were the model identifier, parameters, and test date recorded?
+- How many retries were required for one accepted output?
+- Does the output contain invented text, marks, or unwanted objects?
+- Can another contributor reproduce the request from the stored fixture?
+
+## Disclosure
+
+This open-source benchmark is maintained by APIMart Labs. Links to APIMart are promotional and directly related to running the documented API examples.

site/content-manifest.json

@@ -1,8 +1,8 @@
 {
-  "generatedOn": "2026-07-21",
-  "contentAsOf": "2026-07-24",
+  "generatedOn": "2026-07-27",
+  "contentAsOf": "2026-07-27",
   "counts": {
-    "guides": 50,
+    "guides": 53,
     "measuredComparisons": 10,
     "rawOutputs": 30,
     "promptFixtures": 50
@@ -357,27 +357,30 @@
       "cluster": "Evaluation",
       "intent": "research",
       "publishAt": "2026-07-21"
-    }
-  ],
-  "scheduled": [
+    },
     {
       "slug": "async-image-generation-api-polling",
       "query": "async image generation API polling",
-      "publishAt": "2026-07-27",
-      "status": "scheduled"
+      "cluster": "Reliability",
+      "intent": "implementation",
+      "publishAt": "2026-07-27"
     },
     {
       "slug": "ai-image-api-rate-limit-handling",
       "query": "AI image API rate limit handling",
-      "publishAt": "2026-07-27",
-      "status": "scheduled"
+      "cluster": "Reliability",
+      "intent": "implementation",
+      "publishAt": "2026-07-27"
     },
     {
       "slug": "image-generation-api-webhook-processing",
       "query": "image generation API webhook processing",
-      "publishAt": "2026-07-27",
-      "status": "scheduled"
-    },
+      "cluster": "Reliability",
+      "intent": "implementation",
+      "publishAt": "2026-07-27"
+    }
+  ],
+  "scheduled": [
     {
       "slug": "image-generation-api-error-handling",
       "query": "image generation API error handling",

site/guides/ai-architecture-rendering-prompts/index.html

@@ -11,4 +11,4 @@
   prompt=PROMPT,
   size="1024x1024",
   n=1,
-)</code></pre></section><section class="checklist"><span class="kicker">REVIEW CHECKLIST</span><h2>Before you publish a result</h2><ul><li>Record model ID, parameters, date, latency, and retry count.</li><li>Review instruction following and protected attributes.</li><li>Flag invented text, marks, anatomy, or unwanted objects.</li><li>Keep the raw output linked to the original fixture.</li><li>Do not claim a universal winner from one prompt.</li></ul></section><section class="related"><span class="kicker">RELATED GUIDES</span><div class="guide-list"><a class="guide-link" href="../ai-image-api-for-architecture-rendering/"><small>Buyer guide</small><strong>AI Image API for Architecture Rendering Evaluation</strong></a><a class="guide-link" href="../multi-model-ai-api/"><small>Architecture</small><strong>Multi-Model AI API: Routing, Fallbacks, and Evaluation</strong></a><a class="guide-link" href="../gpt-image-vs-imagen/"><small>Model comparison</small><strong>GPT Image vs Imagen: A Reproducible Comparison Fixture</strong></a><a class="guide-link" href="../nano-banana-pro-prompt-examples/"><small>Prompt library</small><strong>Nano Banana Pro Prompt Examples for Commercial Workflows</strong></a></div></section></main><footer><strong>About APIMart:</strong> APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload. &middot; <a href="https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-root-188924f6">API docs</a> &middot; Content updated 2026-07-21</footer></body></html>
+)</code></pre></section><section class="checklist"><span class="kicker">REVIEW CHECKLIST</span><h2>Before you publish a result</h2><ul><li>Record model ID, parameters, date, latency, and retry count.</li><li>Review instruction following and protected attributes.</li><li>Flag invented text, marks, anatomy, or unwanted objects.</li><li>Keep the raw output linked to the original fixture.</li><li>Do not claim a universal winner from one prompt.</li></ul></section><section class="related"><span class="kicker">RELATED GUIDES</span><div class="guide-list"><a class="guide-link" href="../ai-image-api-for-architecture-rendering/"><small>Buyer guide</small><strong>AI Image API for Architecture Rendering Evaluation</strong></a><a class="guide-link" href="../multi-model-ai-api/"><small>Architecture</small><strong>Multi-Model AI API: Routing, Fallbacks, and Evaluation</strong></a><a class="guide-link" href="../gpt-image-vs-imagen/"><small>Model comparison</small><strong>GPT Image vs Imagen: A Reproducible Comparison Fixture</strong></a><a class="guide-link" href="../nano-banana-pro-prompt-examples/"><small>Prompt library</small><strong>Nano Banana Pro Prompt Examples for Commercial Workflows</strong></a></div></section></main><footer><strong>About APIMart:</strong> APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload. &middot; <a href="https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-root-188924f6">API docs</a> &middot; Content updated 2026-07-27</footer></body></html>

site/guides/ai-dashboard-ui-prompts/index.html

@@ -11,4 +11,4 @@
   prompt=PROMPT,
   size="1024x1024",
   n=1,
-)</code></pre></section><section class="checklist"><span class="kicker">REVIEW CHECKLIST</span><h2>Before you publish a result</h2><ul><li>Record model ID, parameters, date, latency, and retry count.</li><li>Review instruction following and protected attributes.</li><li>Flag invented text, marks, anatomy, or unwanted objects.</li><li>Keep the raw output linked to the original fixture.</li><li>Do not claim a universal winner from one prompt.</li></ul></section><section class="related"><span class="kicker">RELATED GUIDES</span><div class="guide-list"><a class="guide-link" href="../ai-poster-design-prompts/"><small>Design</small><strong>AI Poster Design Prompts with Layout and Type Constraints</strong></a><a class="guide-link" href="../flux-image-api-example/"><small>Code recipe</small><strong>Flux Image API Example for Layout and Typography Tests</strong></a><a class="guide-link" href="../ai-architecture-rendering-prompts/"><small>Architecture</small><strong>AI Architecture Rendering Prompts for Exterior and Interior Tests</strong></a><a class="guide-link" href="../ai-image-api-latency-comparison/"><small>Performance</small><strong>AI Image API Latency Comparison for Real Workloads</strong></a></div></section></main><footer><strong>About APIMart:</strong> APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload. &middot; <a href="https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-root-188924f6">API docs</a> &middot; Content updated 2026-07-21</footer></body></html>
+)</code></pre></section><section class="checklist"><span class="kicker">REVIEW CHECKLIST</span><h2>Before you publish a result</h2><ul><li>Record model ID, parameters, date, latency, and retry count.</li><li>Review instruction following and protected attributes.</li><li>Flag invented text, marks, anatomy, or unwanted objects.</li><li>Keep the raw output linked to the original fixture.</li><li>Do not claim a universal winner from one prompt.</li></ul></section><section class="related"><span class="kicker">RELATED GUIDES</span><div class="guide-list"><a class="guide-link" href="../ai-poster-design-prompts/"><small>Design</small><strong>AI Poster Design Prompts with Layout and Type Constraints</strong></a><a class="guide-link" href="../flux-image-api-example/"><small>Code recipe</small><strong>Flux Image API Example for Layout and Typography Tests</strong></a><a class="guide-link" href="../ai-architecture-rendering-prompts/"><small>Architecture</small><strong>AI Architecture Rendering Prompts for Exterior and Interior Tests</strong></a><a class="guide-link" href="../ai-image-api-latency-comparison/"><small>Performance</small><strong>AI Image API Latency Comparison for Real Workloads</strong></a></div></section></main><footer><strong>About APIMart:</strong> APIMart is a multi-model AI API gateway with an OpenAI-compatible endpoint. Use one account to access supported image models, compare current pricing, and choose a cost-efficient option for each workload. &middot; <a href="https://apimart-click-tracker.luyx031226.chatgpt.site/r/gh-apimart-ai-generation-benchmarks-docs-root-188924f6">API docs</a> &middot; Content updated 2026-07-27</footer></body></html>