Python

Install and configure visgate-sdk for Python 3.9+.

Installation

pip install visgate-sdk

Requires Python 3.9+.

Synchronous Client

from visgate_sdk import Client
 
client = Client(
    api_key="vg-...",                        # or $VISGATE_API_KEY
    base_url="https://visgateai.com/api/v1", # default
    timeout=120.0,                           # seconds, default
    fal_key=None,                            # optional BYOK
)
 
result = client.generate("a sunset over Istanbul")
print(result.image_url)
client.close()

Or with a context manager:

with Client() as client:
    result = client.generate("a sunset over Istanbul")
    print(result.image_url)

Asynchronous Client

from visgate_sdk import AsyncClient
import asyncio
 
async def main():
    async with AsyncClient(api_key="vg-...") as client:
        result = await client.generate("a sunset")
        print(result.image_url)
 
        models = await client.models.list(limit=10)
 
asyncio.run(main())

Every method on Client has an async counterpart on AsyncClient.

Configuration

ParameterDefaultDescription
api_key$VISGATE_API_KEYVisgate API key
base_urlhttps://visgateai.com/api/v1API base URL
timeout120.0Request timeout (seconds)
max_retries2Automatic retries for transient errors
fal_keyNoneFal.ai BYOK key
replicate_keyNoneReplicate BYOK key
runway_keyNoneRunway BYOK key

Features

  • Sync and asyncClient for synchronous code, AsyncClient for async
  • Automatic retries — transient errors (429, 5xx) retried with exponential backoff
  • Typed exceptions — catch AuthenticationError, RateLimitError, ProviderError, etc.
  • Full type hints — PEP 561 compliant with py.typed marker
  • Context managers — both clients support with / async with for cleanup

On this page