datasets

Upload assets to a dataset

Upload image assets to a dataset for model training. Accepts individual images (JPEG, PNG, WebP), optional .txt caption sidecar files, and/or ZIP archives containing images and captions. A dataset can contain up to 100 images.

post/datasets/{dataset_id}/upload_assets

Path parameters

dataset_idstring required

Response

Upload summary

total_countinteger required

Total number of images processed.

success_countinteger required

Number of images successfully uploaded.

failure_countinteger required

Number of images that failed to upload.

Example response

{
  "successful_assets": [
    {
      "asset_identifier": "",
      "file_name": "file_name"
    },
    {
      "asset_identifier": "",
      "file_name": "file_name"
    }
  ],
  "total_count": 0,
  "failed_assets": [
    {
      "file_name": "file_name",
      "failure_reason": null
    },
    {
      "file_name": "file_name",
      "failure_reason": null
    }
  ],
  "success_count": 6,
  "failure_count": 1
}

Changes

Changed in 1 of the 34 revisions of this API.31

Sep 2, 20261429d75daa3631See the full diff
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ○
  added to the // response property allOf list for the response status
  response-property-all-of-added

Full history