Get Account Configuration

November 17, 2025 (November 16, 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 Google Flow account, including health status, credits information, and available video models.

https://api.useapi.net/v1/google-flow/accounts/email

Request Headers

Authorization: Bearer {API token}

Path Parameters

  • email is required. The email address of the Google Flow account to query (URL-encoded if necessary).

Responses

  • 200 OK

    Account configuration found and returned with health status.

    {
      "accountCookies": [
        {
          "name": "HSID",
          "value": "AYQab…redacted…xY12z",
          "domain": ".google.com",
          "path": "/",
          "expires": "2027-11-26T16:03:52.000Z",
          "httpOnly": true,
          "secure": false,
          "sameSite": "Lax"
        }
      ],
      "flowCookies": [
        {
          "name": "OSID",
          "value": "g.a00…redacted…Hj076",
          "domain": "flow.google.com",
          "path": "/",
          "expires": "2027-11-26T16:04:09.000Z",
          "httpOnly": false,
          "secure": true,
          "sameSite": "Lax"
        }
      ],
      "created": "2025-11-10T12:00:00.000Z",
      "updated": "2026-10-22T16:04:11.512Z",
      "project": {
        "projectId": "3b1c0e9d-7a6f-4592-8d38-7f9e1b4c6a5d",
        "projectTitle": "Nov 11 - 02:56"
      },
      "nextRefresh": {
        "messageId": "msg_2…redacted…Fq9Wd",
        "scheduledFor": "2026-10-24T16:11:37.000Z"
      },
      "backend": "flow",
      "health": "OK",
      "credits": {
        "credits": 1250,
        "userPaygateTier": "PAYGATE_TIER_TWO",
        "sku": "G1_TIER2",
        "serviceTier": "SERVICE_TIER_ADVANCED",
        "topUpCredits": 250,
        "subscriptionCredits": 1000
      },
      "models": {
        "videoModels": [
          {
            "key": "veo_3_1_t2v",
            "displayName": "Veo 3.1 - Quality",
            "supportedAspectRatios": ["VIDEO_ASPECT_RATIO_LANDSCAPE"],
            "capabilities": ["VIDEO_MODEL_CAPABILITY_AUDIO", "VIDEO_MODEL_CAPABILITY_TEXT"],
            "videoLengthSeconds": 8,
            "videoGenerationTimeSeconds": 240,
            "creditCost": 100,
            "framesPerSecond": 24,
            "paygateTier": "PAYGATE_TIER_TWO",
            "accessType": "MODEL_ACCESS_TYPE_GENERAL",
            "resolution": "720p",
            "modelAccessInfo": {},
            "modelMetadata": {
              "veoModelName": "Beta Audio"
            }
          },
          {
            "key": "veo_3_1_t2v_lite_low_priority",
            "displayName": "Veo 3.1 - Lite [Lower Priority]",
            "supportedAspectRatios": ["VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT"],
            "capabilities": ["VIDEO_MODEL_CAPABILITY_AUDIO", "VIDEO_MODEL_CAPABILITY_TEXT"],
            "videoLengthSeconds": 8,
            "videoGenerationTimeSeconds": 110,
            "creditCost": 0,
            "framesPerSecond": 24,
            "paygateTier": "PAYGATE_TIER_TWO",
            "accessType": "MODEL_ACCESS_TYPE_GENERAL",
            "resolution": "720p",
            "modelAccessInfo": {},
            "modelMetadata": {
              "veoModelName": "Beta Audio"
            }
          }
        ]
      }
    }
    

    Note: Secret values come back masked: every cookie value, sessionData.access_token and nextRefresh.messageId show their first and last five characters around …redacted… (a value of ten characters or fewer shows as …redacted… alone). accountCookies lists every Google account cookie the account was added with (HSID, LSID, SID, SSID, APISID, SAPISID), shortened here to one, and flowCookies holds the flow.google.com sign-in cookie (OSID), which the API replaces every 2 to 3 days.

    The credits and models fields are only included when health is "OK".

    Captcha provider recommendations. When fewer than two captcha providers are configured on the account, the response also includes a top-level recommendations array. Single-provider users have no failover when Google’s reCAPTCHA Enterprise scores a token low — adding a second provider lets the worker rotate on failure. A second provider does not help when Google distrusts the account itself — see When Google rejects captchas. Example:

    {
      "health": "OK",
      "credits": {...},
      "models": {...},
      "recommendations": [
        "Only one captcha provider configured. Adding a second provider gives the worker a fallback when Google scores a token low — significantly reduces 429 TOO_MUCH_TRAFFIC and 403 captcha errors. Configure via POST /accounts/captcha-providers."
      ]
    }
    

    The field is omitted when you already have two or more providers configured. Configure additional providers via POST /accounts/captcha-providers.

    Omni 1.1 Flash models are listed for Plus, Pro and Ultra accounts alongside the Veo ones. Google labels this family “Omni 1.1 Flash” in the Flow interface, and displayName carries that label verbatim, so it tracks Google’s version renames — the POST /videos model value stays omni-flash regardless. Every Omni key appears twice, once per resolution: the _360p variant costs about half its 720p twin.

    Omni 1.2 Flash (omni-flash-1.2, displayName “Omni 1.2 Flash”, keys macaron_cookie_*) is listed for every plan: each length from 3 to 15 seconds (3 to 10 with a start and an end frame), the edit, and the extend lengths from 3 to 10 seconds, each at 720p and 360p, with the creditCost of a clip of that length. A free account lists lengths up to 10 seconds and no extend. Google is giving the model to accounts over several days from November 5, 2026, and the list shows the Omni 1.2 Flash models only once the account has them.

    Free models on Ultra: For accounts with Google AI Ultra subscription (PAYGATE_TIER_TWO), video models with creditCost: 0 are free to generate. These are the lower-priority variants — keys ending in _low_priority (e.g. veo_3_1_t2v_lite_low_priority). Keys ending in _ultra are discounted but not free — they typically cost 10 credits per generation.

    For an Ultra $199 account on flow.google.com, this list is checked against the account’s own model list. Since 2026-09-23 Google no longer offers the _low_priority keys to invited members of a family plan — only the family manager’s account keeps them — so a member account is listed without them. An account whose model list could not be read gets the plan’s full list.

  • 401 Unauthorized

    Invalid API token.

    {
      "error": "useapi.net ⁝ Unauthorized",
      "code": 401
    }
    
  • 404 Not Found

    Account not found or not configured.

    {
      "error": "Google Flow account email@example.com not found",
      "code": 404
    }
    

Model

The account as stored, with its masked cookies, projects, health, credits, models and next automatic refresh.

The account, field by field
  • backend - flow when the account runs on the flow.google.com cookies. labs marks an account added before 2026-09-12 without the APISID and SAPISID cookies, which stopped working on 2026-10-21. Every request for it answers 596: add it again with the automated setup
  • health - OK when the account is ready, otherwise the reason it is not and what to do
  • projectEntity and projectAgent - The projects that hold the account’s characters and voices, and its agent chats. Each appears once the account first uses it
  • recommendations - Captcha setup advice, see the note in the 200 tab

An account first added before 2026-10-21 can also show sessionCookies and sessionData left from the old Google Labs sign-in. The API no longer uses them.

{
  backend: 'flow' | 'labs'     // flow: the account signs in with its `flow.google.com` cookies. labs: an account added
                               // before 2026-09-12 that stopped working on 2026-10-21, add it again
  created: string              // ISO 8601 timestamp, first add
  updated?: string             // ISO 8601 timestamp, most recent add, absent on an account last added before 2026-09-16
  accountCookies: Array<{      // the Google sign-in cookies kept for the account: HSID, LSID, SID, SSID, APISID and SAPISID
    name: string               // cookie name
    value: string              // Masked
    domain: string             // cookie domain
    path: string               // cookie path
    expires: string | number   // ISO 8601 timestamp, Unix seconds, or -1 for a session cookie
    httpOnly: boolean          // the cookie's HttpOnly flag
    secure: boolean            // the cookie's Secure flag
    sameSite: 'Lax' | 'Strict' | 'None'  // the cookie's SameSite setting
  }>
  flowCookies?: Array<{        // Same structure, one OSID cookie for flow.google.com, absent on a 'labs' account
    name: string               // cookie name
    value: string              // Masked
    domain: string             // cookie domain
    path: string               // cookie path
    expires: string | number   // ISO 8601 timestamp, Unix seconds, or -1 for a session cookie
    httpOnly: boolean          // the cookie's HttpOnly flag
    secure: boolean            // the cookie's Secure flag
    sameSite: 'Lax' | 'Strict' | 'None'  // the cookie's SameSite setting
  }>
  sessionCookies?: Array<{     // Same structure, the cookies of the old Google Labs sign-in, on an account first added before 2026-10-21, no longer used
    name: string               // cookie name
    value: string              // Masked
    domain: string             // cookie domain
    path: string               // cookie path
    expires: string | number   // ISO 8601 timestamp, Unix seconds, or -1 for a session cookie
    httpOnly: boolean          // the cookie's HttpOnly flag
    secure: boolean            // the cookie's Secure flag
    sameSite: 'Lax' | 'Strict' | 'None'  // the cookie's SameSite setting
  }>
  sessionData?: {              // the old Google Labs sign-in, on an account first added before 2026-10-21, no longer used
    user: {                    // the Google account of that sign-in
      name: string             // its display name
      email: string            // its email
      image: string            // its profile picture URL
    }
    expires: string            // ISO 8601 timestamp, when that sign-in expired
    access_token: string       // Masked
  }
  project: {                   // the account's Google Flow project, where generations go
    projectId: string          // Google Flow project id
    projectTitle: string       // project title, set when the project was created
  }
  projectEntity?: {            // the project that holds the account's characters and custom voices, created by the first POST /characters or POST /voices
    projectId: string          // Google Flow project id
    projectTitle: string       // project title, set when the project was created
  }
  projectAgent?: {             // the account's agent project, where agent chats run, created by the first POST /agent/chats
    projectId: string          // Google Flow project id
    projectTitle: string       // project title, set when the project was created
  }
  nextRefresh?: {              // the next automatic session refresh, absent once a refresh stopped on an error
    messageId: string          // Masked
    scheduledFor: string       // ISO 8601 timestamp, every 2 to 3 days
  }
  setupSession?: string        // the automated setup session that last added the account, present only when it was added that way
  health: string               // "OK", otherwise the reason the account does not work and what to do
  error?: string               // the error that stopped the account, the same text as health
  credits?: {                  // Only present when health is "OK"
    credits: number            // Google Flow AI credits left on the account
    userPaygateTier: string    // the account's Google plan: PAYGATE_TIER_NOT_PAID (Free), PAYGATE_TIER_ZERO (Plus), PAYGATE_TIER_ONE (Pro), PAYGATE_TIER_TIER1P5 (Ultra $99), PAYGATE_TIER_TWO (Ultra $199), or PAYGATE_TIER_UNKNOWN_<n> for a plan Google added that this API has not named yet
    sku: string                // Google's plan code: G1_FREEMIUM, G1_TIER0, G1_TIER1, G1_TIER1P5, G1_TIER2 or SKU_UNKNOWN_<n>
    serviceTier?: string       // SERVICE_TIER_ENTRY, SERVICE_TIER_INTERMEDIATE, SERVICE_TIER_ADVANCED or SERVICE_TIER_UNKNOWN_<n>
    topUpCredits?: number      // the part of credits bought as top-ups, when Google reports it
    subscriptionCredits?: number  // the part of credits that comes with the plan, when Google reports it
  }
  models?: {                   // Only present when health is "OK"
    videoModels: Array<{       // video models the account's Google plan can use, one per model key
      key: string              // Google's own key for the model
      displayName: string      // the model's name in the Google Flow web app: Veo 3.1 - Fast, Veo 3.1 - Quality, Veo 3.1 - Lite, Veo 3.1 - Lite [Lower Priority], Omni 1.1 Flash, Omni 1.2 Flash, Omni - Upsampler 360p, Veo 3.1 - Upsampler 1080P or Veo 3.1 - Upsampler 4K
      supportedAspectRatios: string[]  // VIDEO_ASPECT_RATIO_LANDSCAPE and/or VIDEO_ASPECT_RATIO_PORTRAIT
      capabilities: string[]   // e.g., ["VIDEO_MODEL_CAPABILITY_TEXT", "VIDEO_MODEL_CAPABILITY_AUDIO"]
      videoLengthSeconds: number  // video length in seconds
      videoGenerationTimeSeconds: number  // Google's estimate of the generation time in seconds
      creditCost: number       // Credits charged per generation. 0 for the Ultra `_low_priority` keys and for the 720p and 1080p upsamplers on paid plans
      framesPerSecond: number  // always 24
      resolution: string       // 360p or 720p, the generation output resolution. On an upsampler key it is the input resolution that key accepts
      paygateTier: string      // the lowest plan that sees this model: PAYGATE_TIER_NOT_PAID, PAYGATE_TIER_ZERO, PAYGATE_TIER_ONE or PAYGATE_TIER_TWO
      accessType: string       // always "MODEL_ACCESS_TYPE_GENERAL"
      modelAccessInfo: object  // always {}
      modelMetadata: object    // { veoModelName: "Beta Audio" } on Veo models, {} on the others
    }>
  }
  recommendations?: string[]   // captcha setup advice, only when fewer than two captcha providers are configured
}

Examples

  • curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         "https://api.useapi.net/v1/google-flow/accounts/john%40gmail.com"
    
  • import requests
    from urllib.parse import quote
    
    token = 'YOUR_API_TOKEN'
    email = 'john@gmail.com'
    
    headers = {'Authorization': f'Bearer {token}'}
    
    response = requests.get(
        f'https://api.useapi.net/v1/google-flow/accounts/{quote(email)}',
        headers=headers
    )
    
    account_config = response.json()
    print('Account config:', account_config)
    print('Health:', account_config.get('health'))
    print('Credits:', account_config.get('credits'))
    
  • const token = 'YOUR_API_TOKEN';
    const email = 'john@gmail.com';
    
    const response = await fetch(
      `https://api.useapi.net/v1/google-flow/accounts/${encodeURIComponent(email)}`,
      {
        headers: {
          'Authorization': `Bearer ${token}`
        }
      }
    );
    
    const accountConfig = await response.json();
    console.log('Account config:', accountConfig);
    console.log('Health:', accountConfig.health);
    console.log('Credits:', accountConfig.credits);
    

Try It