Quick Start

Get up and running with AizelCommerce SDK in under 5 minutes.

Installation

# Private repo - access granted after approval
git clone git@github.com:AizelNetwork/aizel-commerce-sdk.git
cd aizel-commerce-sdk
pip install -e .

Requirements: Python 3.9+

Set Your API Key

export AIZEL_API_KEY=your_api_key_here

Or pass it directly:

from aizel_commerce import AizelCommerce

client = AizelCommerce(api_key="your_api_key_here")

Your First Product Analysis

from aizel_commerce import AizelCommerce

client = AizelCommerce()

# Analyze a single product
result = client.product.analyze(
    title="Sony WH-1000XM5 Wireless Noise Cancelling Headphones",
    description="Industry-leading noise cancellation with Auto NC Optimizer...",
    images=["https://example.com/product-front.jpg"],
    category="electronics/audio",
    market="amazon_us"
)

print(result.selling_points)
# ['Industry-leading ANC technology', '30-hour battery life', 
#  'Multipoint connection', 'Speak-to-Chat auto-pause']

print(result.pricing_insight)
# PricingInsight(
#   market_position='premium',
#   suggested_range=(298, 349),
#   competitor_avg=279.99,
#   price_elasticity=0.72
# )

print(result.attributes)
# {'brand': 'Sony', 'type': 'Over-ear', 'connectivity': 'Bluetooth 5.2',
#  'battery': '30h', 'weight': '250g', 'anc': True, ...}

Generate Marketing Assets

# Generate images from analysis
images = client.creative.generate_images(
    product=result,
    styles=["hero_shot", "lifestyle", "comparison"],
    sizes=["1200x1200", "1080x1920", "1200x628"],
    count=3
)

for img in images:
    print(f"{img.style} — {img.size} — {img.url}")
# hero_shot — 1200x1200 — https://cdn.aizel.io/gen/abc123.png
# lifestyle — 1080x1920 — https://cdn.aizel.io/gen/def456.png
# comparison — 1200x628 — https://cdn.aizel.io/gen/ghi789.png

Run a Full Pipeline

Chain multiple modules together in a single call:

# One call: analyze → SEO → images → copy → video
pipeline = client.pipeline.run(
    product_url="https://amazon.com/dp/B0BX2L8PBT",
    outputs=["analysis", "seo", "images", "copy", "video"],
    platforms=["amazon", "shopify", "tiktok_shop"],
    languages=["en", "ja"]
)

print(f"Generated {len(pipeline.assets)} assets in {pipeline.elapsed_ms}ms")
# Generated 42 assets in 8320ms

Batch Processing (Scale)

Process your entire catalog in parallel:

import pandas as pd

catalog = pd.read_csv("my_catalog.csv")

# Process 1000 products concurrently
results = client.product.batch_analyze(
    products=catalog.to_dict("records"),
    fields=["selling_points", "pricing", "seo_keywords"],
    concurrency=50  # 50 parallel workers
)

print(f"Analyzed {len(results)} products in {results.elapsed}s")
# Analyzed 1000 products in 94.2s

# Generate assets for all products
assets = client.creative.batch_generate(
    products=results,
    outputs=["hero_image", "social_post", "video_15s"],
    platforms=["amazon", "tiktok_shop"],
    languages=["en", "ja", "de"]
)

# 1000 products × 3 assets × 2 platforms × 3 languages = 18,000 assets
print(f"Generated {len(assets)} assets")

On-Chain Payment (Optional)

Pay for API usage via AgentPay smart contracts:

# Initialize with on-chain payment
client = AizelCommerce(
    payment_mode="on_chain",
    wallet_address="0x...",
    chain="arbitrum"  # or "bsc", "avalanche", "ethereum"
)

# Usage is automatically settled on-chain via AgentPay protocol
result = client.product.analyze(...)
print(result.tx_hash)  # On-chain payment receipt

Next Steps

results matching ""

    No results matching ""