Upload assets to a dataset | Ideogram

curl -X POST https://api.ideogram.ai/datasets/dataset_id/upload_assets \
     -H "Api-Key: <apiKey>" \
     -H "Content-Type: multipart/form-data" \
     -F "files[]"=@string

{
  "total_count": 0,
  "success_count": 6,
  "failure_count": 1,
  "successful_assets": [
    {
      "asset_identifier": {
        "asset_type": "RESPONSE",
        "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
      },
      "file_name": "file_name"
    },
    {
      "asset_identifier": {
        "asset_type": "RESPONSE",
        "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
      },
      "file_name": "file_name"
    }
  ],
  "failed_assets": [
    {
      "failure_reason": "FAILED_SAFETY_CHECK",
      "file_name": "file_name"
    },
    {
      "failure_reason": "FAILED_SAFETY_CHECK",
      "file_name": "file_name"
    }
  ]
}

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.

Authentication

Api-Keystring

API key for access control. Use in the header with the name “Api-Key”

Path parameters

dataset_idstringRequired

Request

This endpoint expects a multipart form with multiple files.

filesfilesRequired

Image files (JPEG, PNG, WebP), .txt caption sidecar files, and/or ZIP archives containing images and captions. Caption .txt files are matched to images by filename stem (e.g. sunset.txt provides the caption for sunset.jpg). Captions are optional!

Response

Upload summary

total_countinteger

Total number of images processed.

success_countinteger

Number of images successfully uploaded.

failure_countinteger

Number of images that failed to upload.

successful_assetslist of objects

Details of successfully uploaded assets.

failed_assetslist of objects

Details of assets that failed to upload.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error