Configure Captcha Providers

December 23, 2025

Table of contents

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

Configure captcha provider API keys for image and video generation. Google Flow requires reCAPTCHA v3 Enterprise tokens for API calls - these third-party services solve the captcha automatically.

Supported Providers:

Provider Cost Website
EzCaptcha (Recommended) ~$2.50 per 1,000 solves ez-captcha.com
CapSolver ~$3.00 per 1,000 solves capsolver.com
YesCaptcha varies yescaptcha.com

You can configure multiple providers for redundancy. When generating images/videos, the API will automatically retry with different providers if one fails or returns a rejected token.

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

Request Headers 

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

Request Body 

{
  "EzCaptcha": "<your EzCaptcha API key>",
  "CapSolver": "<your CapSolver API key>",
  "YesCaptcha": "<your YesCaptcha API key>"
}

Notes:

  • All fields are optional - only include providers you want to configure
  • Set a field to empty string "" to remove that provider
  • At least one provider must be configured to use POST /images or POST /videos

Responses

  • 200 OK

    Captcha providers configured successfully. Returns masked keys for all configured providers.

    {
  "EzCaptcha": "abc...***...xyz",
  "CapSolver": "def...***...uvw"
}

  • 400 Bad Request

    Invalid provider name specified.

    {
  "error": "Invalid captcha provider(s): InvalidProvider. Valid providers: EzCaptcha, CapSolver, YesCaptcha"
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "Unauthorized"
}

Model 

{ // TypeScript, all fields are optional
  EzCaptcha?: string   // Masked API key or omitted if not configured
  CapSolver?: string   // Masked API key or omitted if not configured
  YesCaptcha?: string  // Masked API key or omitted if not configured
}

Examples 

  • curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -X POST "https://api.useapi.net/v1/google-flow/accounts/captcha-providers" \
     -d '{
       "EzCaptcha": "<your EzCaptcha API key>",
       "CapSolver": "<your CapSolver API key>"
     }'

  • const apiUrl = 'https://api.useapi.net/v1/google-flow/accounts/captcha-providers';
const token = 'YOUR_API_TOKEN';

const response = await fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    EzCaptcha: '<your EzCaptcha API key>',
    CapSolver: '<your CapSolver API key>'
  })
});

const result = await response.json();
console.log('Captcha providers configured:', result);

  • import requests

apiUrl = 'https://api.useapi.net/v1/google-flow/accounts/captcha-providers'
token = 'YOUR_API_TOKEN'

headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {token}'
}

body = {
    'EzCaptcha': '<your EzCaptcha API key>',
    'CapSolver': '<your CapSolver API key>'
}

response = requests.post(apiUrl, headers=headers, json=body)
print(response.status_code, response.json())

Try It