docs: add API references for 28 newly launched models

model-api-reference/image-generation.md

@@ -15,14 +15,17 @@ Image Generation models use the SandBase generation protocol declared in each mo
 
 - [GPT Image 2 Official API](/model-api-reference/image-generation/openai/gpt-image-2-official) — GPT Image 2 through the OpenAI Images API contract.
 - [GPT Image 2 Official Edit API](/model-api-reference/image-generation/openai/gpt-image-2-official/edit) — GPT Image 2 editing through the OpenAI Images API contract.
+- [GPT Image 2.5 Flare](/model-api-reference/image-generation/openai/gpt-image-2.5-flare) — GPT Image 2.5 Flare is optimized for fast, high-quality image generation for everyday creative workflows.
+- [GPT Image 2.5 Flare Edit](/model-api-reference/image-generation/openai/gpt-image-2.5-flare/edit) — GPT Image 2.5 Flare Edit is optimized for fast, high-quality image editing and multi-image composition.
+- [GPT Image 2.5 Sunburst](/model-api-reference/image-generation/openai/gpt-image-2.5-sunburst) — GPT Image 2.5 Sunburst prioritizes visual fidelity and precision for complex image generation workflows.
+- [GPT Image 2.5 Sunburst Edit](/model-api-reference/image-generation/openai/gpt-image-2.5-sunburst/edit) — GPT Image 2.5 Sunburst Edit prioritizes precision and visual fidelity for complex image editing workflows.
 - [GPT Image 2](/model-api-reference/image-generation/openai/gpt-image-2) — GPT Image 2, OpenAI's available image model, is capable of making fine-grained, detailed edits to images.
 - [GPT Image 2 Editing](/model-api-reference/image-generation/openai/gpt-image-2/edit) — GPT Image 2 Editing supports image editing and multi-image synthesis with high-quality results.
 - [GPT-Image 1.5](/model-api-reference/image-generation/openai/gpt-image-1.5/edit) — Gpt Image 1.5 Edit by OpenAI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
 - [GPT Image 1.5](/model-api-reference/image-generation/openai/gpt-image-1.5) — Gpt Image 1.5 is OpenAI's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.
 - [GPT Image 1 Mini Edit](/model-api-reference/image-generation/openai/gpt-image-1-mini/edit) — Gpt Image 1 Mini Edit is OpenAI's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
 - [GPT Image 1 Mini](/model-api-reference/image-generation/openai/gpt-image-1-mini) — Gpt Image 1 Mini by OpenAI - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.
-- [GPT Image 1](/model-api-reference/image-generation/openai/gpt-image-1) — Gpt Image 1 is OpenAI's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.
-- [GPT Image 1 Edit](/model-api-reference/image-generation/openai/gpt-image-1/edit) — Gpt Image 1 Edit by OpenAI - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
+- …and 2 more models in the sidebar.
 
 ### Google
 
@@ -269,6 +272,10 @@ Image Generation models use the SandBase generation protocol declared in each mo
 - [MAI Image 2.5 Pro (Edit)](/model-api-reference/image-generation/microsoft/mai-image-2.5-pro/edit) — Mai Image 2.5 Pro Edit by Microsoft - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
 - [Mai Image 2.5](/model-api-reference/image-generation/microsoft/mai-image-2.5/edit) — Mai Image 2.5 Edit by Microsoft - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
 
+### Midjourney
+
+- [Midjourney V8.1](/model-api-reference/image-generation/midjourney/midjourney-v8.1) — Midjourney V8.1 text-to-image generation through Evolink.ai.
+
 ### MiniMax
 
 - [Minimax Image Subject Reference](/model-api-reference/image-generation/minimax/image-01/subject-reference) — Image 01 Subject Reference by MiniMax - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
@@ -362,6 +369,14 @@ Image Generation models use the SandBase generation protocol declared in each mo
 
 ### Topaz Labs
 
