veniceai · Dervlex · May 21, 2026 · May 21, 2026 · May 21, 2026
diff --git a/api-reference/endpoint/image/edit.mdx b/api-reference/endpoint/image/edit.mdx
@@ -1,8 +1,8 @@
 ---
 title: 'Edit (aka Inpaint)'
 openapi: 'POST /image/edit'
 "og:title": "Image Edit | Venice API Docs"
 "og:description": "Documentation covering Venice's image edit (aka inpaint) API."
 ---

 <Warning>
@@ -10,7 +10,27 @@
 </Warning>
 
 <Info>
-**Pricing:** Image editing/inpainting pricing varies by model. The default model (`qwen-edit`) is **$0.04 per edit**. See the [Models endpoint](/api-reference/endpoint/models/list) for all available inpaint models and their pricing.
+**Pricing:** Image editing pricing varies by model. The default model (`qwen-edit`) is **$0.04 per edit**. See the [Models endpoint](/api-reference/endpoint/models/list) for all available edit models and their pricing.
+</Info>
+
+## Quality Tiers
+
+Some edit models accept an optional `quality` parameter (`low`, `medium`, `high`) that trades visual fidelity for cost. Currently supported by `gpt-image-2-edit`; other models ignore the parameter.
+
+```json
+{
+  "model": "gpt-image-2-edit",
+  "image": "iVBORw0KGgo...",
+  "prompt": "change the sky to a sunrise",
+  "resolution": "2K",
+  "quality": "medium"
+}
+```
+
+When you omit `quality`, the model uses its default tier (`high` for `gpt-image-2-edit`). Per-tier prices (1K/2K/4K × low/medium/high) live under `model_spec.pricing.quality` in the [Models endpoint](/api-reference/endpoint/models/list) and are listed in the [Pricing overview](/overview/pricing).
+
+<Info>
+Quality-aware pricing is the default for all API and SDK callers — no opt-in header required. Requests that omit `quality` are billed at the model's default tier (`high` for `gpt-image-2-edit`).
 </Info>
 
 ## Postman Collection
@@ -19,5 +39,5 @@
 -------

 <Warning>
 The default model (`qwen-edit`) blocks requests that try to generate explicit sexual imagery, sexualize minors, or depict real-world violence. Other models may have different content policies.
 </Warning>
diff --git a/api-reference/endpoint/image/generate.mdx b/api-reference/endpoint/image/generate.mdx
@@ -59,6 +59,26 @@ For models that use direct pixel dimensions, send `width` and `height` instead:
 
 Check [Image Models](/models/image) or the [Models endpoint](/api-reference/endpoint/models/list) for each model's supported sizing options before mixing sizing fields across models.
 
