Stability Conservative Upscale

Developer documentation

Stability Conservative Upscale

Stability AI upscaling that preserves the original image with minimal reinterpretation.

Model Reference

Image generation and editing models

Prompt-to-image, image editing, image merging, upscaling, and background removal. Endpoint: https://omixa.cloud/api/v1/images/generations

Stability Conservative Upscale

stability-upscale-conservative

Stability AI upscaling that preserves the original image with minimal reinterpretation.

图像

Image per unit $0.400000

Minimum hold $0.010000

Integration reference

Connect Stability Conservative Upscale

Use Omixa's unified endpoint and your workspace API key. Provider routing, billing, failover, and usage records are handled by Omixa.

POST https://omixa.cloud/api/v1/images/generations

Provider: stability
Endpoint type: stability_image_edit

Request schema

Request fields

Only send options supported by this model. Required fields and accepted values are listed below.

Field	类型	Required	Accepted values	描述
`model`	string	Yes	stability-upscale-conservative	Use `stability-upscale-conservative`. Omixa resolves the active provider route and failover key automatically.
`model`	string	Yes	Any valid value	The Omixa Stability tool slug.
`input_images`	array	Yes	Any valid value	Exactly one inline PNG, JPG, or WebP source image. Use `{type:"image_url", image_url:{url:"data:image/png;base64,..."}}`.
`output_format`	string	No	png, jpeg, webp	Preferred output file format.
`prompt`	string	Yes	1-10000 characters	A descriptive English prompt for the upscaled result.
`negative_prompt`	string	No	up to 10000 characters	Details to avoid in the upscaled result.
`seed`	integer	No	0-4294967294	Deterministic seed. Omit or use 0 for a random seed.
`creativity`	number	No	0.2-0.5 (default 0.35)	Controls how much additional detail the upscaler may create.

Ready to send

Payload and response

Start with this model-safe payload and expect the normalized Omixa response shape shown beside it.

Example JSON payload

{
    "model": "stability-upscale-conservative",
    "output_format": "png",
    "input_images": [
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,<base64-image>"
            }
        }
    ],
    "prompt": "Preserve the subject while restoring crisp, realistic detail.",
    "creativity": 0.35
}

Response shape

{
    "created": 1780660800,
    "data": [
        {
            "b64_json": "<base64-image>",
            "url": null
        }
    ],
    "usage": {
        "billed_amount": "0.039000"
    }
}

Language examples

Copy-ready integration code

Replace the example API key with a workspace key and keep model-specific fields unchanged unless the table above marks them optional.

curl -X POST https://omixa.cloud/api/v1/images/generations \
  -H "Authorization: Bearer omx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "stability-upscale-conservative",
    "output_format": "png",
    "input_images": [
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,<base64-image>"
            }
        }
    ],
    "prompt": "Preserve the subject while restoring crisp, realistic detail.",
    "creativity": 0.35
}'

const response = await fetch('https://omixa.cloud/api/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer omx_live_xxx',
    'Content-Type': 'application/json'
  },
  body: "{\n    \"model\": \"stability-upscale-conservative\",\n    \"output_format\": \"png\",\n    \"input_images\": [\n        {\n            \"type\": \"image_url\",\n            \"image_url\": {\n                \"url\": \"data:image/png;base64,<base64-image>\"\n            }\n        }\n    ],\n    \"prompt\": \"Preserve the subject while restoring crisp, realistic detail.\",\n    \"creativity\": 0.35\n}"
});
const data = await response.json();

import requests

response = requests.post(
    'https://omixa.cloud/api/v1/images/generations',
    headers={'Authorization': 'Bearer omx_live_xxx', 'Content-Type': 'application/json'},
    json={
    "model": "stability-upscale-conservative",
    "output_format": "png",
    "input_images": [
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,<base64-image>"
            }
        }
    ],
    "prompt": "Preserve the subject while restoring crisp, realistic detail.",
    "creativity": 0.35
}
)
print(response.json())

$ch = curl_init('https://omixa.cloud/api/v1/images/generations');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer omx_live_xxx', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{
    "model": "stability-upscale-conservative",
    "output_format": "png",
    "input_images": [
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,<base64-image>"
            }
        }
    ],
    "prompt": "Preserve the subject while restoring crisp, realistic detail.",
    "creativity": 0.35
}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "omx_live_xxx");
var json = @"{
    ""model"": ""stability-upscale-conservative"",
    ""output_format"": ""png"",
    ""input_images"": [
        {
            ""type"": ""image_url"",
            ""image_url"": {
                ""url"": ""data:image/png;base64,<base64-image>""
            }
        }
    ],
    ""prompt"": ""Preserve the subject while restoring crisp, realistic detail."",
    ""creativity"": 0.35
}";
var response = await client.PostAsync("https://omixa.cloud/api/v1/images/generations", new StringContent(json, System.Text.Encoding.UTF8, "application/json"));
var body = await response.Content.ReadAsStringAsync();

payload := []byte(`{
    "model": "stability-upscale-conservative",
    "output_format": "png",
    "input_images": [
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,<base64-image>"
            }
        }
    ],
    "prompt": "Preserve the subject while restoring crisp, realistic detail.",
    "creativity": 0.35
}`)
req, _ := http.NewRequest("POST", "https://omixa.cloud/api/v1/images/generations", bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer omx_live_xxx")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)

Production checklist

Operational notes

Authenticate with `Authorization: Bearer omx_live_xxx`.
Omixa handles provider keys, routing, billing, failover, and usage recording behind this endpoint.
For edits and reference workflows, send inline image data URLs. Omixa does not fetch arbitrary remote image URLs for providers that require inline media.