Get Account Configuration

February 23, 2026

Table of contents

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

Get configuration details for a specific Dreamina account, including session status, available models, and credit balance. Can also be called once a day to claim free daily credits.

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

Request Headers

Authorization: Bearer {API token}

Path Parameters

  • account is required. The account identifier in REGION:email format. Example: US:[email protected].

Responses

  • 200 OK

    Account details retrieved with live data from upstream.

    {
      "account": "US:[email protected]",
      "email": "[email protected]",
      "region": "US",
      "maxJobs": 10,
      "sessionExpires": "2026-04-24T12:00:00.000Z",
      "session": {
        "expires": "2026-04-24T12:00:00.000Z",
        "lastRefreshed": "2026-02-23T12:00:00.000Z",
        "daysUntilExpiry": 60
      },
      "models": {
        "video": ["seedance-2.0", "dreamina-3.5-pro", "dreamina-3.0"]
      },
      "credits": {
        "total": 24065,
        "vip": 12000,
        "gift": 10065,
        "purchase": 2000,
        "dailyClaimed": true
      }
    }
    

    Note: The models, credits, and session fields are fetched live from upstream. If upstream queries fail, a summary without these fields is returned.

  • 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

{
  account: string                // "US:[email protected]"
  email: string
  region: string                 // "US"
  maxJobs: number                // 1-50
  sessionExpires: string         // ISO 8601 timestamp
  session?: {
    expires: string              // ISO 8601 timestamp
    lastRefreshed: string        // ISO 8601 timestamp
    daysUntilExpiry: number
  }
  models?: {
    video: string[]              // Available model names
  }
  credits?: {
    total: number
    vip: number
    gift: number
    purchase: number
    dailyClaimed: boolean
  }
  error?: string                 // Error message
}

Examples

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         "https://api.useapi.net/v1/dreamina/accounts/US:[email protected]"
    
  • const token = 'YOUR_API_TOKEN';
    const account = 'US:[email protected]';
    
    const response = await fetch(
      `https://api.useapi.net/v1/dreamina/accounts/${encodeURIComponent(account)}`,
      {
        headers: {
          'Authorization': `Bearer ${token}`
        }
      }
    );
    
    const accountConfig = await response.json();
    console.log('Account:', accountConfig);
    console.log('Credits:', accountConfig.credits);
    console.log('Models:', accountConfig.models);
    
  • import requests
    from urllib.parse import quote
    
    token = 'YOUR_API_TOKEN'
    account = 'US:[email protected]'
    
    headers = {'Authorization': f'Bearer {token}'}
    
    response = requests.get(
        f'https://api.useapi.net/v1/dreamina/accounts/{quote(account, safe="")}',
        headers=headers
    )
    
    account_config = response.json()
    print('Account:', account_config)
    print('Credits:', account_config.get('credits'))
    print('Models:', account_config.get('models'))
    

Try It