Python SDK

pip install rimp

from rimp import Client

client = Client(api_key=os.environ["RIMP_API_KEY"])
# base_url defaults to https://api.rimp.example

gen = client.generations.create_image(
    model="flux-pro",
    prompt="a red rimp on chrome",
    aspect_ratio="1:1",
)
print(gen["outputs"][0]["url"])

job = client.generations.create_video(
    model="veo-3-1-fast",
    prompt="waves at golden hour",
    duration_s=4,
)
final = client.generations.wait_for(job["id"], poll_interval_s=2.0, timeout_s=1800)

client.generations.cancel(job_id)

cmp = client.comparisons.create(
    prompt="cinematic portrait",
    models=["flux-pro", "imagen-4"],
)
result = client.comparisons.wait_for(cmp["id"])
for g in result["generations"]:
    print(g["model"], g["outputs"][0]["url"])

models = client.models.list()
upload = client.uploads.create_presigned("image/png")
client.webhooks.create(url="https://...", events=["generation.completed"])
usage = client.usage.get(start="2026-05-01", end="2026-05-31", group_by="model")

from rimp import RimpApiError

try:
    client.generations.create_image(model="flux-pro", prompt="...")
except RimpApiError as err:
    print(err.status, err.code, err.message, err.request_id)

# Not yet released. Track at https://github.com/rimp-labs/rimp-python/issues/3

import asyncio

async def main():
    gen = await asyncio.to_thread(
        client.generations.create_image,
        model="flux-pro", prompt="..."
    )

import httpx
from rimp import Client

http = httpx.Client(timeout=60.0, proxies="http://corp-proxy:8080")
client = Client(api_key=KEY, http_client=http)