v0.1.73 - Update Platform API contract (#91)
馃専 Summary
v0.1.73 updates the Ultralytics Platform API and Python SDK with dataset-version comparison and more flexible exports, plus clearer CLI connection and authentication errors.
馃搳 Key Changes
- 馃攳 Compare dataset versions: Added a dataset comparison endpoint and typed synchronous and asynchronous
datasets.compare()methods. Responses can summarize added, removed, modified, or moved images, show label and dataset-header changes, and provide paginated results. A specific image can also be inspected across versions. - 馃摝 Choose whether to prepare an export download: Dataset export creation now accepts an optional
downloadsetting. When downloads aren鈥檛 requested, the response may omitdownloadUrl. - 馃攧 Expose restore progress context: Dataset response types now include
restoreVersion, identifying the version an in-progress or interrupted restore applies. - 馃Л Make CLI errors more actionable: A 401 response now includes guidance for creating and configuring an API key. Connection failures show the Platform URL and underlying error reason.
- 鈿欙笍 Keep the SDK aligned with the API: The OpenAPI contract and regenerated Python SDK are versioned at 0.1.73, with CI validating the generated package.
馃幆 Purpose & Impact
- Dataset comparisons make it easier to review what changed between saved versions and inspect how an individual image or its labels differ.
- Optional export downloads let users save a dataset version without also preparing a download, while keeping existing download behavior available by default.
- Clearer CLI messages help users diagnose invalid credentials and network or configuration problems more quickly.
- These are Platform API, SDK, and CLI improvements; the release does not introduce a model change.
What's Changed
- Add actionable 401 and connection error hints to the ul CLI by @JaviChulvi in #89
- Update Platform API contract by @UltralyticsAssistant in #91
Full Changelog: v0.1.72...v0.1.73