List Generation History
March 2, 2026 (November 16, 2026)
Table of contents
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}
API tokenis required, see Setup useapi.net for details.
Path Parameters
accountis required.
Query Parameters
countis optional. Number of assets to return (1-100, default:20).offsetis optional. Pagination cursor from a previous response’snextOffset.
Responses
-
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]" }assetRefon image assets can be used directly asimageRef_Nin POST /images or asfirstFrameRefin POST /videos.assetIdcan be used with DELETE /assets/assetIdto remove an asset.- Videos do not have
assetRef— only avideoUrlfor download.
-
Invalid API token.
{ "error": "Unauthorized" } -
The account is not configured.
{ "error": "Unable to find configuration for account US:[email protected]. Please add configuration via POST /v1/dreamina/accounts", "code": 400 }
Model
A page of the account’s generated images and videos in assets, each with its assetId, URLs and dimensions, plus hasMore and nextOffset.
The list of generated images and videos, field by field
{
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')}")