+- [Topaz Adjust Image](/model-api-reference/image-generation/topaz/adjust/image) — Adjust Image by Topaz Labs - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
+- [Topaz Sharpen Image](/model-api-reference/image-generation/topaz/sharpen/image) — Sharpen Image is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
+- [Topaz Denoise Image](/model-api-reference/image-generation/topaz/denoise/image) — Denoise Image is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
+- [Topaz Restore Image](/model-api-reference/image-generation/topaz/restore/image) — Restore Image is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
+- [Topaz Upscale Image Transparent](/model-api-reference/image-generation/topaz/upscale/image/transparent) — Upscale Image Transparent is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
+- [Topaz Upscale Image Creative](/model-api-reference/image-generation/topaz/upscale/image/creative) — Upscale Image Creative by Topaz Labs - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
+- [Topaz Upscale Image Generative](/model-api-reference/image-generation/topaz/upscale/image/generative) — Upscale Image Generative by Topaz Labs - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
+- [Topaz Upscale Image Precision](/model-api-reference/image-generation/topaz/upscale/image/precision) — Upscale Image Precision is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
 - [Topaz Upscale](/model-api-reference/image-generation/topaz/upscale/image) — Upscale Image is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
 
 ### trellis

model-api-reference/image-generation/midjourney/midjourney-v8.1.md

