runblob 0.1.0

Official Python SDK for RunBlob AI generation platform — async-first, high-throughput, production-grade

RunBlob Python SDK

Official async-first Python SDK for the RunBlob AI generation platform.

Install

pip install runblob

Quick Start

import asyncio
from runblob import RunBlob

async def main():
    async with RunBlob(api_key="rb_...") as client:
        # Generate and wait for result
        result = await client.nanobanana.generate_and_wait(
            prompt="A cute orange cat on a windowsill",
            model="pro",
            quality="4k",
        )
        print(result.result_image_url)

asyncio.run(main())

Features

• Async-first with httpx + HTTP/2
• Connection pooling (100 concurrent connections)
• Automatic retry with exponential backoff
• Circuit breaker for cascading failure protection
• Client-side rate limiting (token bucket)
• TTL cache for GET requests
• Auto-polling with generate_and_wait()
• Batch generation support
• Webhook verification
• Full type hints (py.typed, Pydantic v2)