Skip to content

UnitySVC Seller SDK

unitysvc-sellers is the toolkit digital-service providers use to manage their presence on the UnitySVC platform — from authoring a service on your laptop to operating it live in production. It talks to the seller API so you don't have to: you describe what you offer and how it's sold, and the platform handles enrollment, gateway routing, usage metering, billing, and payouts.

What the package manages

The package is organized around the kinds of data a seller works with. Each kind has its own command group and SDK namespace.

Data type Where it lives What it is Typical actions
specs local repo Your service data as files — explicit spec folders, local-template params, or system-template params under a flat specs/ layout create, validate, format, test, upload
services remote Your live and in-review services on the platform list, show, submit, withdraw, deprecate, set visibility, update (patch routing / price)
groups remote Service groups that bundle related services list, show, delete
promotions remote Price rules that discount your services for customers list, show, activate, pause, delete
secrets remote Named secret values (upstream API keys) referenced by specs and template params list, show, set, delete
templates remote The platform's catalog of service templates you can instantiate list, show

The local specs/ tree is the file-based route to a service on the platform. Author full spec files and specs upload them, or pick a system template, write a small param file under specs/, and upload that. Everything else (services, groups, promotions, secrets, templates) operates on data that already lives on the platform.

→ See Services for what a service spec consists of, the two upload routes, and how a service moves through its status lifecycle.

One package, two front-ends: CLI and SDK

Every data type and action above is available through both front-ends, which talk to the same /v1/seller/* HTTP API — mix and match freely:

  • usvc_seller CLI — a local-first, version-controlled workflow for authoring, validating, uploading, testing, and operating your catalog from the command line. Local commands live under usvc seller specs …; remote commands under usvc seller services | groups | promotions | secrets | templates ….
  • Python SDK — unitysvc_sellers.Client / AsyncClient, a typed HTTP client (the CLI is built on it) for embedding catalog operations in your own scripts, CI/CD jobs, or applications.
# CLI: validate local specs, then upload them
usvc seller specs validate
usvc seller specs upload

# CLI: or create a service from a system-template param file
$EDITOR specs/acme/gpt.json
usvc seller specs upload acme/gpt --submit

# SDK: the same operations, embeddable in your own code
from unitysvc_sellers import Client

with Client() as client:
    services = client.services.list()
    client.instances.create("openai-compatible-llm",
                            parameters={"api_base_url": "https://api.example.com/v1"})

What you can do

Author & publish services

  • Define services as schema-validated specs/ files, version-controlled in git
  • Validate and format locally before anything leaves your machine
  • Run upstream connectivity / code-example tests against your endpoints
  • Upload authored specs, or instantiate a system template with parameters
  • Generate a whole catalog of services from a source list with a populator

Operate live services

  • Move services through review: submit, withdraw, deprecate
  • Control marketplace visibility (public / unlisted)
  • Update a live service's routing variables and list price
  • Run server-side diagnostics and manage which documents are tested

Manage the surrounding catalog

  • Discount services for customers with promotions (price rules)
  • Bundle related services into service groups
  • Store upstream credentials as named secrets, referenced by name (never by value)
  • Browse the system template catalog before writing template params

Automate everything

  • Drive all of the above from the typed Python SDK in scripts and CI/CD

Where to go next

Authentication

Both front-ends authenticate with a seller API key from the UnitySVC dashboard (Settings → API Keys). The seller context is encoded entirely in the key:

export UNITYSVC_SELLER_API_KEY="svcpass_..."
export UNITYSVC_SELLER_API_URL="https://seller.unitysvc.com/v1"

Community & Support

Licensed under the MIT License.