$ show volcengine/volc-sdk-python
volc-sdk-python is the official Volcengine SDK for Python, a programmatic client library for Volcengine cloud services. It is not a standalone application: it exposes service classes that wrap REST APIs and protobuf-defined services. The dominant architecture is a base Service class that handles credential resolution (AK/SK, environment variables, ~/.volc/config), request signing, and HTTP dispatch, while each service defines an api_info mapping from action names to HTTP method/path/query. Some services (TLS, Live) use protobuf-generated models; others use legacy ApiInfo-style raw dicts, creating inconsistent implementation styles across the SDK.
The LLM identified 4 files worth highlighting for reuse:
Core Service base class that centralizes AK/SK credential management, endpoint/action routing via ApiInfo dictionaries, request signing, and response handling. This is the foundation every service client extends; the declarative action-to-HTTP mapping pattern is reusable for building any REST API client with minimal per-service code.
Implements Volcengine request signing for API requests. This is a self-contained security primitive that can be reused in any Python HTTP client needing cloud-style signed requests, and it isolates signature logic from service-specific code.
Implements the apply -> upload parts -> commit multipart upload workflow for image assets. Demonstrates a reusable stateful upload pattern common to object-storage and media services, with part management and finalization logic that can be adapted to other upload APIs.
Full-featured log service client with protobuf-generated request/response models and CRUD operations for projects, topics, alarms, shippers, and ETL tasks. Shows how to wrap protobuf definitions in a typed, user-friendly Python API; the service boundary is clean enough to serve as a template for protobuf-based cloud SDK services.