+## Quality Tiers
+
+Some models accept an optional `quality` parameter (`low`, `medium`, `high`) that trades visual fidelity for cost. Currently supported by `gpt-image-2`; other models ignore the parameter.
+
+```json
+{
+  "model": "gpt-image-2",
+  "prompt": "a cinematic wide shot of Venice at sunset",
+  "aspect_ratio": "16:9",
+  "resolution": "2K",
+  "quality": "medium"
+}
+```
+
+When you omit `quality`, the model uses its default tier (`high` for `gpt-image-2`). Pricing depends on the combination of `resolution` and `quality` — the per-tier prices for `gpt-image-2` (1K/2K/4K × low/medium/high) are exposed under `model_spec.pricing.quality` in the [Models endpoint](/api-reference/endpoint/models/list) and listed in the [Pricing overview](/overview/pricing).
+
+<Info>
+Quality-aware pricing is the default for all API and SDK callers — no opt-in header required. Requests that omit `quality` are billed at the model's default tier (`high` for `gpt-image-2`).
+</Info>
+
 ## Postman Collection
 For additional examples, please see this [Postman Collection](https://www.postman.com/veniceai/workspace/venice-ai-workspace/folder/38652128-0adc004d-2edf-4b88-a3bb-0f868c791c9c?action=share&source=copy-link&creator=38652128&ctx=documentation).
 

diff --git a/api-reference/endpoint/image/multi-edit.mdx b/api-reference/endpoint/image/multi-edit.mdx
@@ -9,3 +9,23 @@ openapi: 'POST /image/multi-edit'
 **Pricing:** Multi-edit pricing varies by model. See the [Pricing overview](/overview/pricing)
 for current per-edit prices.
 </Info>
+
+## Quality Tiers
+
+Some multi-edit models accept an optional `quality` parameter (`low`, `medium`, `high`) that trades visual fidelity for cost. Currently supported by `gpt-image-2-edit`; other models ignore the parameter.
+
+```json
+{
+  "modelId": "gpt-image-2-edit",
+  "images": ["iVBORw0KGgo...", "iVBORw0KGgo..."],
+  "prompt": "blend the two scenes into one cinematic frame",
+  "resolution": "2K",
+  "quality": "medium"
+}
+```
+
+When you omit `quality`, the model uses its default tier (`high` for `gpt-image-2-edit`). Per-tier prices (1K/2K/4K × low/medium/high) live under `model_spec.pricing.quality` in the [Models endpoint](/api-reference/endpoint/models/list) and are listed in the [Pricing overview](/overview/pricing).
+
+<Info>
+Quality-aware pricing is the default for all API and SDK callers — no opt-in header required. Requests that omit `quality` are billed at the model's default tier (`high` for `gpt-image-2-edit`).
+</Info>
diff --git a/api-reference/endpoint/models/list.mdx b/api-reference/endpoint/models/list.mdx
@@ -5,6 +5,39 @@
 "og:description": "Documentation covering Venice's model list API."
 ---
 
+## Quality-Tier Pricing
+
+For image models that accept the optional `quality` parameter (currently `gpt-image-2` and `gpt-image-2-edit`), the response exposes a per-quality price matrix under `model_spec.pricing.quality`. Each top-level key is a resolution tier (`1K`, `2K`, `4K`) and each nested key is a quality level (`low`, `medium`, `high`) carrying its own `usd` and `diem` price:
+
+```json
+"pricing": {
+  "resolutions": {
+    "1K": { "usd": 0.27, "diem": 0.27 },
+    "2K": { "usd": 0.51, "diem": 0.51 },
+    "4K": { "usd": 0.84, "diem": 0.84 }
+  },
+  "quality": {
+    "1K": {
+      "low":    { "usd": 0.02, "diem": 0.02 },
+      "medium": { "usd": 0.07, "diem": 0.07 },
+      "high":   { "usd": 0.26, "diem": 0.26 }
+    },
+    "2K": {
+      "low":    { "usd": 0.03, "diem": 0.03 },
+      "medium": { "usd": 0.13, "diem": 0.13 },
+      "high":   { "usd": 0.50, "diem": 0.50 }
+    },
+    "4K": {
+      "low":    { "usd": 0.05, "diem": 0.05 },
+      "medium": { "usd": 0.21, "diem": 0.21 },
+      "high":   { "usd": 0.83, "diem": 0.83 }
+    }
+  }
+}
+```
+
+`pricing.resolutions` is the legacy per-image schedule kept for backward compatibility. `pricing.quality` is the per-(resolution, quality) matrix that applies whenever the `quality` parameter is supported. Both fields are kept in the response so clients can detect quality support and surface the matrix in their own UIs.
+
 ## Postman Collection
 For additional examples, please see this [Postman Collection](https://www.postman.com/veniceai/workspace/venice-ai-workspace/folder/38652128-59dfa959-7038-4cd8-b8ba-80cf09f2f026?action=share&source=copy-link&creator=38652128&ctx=documentation).
 

diff --git a/models/image.mdx b/models/image.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Image Models"
 description: "Image generation, upscaling, and editing models"
 "og:title": "Image Models | Venice API Docs"
 ---

@@ -12,12 +12,16 @@

 - **Generation:** Create images from text prompts
 - **Upscale:** Enhance image resolution and quality
 - **Edit:** Modify existing images with inpainting

 <Note>
 See the [Image Generate API](/api-reference/endpoint/image/generate) for text-to-image, [Upscale API](/api-reference/endpoint/image/upscale) for enhancement, and [Edit API](/api-reference/endpoint/image/edit) for inpainting.
 </Note>
 
 <Tip>
 Image generation sizing is model-specific. Pixel-based models such as `venice-sd35` and `qwen-image` use `width` and `height`; aspect-ratio models such as `qwen-image-2` use `aspect_ratio`; models that list resolution options such as `1K`, `2K`, or `4K` use both `resolution` and `aspect_ratio`.
+</Tip>
+
+<Tip>
+**Quality tiers.** `gpt-image-2` (generate) and `gpt-image-2-edit` (edit/multi-edit) accept an optional `quality` parameter — `low`, `medium`, or `high` (default). Lower tiers cost less; see the [Pricing overview](/overview/pricing#quality-tier-pricing-gpt-image-2) for the full matrix or fetch `model_spec.pricing.quality` from the [Models endpoint](/api-reference/endpoint/models/list).
 </Tip>
diff --git a/overview/pricing.mdx b/overview/pricing.mdx
@@ -14,19 +14,19 @@

 | Model | ID | Input Price | Output Price | Cache Read | Cache Write | Context | Privacy |
 |---|---|---|---|---|---|---|---|
 | Aion 2.0 | `aion-labs-aion-2-0` | $1.00 | $2.00 | $0.25 | - | 128K | Anonymized |
 | Claude Opus 4.5 | `claude-opus-4-5` | $6.00 | $30.00 | $0.60 | $7.50 | 198K | Anonymized |
 | Claude Opus 4.6 (Beta) | `claude-opus-4-6` | $6.00 | $30.00 | $0.60 | $7.50 | 1000K | Anonymized |
 | Claude Opus 4.6 Fast (Beta) | `claude-opus-4-6-fast` | $36.00 | $180.00 | $3.60 | $45.00 | 1000K | Anonymized |
 | Claude Opus 4.7 | `claude-opus-4-7` | $6.00 | $30.00 | $0.60 | $7.50 | 1000K | Anonymized |
 | Claude Opus 4.7 Fast (Beta) | `claude-opus-4-7-fast` | $36.00 | $180.00 | $3.60 | $45.00 | 1000K | Anonymized |
 | Claude Sonnet 4.5 | `claude-sonnet-4-5` | $3.75 | $18.75 | $0.38 | $4.69 | 198K | Anonymized |
 | Claude Sonnet 4.6 (Beta) | `claude-sonnet-4-6` | $3.60 | $18.00 | $0.36 | $4.50 | 1000K | Anonymized |
 | DeepSeek V3.2 | `deepseek-v3.2` | $0.33 | $0.48 | $0.16 | - | 160K | Private |
 | DeepSeek V4 Flash | `deepseek-v4-flash` | $0.17 | $0.35 | $0.03 | - | 1000K | Anonymized |
 | DeepSeek V4 Pro | `deepseek-v4-pro` | $1.73 | $3.80 | $0.33 | - | 1000K | Anonymized |
 | Gemini 3 Flash Preview | `gemini-3-flash-preview` | $0.70 | $3.75 | $0.07 | - | 256K | Anonymized |
 | Gemini 3.1 Pro Preview | `gemini-3-1-pro-preview` | $2.50 | $15.00 | $0.50 | $0.50 | 1000K | Anonymized |
 | ↳ >200K Context | | $5.00 | $22.50 | $0.50 | $0.50 | | |
 | Gemma 3 27B (Beta) | `e2ee-gemma-3-27b-p` | $0.14 | $0.50 | - | - | 40K | E2EE · Private |
 | Gemma 4 31B Instruct (Beta) | `e2ee-gemma-4-31b` | $0.16 | $0.50 | $0.03 | - | 32K | E2EE · Private |
@@ -38,27 +38,27 @@
 | GLM 4.7 Flash (Beta) | `e2ee-glm-4-7-flash-p` | $0.13 | $0.55 | - | - | 198K | E2EE · Private |
 | GLM 4.7 Flash Heretic | `olafangensan-glm-4.7-flash-heretic` | $0.14 | $0.80 | - | - | 200K | Private |
 | GLM 5 | `zai-org-glm-5` | $1.00 | $3.20 | $0.20 | - | 198K | Private |
 | GLM 5 Turbo | `z-ai-glm-5-turbo` | $1.20 | $4.00 | $0.24 | - | 200K | Anonymized |
 | GLM 5.1 (Beta) | `zai-org-glm-5-1` | $1.75 | $5.50 | $0.33 | - | 200K | Private |
 | GLM 5.1 (Beta) | `e2ee-glm-5-1` | $1.10 | $4.15 | - | - | 200K | E2EE · Private |
 | GLM 5V Turbo (Beta) | `z-ai-glm-5v-turbo` | $1.50 | $5.00 | $0.30 | - | 200K | Anonymized |
 | Google Gemma 3 27B Instruct | `google-gemma-3-27b-it` | $0.12 | $0.20 | - | - | 198K | Private |
 | Google Gemma 4 26B A4B Instruct | `google-gemma-4-26b-a4b-it` | $0.16 | $0.50 | - | - | 256K | Private |
 | Google Gemma 4 31B Instruct | `google-gemma-4-31b-it` | $0.17 | $0.50 | - | - | 256K | Private |
 | GPT OSS 120B (Beta) | `e2ee-gpt-oss-120b-p` | $0.13 | $0.65 | - | - | 128K | E2EE · Private |
 | GPT OSS 20B (Beta) | `e2ee-gpt-oss-20b-p` | $0.05 | $0.19 | - | - | 128K | E2EE · Private |
 | GPT-4o | `openai-gpt-4o-2024-11-20` | $3.13 | $12.50 | - | - | 128K | Anonymized |
 | GPT-4o Mini | `openai-gpt-4o-mini-2024-07-18` | $0.19 | $0.75 | $0.09 | - | 128K | Anonymized |
 | GPT-5.2 | `openai-gpt-52` | $2.19 | $17.50 | $0.22 | - | 256K | Anonymized |
 | GPT-5.2 Codex | `openai-gpt-52-codex` | $2.19 | $17.50 | $0.22 | - | 256K | Anonymized |
 | GPT-5.3 Codex (Beta) | `openai-gpt-53-codex` | $2.19 | $17.50 | $0.22 | - | 400K | Anonymized |
 | GPT-5.4 (Beta) | `openai-gpt-54` | $3.13 | $18.80 | $0.31 | - | 1000K | Anonymized |
 | GPT-5.4 Mini (Beta) | `openai-gpt-54-mini` | $0.94 | $5.63 | $0.09 | - | 400K | Anonymized |
 | GPT-5.4 Pro (Beta) | `openai-gpt-54-pro` | $37.50 | $225.00 | - | - | 1000K | Anonymized |
 | ↳ >272K Context | | $75.00 | $337.50 | - | - | | |
 | GPT-5.5 (Beta) | `openai-gpt-55` | $6.25 | $37.50 | $0.63 | - | 1000K | Anonymized |
 | ↳ >272K Context | | $12.50 | $56.25 | $1.25 | - | | |
 | GPT-5.5 Pro (Beta) | `openai-gpt-55-pro` | $37.50 | $225.00 | - | - | 1000K | Anonymized |
 | Grok 4.20 | `grok-4-20` | $1.42 | $2.83 | $0.23 | - | 2000K | Private |
 | ↳ >200K Context | | $2.83 | $5.67 | $0.45 | - | | |
 | Grok 4.20 Multi-Agent | `grok-4-20-multi-agent` | $1.42 | $2.83 | $0.23 | - | 2000K | Private |
@@ -68,29 +68,29 @@
 | Grok Build 0.1 (Beta) | `grok-build-0-1` | $1.00 | $2.00 | $0.20 | - | 256K | Private |
 | ↳ >200K Context | | $2.00 | $4.00 | $0.40 | - | | |
 | Hermes 3 Llama 3.1 405b | `hermes-3-llama-3.1-405b` | $1.10 | $3.00 | - | - | 128K | Private |
 | Kimi K2.5 | `kimi-k2-5` | $0.56 | $3.50 | $0.22 | - | 256K | Private |
 | Kimi K2.6 | `kimi-k2-6` | $0.85 | $4.66 | $0.22 | - | 256K | Private |
 | Llama 3.2 3B | `llama-3.2-3b` | $0.15 | $0.60 | - | - | 128K | Private |
 | Llama 3.3 70B | `llama-3.3-70b` | $0.70 | $2.80 | - | - | 128K | Private |
 | Mercury 2 (Beta) | `mercury-2` | $0.31 | $0.94 | $0.03 | - | 128K | Anonymized |
 | MiniMax M2.5 | `minimax-m25` | $0.34 | $1.19 | $0.04 | - | 198K | Private |
 | MiniMax M2.7 | `minimax-m27` | $0.38 | $1.50 | $0.07 | - | 198K | Anonymized |
 | Mistral Small 3.2 24B Instruct | `mistral-small-3-2-24b-instruct` | $0.09 | $0.25 | - | - | 256K | Private |
 | Mistral Small 4 (Beta) | `mistral-small-2603` | $0.19 | $0.75 | - | - | 256K | Private |
 | Nemotron Cascade 2 30B A3B (Beta) | `nvidia-nemotron-cascade-2-30b-a3b` | $0.14 | $0.80 | - | - | 256K | Private |
 | NVIDIA Nemotron 3 Nano 30B (Beta) | `nvidia-nemotron-3-nano-30b-a3b` | $0.07 | $0.30 | - | - | 128K | Private |
 | OpenAI GPT OSS 120B | `openai-gpt-oss-120b` | $0.07 | $0.30 | - | - | 128K | Private |
 | Qwen 2.5 7B (Beta) | `e2ee-qwen-2-5-7b-p` | $0.05 | $0.13 | - | - | 32K | E2EE · Private |
 | Qwen 3 235B A22B Instruct 2507 | `qwen3-235b-a22b-instruct-2507` | $0.15 | $0.75 | - | - | 128K | Private |
 | Qwen 3 235B A22B Thinking 2507 | `qwen3-235b-a22b-thinking-2507` | $0.45 | $3.50 | - | - | 128K | Private |
 | Qwen 3 Coder 480B Turbo (Beta) | `qwen3-coder-480b-a35b-instruct-turbo` | $0.35 | $1.50 | $0.04 | - | 256K | Private |
 | Qwen 3 Next 80b | `qwen3-next-80b` | $0.35 | $1.90 | - | - | 256K | Private |
 | Qwen 3.5 35B A3B (Beta) | `qwen3-5-35b-a3b` | $0.31 | $1.25 | $0.16 | - | 256K | Private |
 | Qwen 3.5 397B | `qwen3-5-397b-a17b` | $0.75 | $4.50 | - | - | 128K | Anonymized |
 | Qwen 3.5 9B | `qwen3-5-9b` | $0.10 | $0.15 | - | - | 256K | Private |
 | Qwen 3.6 27B | `qwen3-6-27b` | $0.33 | $3.25 | - | - | 256K | Private |
 | Qwen 3.6 35B A3B FP8 (Beta) | `e2ee-qwen3-6-35b-a3b` | $0.21 | $1.38 | $0.07 | - | 32K | E2EE · Private |
 | Qwen 3.6 Plus Uncensored (Beta) | `qwen-3-6-plus` | $0.63 | $3.75 | $0.06 | $0.78 | 1000K | Anonymized |
 | ↳ >256K Context | | $2.50 | $7.50 | $0.06 | $0.78 | | |
 | Qwen3 30B A3B (Beta) | `e2ee-qwen3-30b-a3b-p` | $0.19 | $0.69 | - | - | 256K | E2EE · Private |
 | Qwen3 VL 235B | `qwen3-vl-235b-a22b` | $0.25 | $1.50 | - | - | 256K | Private |
@@ -112,13 +112,13 @@
 |---|---|---|---|---|
 | BGE-EN-ICL | `text-embedding-bge-en-icl` | $0.01 | $0.01 | Private |
 | BGE-M3 | `text-embedding-bge-m3` | $0.15 | $0.60 | Private |
 | Gemini Embedding 2 Preview | `gemini-embedding-2-preview` | $0.25 | $0.25 | Anonymized |
 | Multilingual E5 Large Instruct | `text-embedding-multilingual-e5-large-instruct` | $0.01 | $0.01 | Private |
 | Nemotron Embed VL 1B v2 | `text-embedding-nemotron-embed-vl-1b-v2` | $0.01 | $0.01 | Private |
 | Qwen3 Embedding 0.6B | `text-embedding-qwen3-0-6b` | $0.01 | $0.01 | Private |
 | Qwen3 Embedding 8B | `text-embedding-qwen3-8b` | $0.01 | $0.01 | Private |
 | Text Embedding 3 Large | `text-embedding-3-large` | $0.16 | $0.16 | Anonymized |
 | Text Embedding 3 Small | `text-embedding-3-small` | $0.03 | $0.03 | Anonymized |

 </div>

@@ -132,38 +132,38 @@

 | Model | ID | Price | Privacy |
 |---|---|---|---|
 | Recraft V4 Pro | `recraft-v4-pro` | Per Image: $0.29 | Anonymized |
-| GPT Image 2 | `gpt-image-2` | 1K: $0.27, 2K: $0.51, 4K: $0.84 | Anonymized |
+| GPT Image 2 | `gpt-image-2` | 1K: $0.26, 2K: $0.50, 4K: $0.83 (quality `high`, default) — see [tier matrix](#quality-tier-pricing-gpt-image-2) | Anonymized |
 | GPT Image 1.5 | `gpt-image-1-5` | Per Image: $0.26 | Anonymized |
 | Nano Banana Pro | `nano-banana-pro` | 1K: $0.18, 2K: $0.23, 4K: $0.35 | Anonymized |
 | Nano Banana 2 | `nano-banana-2` | 1K: $0.10, 2K: $0.14, 4K: $0.19 | Anonymized |
 | Qwen Image 2 Pro | `qwen-image-2-pro` | Per Image: $0.10 | Anonymized |
 | Wan 2.7 Pro | `wan-2-7-pro-text-to-image` | Per Image: $0.09 | Anonymized |
 | Flux 2 Max | `flux-2-max` | Per Image: $0.09 | Anonymized |
 | Grok Imagine High Quality (SOTA) | `grok-imagine-image-quality` | 1K: $0.08, 2K: $0.10 | Private |
 | ImagineArt 1.5 Pro | `imagineart-1.5-pro` | Per Image: $0.06 | Anonymized |
 | Qwen Image 2 | `qwen-image-2` | Per Image: $0.05 | Anonymized |
 | Recraft V4 | `recraft-v4` | Per Image: $0.05 | Anonymized |
 | Seedream V4.5 | `seedream-v4` | Per Image: $0.05 | Anonymized |
 | Seedream V5 Lite | `seedream-v5-lite` | Per Image: $0.05 | Anonymized |
 | Flux 2 Pro | `flux-2-pro` | Per Image: $0.04 | Anonymized |
 | Grok Imagine | `grok-imagine-image` | 1K: $0.04, 2K: $0.06 | Private |
 | Wan 2.7 | `wan-2-7-text-to-image` | Per Image: $0.04 | Anonymized |
 | Background Remover | `bria-bg-remover` | Per Image: $0.03 | Anonymized |
 | Anime (WAI) | `wai-Illustrious` | Per Image: $0.01 | Private |
 | Chroma | `chroma` | Per Image: $0.01 | Private |
 | Lustify SDXL | `lustify-sdxl` | Per Image: $0.01 | Private |
 | Lustify v7 | `lustify-v7` | Per Image: $0.01 | Private |
 | Lustify v8 | `lustify-v8` | Per Image: $0.01 | Private |
 | Venice SD35 | `venice-sd35` | Per Image: $0.01 | Private |
 | Z-Image Turbo | `z-image-turbo` | Per Image: $0.01 | Private |
 | Hunyuan Image 3.0 (Beta) | `hunyuan-image-v3` | Per Image: $0.09 | Private |

 #### Upscaling

 | Model | ID | 2x Upscale | 4x Upscale |
 |---|---|---|---|
 | Image Upscaler | `upscaler` | $0.02 | $0.08 |

 #### Editing

@@ -172,18 +172,42 @@
 | FireRed Image Edit 1.1 | `firered-image-edit` | $0.04 |
 | Flux 2 Max | `flux-2-max-edit` | $0.19 |
 | GPT Image 1.5 | `gpt-image-1-5-edit` | $0.36 |
-| GPT Image 2 | `gpt-image-2-edit` | $0.36 |
+| GPT Image 2 | `gpt-image-2-edit` | 1K: $0.36, 2K: $0.53, 4K: $0.86 (quality `high`, default) — see [tier matrix](#quality-tier-pricing-gpt-image-2) |
 | Grok Imagine | `grok-imagine-edit` | $0.04 |
 | Grok Imagine High Quality | `grok-imagine-quality-edit` | $0.10 |
 | Nano Banana 2 | `nano-banana-2-edit` | $0.10 |
 | Nano Banana Pro | `nano-banana-pro-edit` | $0.18 |
 | Qwen Edit 2511 | `qwen-edit` | $0.04 |
 | Qwen Image 2 | `qwen-image-2-edit` | $0.05 |
 | Qwen Image 2 Pro | `qwen-image-2-pro-edit` | $0.10 |
 | Seedream V4.5 | `seedream-v4-edit` | $0.05 |
 | Seedream V5 Lite | `seedream-v5-lite-edit` | $0.05 |
 | Wan 2.7 Pro Edit | `wan-2-7-pro-edit` | $0.09 |
 
+#### Quality-Tier Pricing (GPT Image 2)
+
+`gpt-image-2` and `gpt-image-2-edit` accept an optional `quality` parameter (`low`, `medium`, `high`) that combines with `resolution` to determine price. The default tier is `high`; omitting `quality` charges the `high` rate for that resolution. See the [Generate](/api-reference/endpoint/image/generate) and [Edit](/api-reference/endpoint/image/edit) docs for usage.
+
+**`gpt-image-2` — Generate**
+
+| Resolution | low | medium | high (default) |
+|---|---|---|---|
+| 1K | $0.02 | $0.07 | $0.26 |
+| 2K | $0.03 | $0.13 | $0.50 |
+| 4K | $0.05 | $0.21 | $0.83 |
+
+**`gpt-image-2-edit` — Edit / Multi-Edit**
+
+| Resolution | low | medium | high (default) |
+|---|---|---|---|
+| 1K | $0.03 | $0.10 | $0.36 |
+| 2K | $0.04 | $0.15 | $0.53 |
+| 4K | $0.06 | $0.22 | $0.86 |
+
+<Info>
+Quality-aware pricing is the default for all API and SDK callers — no opt-in header required. Requests that omit `quality` are billed at the default tier (`high`). Programmatic clients can read the same matrix at runtime from `model_spec.pricing.quality` in the [Models endpoint](/api-reference/endpoint/models/list).
+</Info>
+
 </div>
 
 ### Audio
@@ -195,25 +219,25 @@
 | Model | ID | Per 1M Characters | Privacy |
 |---|---|---|---|
 | Chatterbox HD (Resemble AI) | `tts-chatterbox-hd` | $50.00 | Private |
 | ElevenLabs Turbo v2.5 | `tts-elevenlabs-turbo-v2-5` | $62.50 | Anonymized |
 | Gemini 3.1 Flash TTS | `tts-gemini-3-1-flash` | $187.50 | Anonymized |
 | Inworld TTS-1.5 Max | `tts-inworld-1-5-max` | $12.50 | Anonymized |
 | Kokoro Text to Speech | `tts-kokoro` | $3.50 | Private |
 | MiniMax Speech-02 HD | `tts-minimax-speech-02-hd` | $125.00 | Anonymized |
 | Orpheus TTS | `tts-orpheus` | $62.50 | Private |
 | Qwen 3 TTS 0.6B | `tts-qwen3-0-6b` | $87.50 | Private |
 | Qwen 3 TTS 1.7B | `tts-qwen3-1-7b` | $112.50 | Private |
 | xAI TTS v1 | `tts-xai-v1` | $18.75 | Anonymized |

 #### Speech-to-Text

 | Model | ID | Per Audio Second | Privacy |
 |---|---|---|---|
 | ElevenLabs Scribe V2 | `elevenlabs/scribe-v2` | $0.0002 | Anonymized |
 | Parakeet ASR | `nvidia/parakeet-tdt-0.6b-v3` | $0.0001 | Private |
 | Whisper Large V3 | `openai/whisper-large-v3` | $0.0001 | Private |
 | Wizper (Whisper v3) | `fal-ai/wizper` | $0.0001 | Private |
 | xAI Speech to Text v1 | `stt-xai-v1` | $0.0000 | Anonymized |

 </div>

@@ -225,24 +249,24 @@

 | Model | ID | Duration Pricing | Privacy |
 |---|---|---|---|
 | ACE-Step 1.5 | `ace-step-15` | 60s: $0.03, 90s: $0.04, 120s: $0.05, 150s: $0.06, 180s: $0.07, 210s: $0.08 | Anonymized |
 | ElevenLabs Music | `elevenlabs-music` | 60s: $0.87, 120s: $1.73, 180s: $2.59, 240s: $3.45, 300s: $4.32, 360s: $5.18, 420s: $6.04, 480s: $6.90, 540s: $7.77, 600s: $8.63 | Anonymized |

 #### Song Generation (Per-Generation)

 | Model | ID | Per Generation | Privacy |
 |---|---|---|---|
 | MiniMax Music 2.0 | `minimax-music-v2` | $0.04 | Anonymized |
 | MiniMax Music 2.5 | `minimax-music-v25` | $0.24 | Anonymized |
 | MiniMax Music 2.6 | `minimax-music-v26` | $0.24 | Anonymized |
 | Stable Audio 2.5 | `stable-audio-25` | $0.24 | Anonymized |

 #### Sound Effects (Per-Second)

 | Model | ID | Per Second | Privacy |
 |---|---|---|---|
 | ElevenLabs Sound Effects | `elevenlabs-sound-effects-v2` | $0.0023 | Anonymized |
 | MMAudio V2 | `mmaudio-v2-text-to-audio` | $0.0009 | Anonymized |

 </div>

@@ -258,94 +282,94 @@

 | Model | ID | Type | Pricing | Privacy |
 |---|---|---|---|---|
 | Grok Imagine | `grok-imagine-text-to-video` | Text to Video | Variable | Anonymized |
 | Grok Imagine | `grok-imagine-image-to-video` | Image to Video | Variable | Anonymized |
 | Grok Imagine Private | `grok-imagine-text-to-video-private` | Text to Video | Variable | Private |
 | Grok Imagine Private | `grok-imagine-image-to-video-private` | Image to Video | Variable | Private |
 | Grok Imagine Private | `grok-imagine-video-to-video-private` | Text to Video | Variable | Private |
 | Grok Imagine R2V (Beta) | `grok-imagine-reference-to-video` | Text to Video | Variable | Anonymized |
 | Grok Imagine R2V Private | `grok-imagine-reference-to-video-private` | Text to Video | Variable | Private |
 | HappyHorse 1.0 | `happyhorse-1-0-text-to-video` | Text to Video | Variable | Anonymized |
 | HappyHorse 1.0 | `happyhorse-1-0-image-to-video` | Image to Video | Variable | Anonymized |
 | HappyHorse 1.0 Edit | `happyhorse-1-0-video-to-video` | Text to Video | Variable | Anonymized |
 | HappyHorse 1.0 Reference | `happyhorse-1-0-reference-to-video` | Text to Video | Variable | Anonymized |
 | Kling 2.5 Turbo Pro | `kling-2.5-turbo-pro-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling 2.5 Turbo Pro | `kling-2.5-turbo-pro-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling 2.6 Pro | `kling-2.6-pro-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling 2.6 Pro | `kling-2.6-pro-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling O3 4K | `kling-o3-4k-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling O3 4K | `kling-o3-4k-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling O3 4K R2V | `kling-o3-4k-reference-to-video` | Text to Video | Variable | Anonymized |
 | Kling O3 Pro | `kling-o3-pro-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling O3 Pro | `kling-o3-pro-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling O3 Pro R2V (Beta) | `kling-o3-pro-reference-to-video` | Text to Video | Variable | Anonymized |
 | Kling O3 Standard | `kling-o3-standard-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling O3 Standard | `kling-o3-standard-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling O3 Standard R2V (Beta) | `kling-o3-standard-reference-to-video` | Text to Video | Variable | Anonymized |
 | Kling V3 4K | `kling-v3-4k-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling V3 4K R2V | `kling-v3-4k-reference-to-video` | Text to Video | Variable | Anonymized |
 | Kling V3 Pro | `kling-v3-pro-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling V3 Pro | `kling-v3-pro-image-to-video` | Image to Video | Variable | Anonymized |
 | Kling V3 Standard | `kling-v3-standard-text-to-video` | Text to Video | Variable | Anonymized |
 | Kling V3 Standard | `kling-v3-standard-image-to-video` | Image to Video | Variable | Anonymized |
 | Longcat Distilled | `longcat-distilled-image-to-video` | Image to Video | Variable | Private |
 | Longcat Distilled | `longcat-distilled-text-to-video` | Text to Video | Variable | Private |
 | Longcat Full Quality | `longcat-image-to-video` | Image to Video | Variable | Private |
 | Longcat Full Quality | `longcat-text-to-video` | Text to Video | Variable | Private |
 | LTX Video 2.0 19B | `ltx-2-19b-full-text-to-video` | Text to Video | Variable | Private |
 | LTX Video 2.0 19B | `ltx-2-19b-full-image-to-video` | Image to Video | Variable | Private |
 | LTX Video 2.0 19B Distilled | `ltx-2-19b-distilled-text-to-video` | Text to Video | Variable | Private |
 | LTX Video 2.0 19B Distilled | `ltx-2-19b-distilled-image-to-video` | Image to Video | Variable | Private |
 | LTX Video 2.0 Fast | `ltx-2-fast-image-to-video` | Image to Video | Variable | Anonymized |
 | LTX Video 2.0 Fast | `ltx-2-fast-text-to-video` | Text to Video | Variable | Anonymized |
 | LTX Video 2.0 Full Quality | `ltx-2-full-image-to-video` | Image to Video | Variable | Anonymized |
 | LTX Video 2.0 Full Quality | `ltx-2-full-text-to-video` | Text to Video | Variable | Anonymized |
 | LTX Video 2.3 Fast | `ltx-2-v2-3-fast-image-to-video` | Image to Video | Variable | Anonymized |
 | LTX Video 2.3 Fast | `ltx-2-v2-3-fast-text-to-video` | Text to Video | Variable | Anonymized |
 | LTX Video 2.3 Full Quality | `ltx-2-v2-3-full-image-to-video` | Image to Video | Variable | Anonymized |
 | LTX Video 2.3 Full Quality | `ltx-2-v2-3-full-text-to-video` | Text to Video | Variable | Anonymized |
 | Ovi | `ovi-image-to-video` | Image to Video | Variable | Private |
 | PixVerse C1 | `pixverse-c1-text-to-video` | Text to Video | Variable | Anonymized |
 | PixVerse C1 | `pixverse-c1-image-to-video` | Image to Video | Variable | Anonymized |
 | PixVerse C1 R2V | `pixverse-c1-reference-to-video` | Text to Video | Variable | Anonymized |
 | PixVerse C1 Transition | `pixverse-c1-transition` | Text to Video | Variable | Anonymized |
 | PixVerse v5.6 | `pixverse-v5.6-text-to-video` | Text to Video | Variable | Anonymized |
 | PixVerse v5.6 | `pixverse-v5.6-image-to-video` | Image to Video | Variable | Anonymized |
 | PixVerse v5.6 Transition | `pixverse-v5.6-transition` | Text to Video | Variable | Anonymized |
 | Runway Gen-4 Aleph | `runway-gen4-aleph` | Text to Video | Variable | Anonymized |
 | Runway Gen-4 Turbo | `runway-gen4-turbo` | Text to Video | Variable | Anonymized |
 | Runway Gen-4.5 | `runway-gen4-5` | Text to Video | Variable | Anonymized |
 | Runway Gen-4.5 | `runway-gen4-5-text` | Text to Video | Variable | Anonymized |
 | Seedance 1.5 Pro | `seedance-1-5-pro-text-to-video` | Text to Video | Variable | Anonymized |
 | Seedance 1.5 Pro | `seedance-1-5-pro-image-to-video` | Image to Video | Variable | Anonymized |
 | Seedance 2.0 | `seedance-2-0-text-to-video` | Text to Video | Variable | Anonymized |
 | Seedance 2.0 | `seedance-2-0-image-to-video` | Image to Video | Variable | Anonymized |
 | Seedance 2.0 Fast | `seedance-2-0-fast-text-to-video` | Text to Video | Variable | Anonymized |
 | Seedance 2.0 Fast | `seedance-2-0-fast-image-to-video` | Image to Video | Variable | Anonymized |
 | Seedance 2.0 Fast R2V | `seedance-2-0-fast-reference-to-video` | Text to Video | Variable | Anonymized |
 | Seedance 2.0 R2V | `seedance-2-0-reference-to-video` | Text to Video | Variable | Anonymized |
 | Topaz Video Upscale | `topaz-video-upscale` | Text to Video | Variable | Anonymized |
 | Veo 3 Fast | `veo3-fast-text-to-video` | Text to Video | Variable | Anonymized |
 | Veo 3 Fast | `veo3-fast-image-to-video` | Image to Video | Variable | Anonymized |
 | Veo 3 Full Quality | `veo3-full-text-to-video` | Text to Video | Variable | Anonymized |
 | Veo 3 Full Quality | `veo3-full-image-to-video` | Image to Video | Variable | Anonymized |
 | Veo 3.1 Fast | `veo3.1-fast-text-to-video` | Text to Video | Variable | Anonymized |
 | Veo 3.1 Fast | `veo3.1-fast-image-to-video` | Image to Video | Variable | Anonymized |
 | Veo 3.1 Full Quality | `veo3.1-full-text-to-video` | Text to Video | Variable | Anonymized |
 | Veo 3.1 Full Quality | `veo3.1-full-image-to-video` | Image to Video | Variable | Anonymized |
 | Vidu Q3 | `vidu-q3-text-to-video` | Text to Video | Variable | Anonymized |
 | Vidu Q3 | `vidu-q3-image-to-video` | Image to Video | Variable | Anonymized |
 | Wan 2.1 Pro | `wan-2.1-pro-image-to-video` | Image to Video | Variable | Private |
 | Wan 2.2 A14B | `wan-2.2-a14b-text-to-video` | Text to Video | Variable | Private |
 | Wan 2.5 Preview | `wan-2.5-preview-image-to-video` | Image to Video | Variable | Anonymized |
 | Wan 2.5 Preview | `wan-2.5-preview-text-to-video` | Text to Video | Variable | Anonymized |
 | Wan 2.6 | `wan-2.6-image-to-video` | Image to Video | Variable | Anonymized |
 | Wan 2.6 | `wan-2.6-text-to-video` | Text to Video | Variable | Anonymized |
 | Wan 2.6 Flash | `wan-2.6-flash-image-to-video` | Image to Video | Variable | Anonymized |
 | Wan 2.7 | `wan-2-7-text-to-video` | Text to Video | Variable | Anonymized |
 | Wan 2.7 | `wan-2-7-image-to-video` | Image to Video | Variable | Anonymized |
 | Wan 2.7 Edit | `wan-2-7-video-to-video` | Text to Video | Variable | Anonymized |
 | Wan 2.7 Reference | `wan-2-7-reference-to-video` | Text to Video | Variable | Anonymized |

 </div>

@@ -366,7 +390,7 @@
 <Info>
 **Web Scraping** automatically detects up to 5 URLs per request, scrapes and converts content into structured markdown, and adds the extracted text into model context. Only successfully scraped URLs are billed.

 **X Search** enables xAI's native search for supported Grok models (e.g., `grok-4-20-beta`). This searches both the web and X/Twitter for real-time information. Billed per search result returned by the model (e.g., if the model returns 10 search results, you are charged for 10 results at $0.01 each = $0.10).

 These charges apply in addition to standard model token pricing.
 </Info>
@@ -378,7 +402,7 @@
    Buy API credits with credit card. Credits never expire.
  </Card>
  <Card title="Crypto" icon="bitcoin" href="https://venice.ai/settings/api">
    Buy API credits with cryptocurrency. Same rates as USD.
  </Card>
  <Card title="Stake DIEM" icon="coins" href="https://venice.ai/token">
    Each Diem = $1/day of credits that refresh daily.