Integrations

Python SDK

Script uploads, browsing, version loading, and agent workflows with the GenAsset Python SDK.

Install SDK

Install from GitHub

bash

pip install git+https://github.com/steliosot/gen-asset-sdk.git

Create a client

Use the workspace token created in Settings or Onboarding.

Client setup

python

from gen_asset_sdk import GenAssetClient

client = GenAssetClient(
    token="ga_your_workspace_token",
)

Save an image

Save the preview and the recipe fields that let you reproduce or continue the run later.

Save image

python

result = client.save_image(
    image_path="output.png",
    asset_name="portrait-run-01",
    prompt="55mm portrait, rain-soaked courtyard, blue coat",
    model="Juggernaut XL",
    seed=530117223,
    workflow_json={"flow": "txt2img"},
    metadata={"sampler": "euler", "steps": 24, "cfg": 5.5},
)

print(result["asset"]["id"], result["version"]["id"])

Load and reuse

Search assets, load a version, and pass the returned prompt, seed, metadata, or workflow JSON into your next run.

Load version

python

assets = client.list_assets(search="portrait-run-01", limit=20)
asset = client.get_asset(assets[0]["id"])
version = client.load_version(asset["versions"][0]["id"])

print(version["prompt"])
print(version["seed"])

Errors

Minimal error handling

python

from gen_asset_sdk import GenAssetError

try:
    client.list_assets(limit=5)
except GenAssetError as err:
    print(f"GenAsset request failed: {err}")