@@ -0,0 +1,21 @@
+---
+title: "Midjourney V8.1 API Reference"
+description: "Midjourney V8.1 API reference for SandBase. Use model midjourney/midjourney-v8.1 with /v1/run; see request and response examples."
+aside: false
+outline: false
+apiReferenceKey: "image/midjourney/midjourney-v8.1"
+apiReferenceJson: "{\"title\":\"Midjourney V8.1\",\"operation\":\"Image Generation\",\"method\":\"POST\",\"path\":\"/v1/run\",\"description\":\"Midjourney V8.1 text-to-image generation through Evolink.ai.\",\"groups\":[{\"title\":\"Request body\",\"description\":\"Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.\",\"fields\":[{\"name\":\"model\",\"type\":\"string\",\"required\":true,\"description\":\"Model identifier. Set to midjourney/midjourney-v8.1.\",\"default\":\"midjourney/midjourney-v8.1\"},{\"name\":\"prompt\",\"type\":\"string\",\"required\":true,\"description\":\"Text prompt used to generate the image.\"},{\"name\":\"speed\",\"type\":\"string\",\"required\":false,\"description\":\"Generation speed.\",\"default\":\"fast\",\"constraints\":\"Allowed values: draft, fast\"},{\"name\":\"quality\",\"type\":\"string\",\"required\":false,\"description\":\"Output quality. HD is unavailable with draft speed.\",\"default\":\"standard\",\"constraints\":\"Allowed values: standard, hd\"}]},{\"title\":\"Response Schema\",\"description\":\"The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.\",\"fields\":[{\"name\":\"id\",\"type\":\"string\",\"required\":true,\"description\":\"Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.\"},{\"name\":\"status\",\"type\":\"string\",\"required\":true,\"description\":\"Current public run status.\",\"constraints\":\"Allowed values: pending, running, completed, failed, timeout\"},{\"name\":\"model\",\"type\":\"string\",\"required\":false,\"description\":\"Public SandBase model name used for this run.\"},{\"name\":\"outputs\",\"type\":\"array<object>\",\"required\":false,\"description\":\"Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.\"},{\"name\":\"error\",\"type\":\"object\",\"required\":false,\"description\":\"Present only for failed or timeout runs. Contains a public error type and sanitized message.\"},{\"name\":\"error.type\",\"type\":\"string\",\"required\":false,\"description\":\"Stable public error category.\"},{\"name\":\"error.message\",\"type\":\"string\",\"required\":false,\"description\":\"Sanitized error message safe to show to clients.\"},{\"name\":\"usage\",\"type\":\"object\",\"required\":false,\"description\":\"Usage details when available.\"}]},{\"title\":\"Model capabilities\",\"fields\":[{\"name\":\"capability_tags\",\"type\":\"array<string>\",\"required\":true,\"description\":\"Capabilities declared by the model registry.\",\"default\":\"text-to-image, commercial\"},{\"name\":\"execution_mode\",\"type\":\"string\",\"required\":true,\"description\":\"Execution mode declared by the model registry.\",\"default\":\"async\"}]}],\"examples\":[{\"label\":\"cURL\",\"language\":\"bash\",\"code\":\"# 1. Submit a generation request\\ncurl -X POST https://api.sandbase.ai/v1/run \\\\\\n  -H \\\"Authorization: Bearer $SANDBASE_API_KEY\\\" \\\\\\n  -H \\\"Content-Type: application/json\\\" \\\\\\n  -d '{\\n  \\\"model\\\": \\\"midjourney/midjourney-v8.1\\\",\\n  \\\"prompt\\\": \\\"A cinematic product photo of a matte black smart speaker on a marble table, soft studio lighting\\\"\\n}'\\n\\n# 2. If the response is still running, poll the returned id\\ncurl https://api.sandbase.ai/v1/run/f3d2e8a1-7c4b-4a12-9d2e-123456789abc \\\\\\n  -H \\\"Authorization: Bearer $SANDBASE_API_KEY\\\"\"},{\"label\":\"Python\",\"language\":\"python\",\"code\":\"import os\\nimport time\\nimport requests\\n\\napi_url = \\\"https://api.sandbase.ai\\\"\\nheaders = {\\n    \\\"Authorization\\\": f\\\"Bearer {os.environ['SANDBASE_API_KEY']}\\\",\\n    \\\"Content-Type\\\": \\\"application/json\\\",\\n}\\npayload = {\\n  \\\"model\\\": \\\"midjourney/midjourney-v8.1\\\",\\n  \\\"prompt\\\": \\\"A cinematic product photo of a matte black smart speaker on a marble table, soft studio lighting\\\"\\n}\\n\\nresponse = requests.post(f\\\"{api_url}/v1/run\\\", headers=headers, json=payload)\\nresponse.raise_for_status()\\nresult = response.json()\\n\\nwhile result[\\\"status\\\"] in (\\\"pending\\\", \\\"running\\\"):\\n    time.sleep(2)\\n    result = requests.get(f\\\"{api_url}/v1/run/\\\" + result[\\\"id\\\"], headers=headers).json()\\n\\nprint(result)\"},{\"label\":\"TypeScript\",\"language\":\"typescript\",\"code\":\"const apiUrl = \\\"https://api.sandbase.ai\\\";\\nconst headers = {\\n  Authorization: `Bearer ${process.env.SANDBASE_API_KEY}`,\\n  \\\"Content-Type\\\": \\\"application/json\\\",\\n};\\n\\nconst payload = {\\n  \\\"model\\\": \\\"midjourney/midjourney-v8.1\\\",\\n  \\\"prompt\\\": \\\"A cinematic product photo of a matte black smart speaker on a marble table, soft studio lighting\\\"\\n};\\n\\nconst submit = await fetch(apiUrl + \\\"/v1/run\\\", {\\n  method: \\\"POST\\\",\\n  headers,\\n  body: JSON.stringify(payload),\\n});\\nif (!submit.ok) throw new Error(await submit.text());\\nlet result = await submit.json();\\n\\nwhile ([\\\"pending\\\", \\\"running\\\"].includes(result.status)) {\\n  await new Promise((resolve) => setTimeout(resolve, 2000));\\n  const poll = await fetch(apiUrl + \\\"/v1/run/\\\" + result.id, { headers });\\n  if (!poll.ok) throw new Error(await poll.text());\\n  result = await poll.json();\\n}\\n\\nconsole.log(result);\"}],\"response\":{\"status\":\"202 Accepted\",\"code\":\"{\\n  \\\"id\\\": \\\"f3d2e8a1-7c4b-4a12-9d2e-123456789abc\\\",\\n  \\\"model\\\": \\\"midjourney/midjourney-v8.1\\\",\\n  \\\"status\\\": \\\"running\\\"\\n}\"}}"
+seo:
+  modelName: "Midjourney V8.1"
+  modelId: "midjourney/midjourney-v8.1"
+  vendor: "Midjourney"
+  vendorSlug: "midjourney"
+  modelSlug: "midjourney-v8.1"
+  protocol: "Image Generation Reference"
+  endpoint: "/v1/run"
+  publishedAt: ""
+  capabilities: ["text-to-image","commercial"]
+  category: "Image Generation"
+---
+
+<ApiReferencePage />