List Generation History

March 2, 2026

Table of contents

  1. Request Headers
  2. Path Parameters
  3. Query Parameters
  4. Responses
  5. Model
  6. Examples
  7. Try It

List generation history (images and videos) for a specific account. Returns assets with their URLs, dimensions, and reusable assetRef values for POST /images or as in POST /videos.

https://api.useapi.net/v1/dreamina/assets/account

Request Headers 

Authorization: Bearer {API token}

Path Parameters

  • account is required.

Query Parameters

  • count is optional. Number of assets to return (1-100, default: 20).
  • offset is optional. Pagination cursor from a previous response’s nextOffset.

Responses

  • 200 OK

    Returns generation history with asset details.

    {
  "assets": [
    {
      "assetId": "US:[email protected]:7612453183683579150",
      "historyRecordId": "306191111942",
      "itemId": "7612453183683579150",
      "type": "image",
      "coverUrl": "https://p9-sign.douyinpic.com/...",
      "description": "A stunning aurora borealis over a frozen lake",
      "assetRef": "US:[email protected]:w2560:h1440:s905000-uri:tos-useast5-i-wopfjsm1ax-tx/abc123",
      "imageUrl": "https://p9-sign.douyinpic.com/...",
      "width": 2560,
      "height": 1440,
      "format": "webp",
      "createdAt": "2026-03-02T14:06:06.000Z"
    },
    {
      "assetId": "US:[email protected]:7612453244173880589",
      "historyRecordId": "306191137798",
      "itemId": "7612453244173880589",
      "type": "video",
      "coverUrl": "https://p9-sign.douyinpic.com/...",
      "description": "A cinematic drone shot",
      "videoUrl": "https://v16m-default.akamaized.net/...",
      "width": 1280,
      "height": 720,
      "createdAt": "2026-03-02T14:08:07.000Z"
    }
  ],
  "hasMore": true,
  "nextOffset": 20,
  "account": "US:[email protected]"
}
    • assetRef on image assets can be used directly as imageRef_N in POST /images or as firstFrameRef in POST /videos.
    • assetId can be used with DELETE /assets/assetId to remove an asset.
    • Videos do not have assetRef — only a videoUrl for download.

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "Unauthorized"
}

  • 404 Not Found

    Account not found or not configured.

    {
  "error": "Unable to find configuration for account US:[email protected]"
}

Model 

{
  assets: Array<{
    assetId: string              // ID for DELETE /assets/<assetId>
    historyRecordId: string
    itemId: string
    type: 'image' | 'video'
    coverUrl?: string            // Thumbnail URL
    description?: string         // Generation prompt
    assetRef?: string            // Reusable ref (images only)
    imageUrl?: string            // Full image URL (images only)
    videoUrl?: string            // Video URL (videos only)
    width?: number
    height?: number
    format?: string              // Image format (images only)
    createdAt?: string           // ISO 8601 timestamp
  }>
  hasMore: boolean               // More pages available
  nextOffset: number             // Pass as offset for next page
  account: string
}

Examples 

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/dreamina/assets/US:[email protected]?count=10"

  • const token = 'YOUR_API_TOKEN';
const account = 'US:[email protected]';

const response = await fetch(
  `https://api.useapi.net/v1/dreamina/assets/${encodeURIComponent(account)}?count=20`,
  { headers: { 'Authorization': `Bearer ${token}` } }
);

const result = await response.json();
console.log(`Assets: ${result.assets.length}, hasMore: ${result.hasMore}`);

result.assets.forEach(a => {
  console.log(`  ${a.type} ${a.assetId} ${a.width}x${a.height}`);
  if (a.assetRef) console.log(`    assetRef: ${a.assetRef}`);
});

  • import requests
from urllib.parse import quote

token = 'YOUR_API_TOKEN'
account = 'US:[email protected]'

response = requests.get(
    f'https://api.useapi.net/v1/dreamina/assets/{quote(account, safe="")}',
    headers={'Authorization': f'Bearer {token}'},
    params={'count': 20}
)

result = response.json()
print(f"Assets: {len(result['assets'])}, hasMore: {result['hasMore']}")

for a in result['assets']:
    print(f"  {a['type']} {a['assetId']} {a.get('width')}x{a.get('height')}")

Try It