Configure Dreamina Account

February 23, 2026

Table of contents

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

Configure your Dreamina account for API access using email and password credentials.

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

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data

Request Body

{
  "email": "[email protected]",
  "password": "your-password",
  "region": "US",
  "maxJobs": 10
}
  • email is required. Dreamina account email address.
  • password is required. Dreamina account password.
  • region is required. Region code. Supported value: US.
  • maxJobs is optional. Maximum concurrent jobs for this account (1-50, default: 10).

    Responses

  • 200 OK

    Account configured successfully.

    {
      "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": 500,
        "vip": 200,
        "gift": 200,
        "purchase": 100,
        "dailyClaimed": false
      }
    }
    
  • 400 Bad Request

    Validation error (missing/invalid parameters).

    {
      "error": "Parameter email is required"
    }
    
  • 401 Unauthorized

    Invalid API token.

    {
      "error": "Unauthorized"
    }
    
  • 402 Payment Required

    Subscription expired or insufficient credits.

    {
      "error": "Account has no subscription or subscription expired"
    }
    
  • 500 Internal Server Error

    Login failed (bad credentials, upstream error).

    {
      "error": "Login failed: invalid credentials"
    }
    

Model

  • account - Account identifier in format REGION:email
  • email - Dreamina account email
  • region - Region code
  • maxJobs - Maximum concurrent jobs
  • sessionExpires - ISO 8601 timestamp when session expires
  • session - Session details including refresh timing
  • models - Available video generation models
  • credits - Credit balance breakdown
{ // TypeScript, all fields are optional
  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 "Accept: application/json" \
         -H "Content-Type: application/json" \
         -H "Authorization: Bearer YOUR_API_TOKEN" \
         -X POST "https://api.useapi.net/v1/dreamina/accounts" \
         -d '{
           "email": "[email protected]",
           "password": "your-password",
           "region": "US"
         }'
    
  • const apiUrl = 'https://api.useapi.net/v1/dreamina/accounts';
    const token = 'YOUR_API_TOKEN';
    
    const response = await fetch(apiUrl, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        email: '[email protected]',
        password: 'your-password',
        region: 'US'
      })
    });
    
    const result = await response.json();
    console.log('Account configured:', result);
    
  • import requests
    
    apiUrl = 'https://api.useapi.net/v1/dreamina/accounts'
    token = 'YOUR_API_TOKEN'
    
    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {token}'
    }
    
    body = {
        'email': '[email protected]',
        'password': 'your-password',
        'region': 'US'
    }
    
    response = requests.post(apiUrl, headers=headers, json=body)
    print(response.status_code, response.json())
    

Try It