Image Generation · Standard & Uncensored.

pip install openai

# For scripts and the cURL test (replace KEY with your own key)
export OUTRUN_API_KEY="KEY"

# Python (pip install openai). Enter your key locally as OUTRUN_API_KEY.
import base64, os
from pathlib import Path
from urllib.parse import urlsplit
from urllib.request import urlopen
from openai import OpenAI

client = OpenAI(api_key=os.environ["OUTRUN_API_KEY"], base_url="https://api.outrun.to/v1", max_retries=0)
result = client.images.generate(
    model="gemini-3-pro-image",  # uncensored: vision-image-uncensored or another text-to-image ID above
    prompt="A watercolor fox reading a book",
    n=1,
)
image = result.data[0]
if image.b64_json:
    content = base64.b64decode(image.b64_json)
elif image.url:
    url = urlsplit(image.url)
    if url.scheme != "https" or url.hostname not in {"api.outrun.to", "outrun.to"} or url.username or url.password:
        raise RuntimeError("Use your app to open this image. Automatic downloads require an Outrun HTTPS media URL.")
    try:
        with urlopen(image.url, timeout=60) as response:
            content = response.read()
    except Exception:
        raise RuntimeError("Image download failed. Check Activity before generating again.") from None
else:
    raise RuntimeError("No image data returned. Check Activity before trying again.")
Path("image.png").write_bytes(content)
print("Saved image.png")