Get Account Configuration

February 23, 2026 (November 12, 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.5-draft", "seedance-2.5", "seedance-2.0-mini", "seedance-2.0-fast", "seedance-2.0", "seedance-1.5-pro", "seedance-1.0-mini"],
    "image": ["seedream-5.0-flash", "seedream-4.6", "seedream-4.5", "seedream-4.1", "seedream-4.0", "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.

    An account in its sign-out pause also carries signedOutPauseUntil. When Dreamina signs an account out again right after a fresh sign-in, the account is paused for 30 minutes. While the pause runs, GET /accounts shows signedOutPauseUntil (an ISO 8601 time) on that account, requests that name it answer 596, and automatic account selection uses your other accounts. When every account is paused, requests answer 596. After the pause the account is used again. If Dreamina signs it out right after a fresh sign-in again, after the pause and within 24 hours, the account is marked with an error and answers 596 until you re-add it with POST /accounts. Re-adding an account also ends its pause.

    A sign-in that fails for a temporary reason, not because Dreamina refused the account, answers 503 with a Retry-After: 30 header. The account is fine: retry in about 30 seconds.

  • 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; the account answers 596 until re-added
  signedOutPauseUntil?: string   // ISO 8601 timestamp, only while the account's sign-out pause runs
}

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