Is there a Sume Python SDK? No: use requests and the OpenAPI schema

Sume documents a TypeScript SDK, @sume-com/sdk, and no Python package. From Python, call the REST API with requests, or generate a client from the OpenAPI JSON.

5 min readSume
All posts

No. Sume's docs describe one SDK, the TypeScript package @sume-com/sdk, and no Python package. From Python you call the REST API at https://api.sume.com/v1 with any HTTP client, or you generate a typed client from the live OpenAPI schema at https://api.sume.com/reference/json.

What the docs say

The Developer API overview says the SDK works from Node, Bun, Deno or Workers, and that it is a convenience layer, not a second contract: the API reference stays the source of truth for fields.

Python options (read 2026-10-06)
OptionGood forCost
requests or httpx by handA few endpoints, full controlYou write retry and polling
Client generated from the OpenAPI JSONTyped models for many endpointsRegenerate when the schema changes
Call a TypeScript service that uses the SDKReusing waitForJob and verifyWebhookOne more service to run

A first call and a status read

Authenticate with Authorization: Bearer (the API also accepts x-api-key). This session reads /v1/me to prove the key works, then wraps the status endpoint. The status payload sits under data.

import os, requests

s = requests.Session()
s.headers["Authorization"] = f"Bearer {os.environ['SUME_API_KEY']}"

me = s.get("https://api.sume.com/v1/me", timeout=30)
me.raise_for_status()
print(me.json())

def status(job_id: str) -> dict:
    r = s.get(f"https://api.sume.com/v1/jobs/{job_id}/status", timeout=30)
    r.raise_for_status()
    return r.json()["data"]

Write what the SDK would have written

  • Poll GET /v1/jobs/:id/status and stop when terminal is true.
  • Send an Idempotency-Key on every paid submit you might retry.
  • Verify webhooks on the raw body with x-sume-webhook-signature.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume