Get Account Configuration

February 23, 2026 (March 2, 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.

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", "seedance-1.5-pro", "seedance-1.0-mini"],
        "image": ["seedream-4.5", "seedream-4.1", "seedream-4.0", "nano-banana", "seedream-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 video model names
    image: string[]              // Available image 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