Account Warmup Script Configuration

This page documents the configuration parameters for the account_warmup script used in task creation.

Overview

The account_warmup script is used to warm up TikTok or Instagram accounts by simulating natural user behavior. It watches videos, randomly likes, follows, collects, and comments based on configured probabilities. This helps new accounts build engagement history and avoid bot detection.

Script Configuration (`script_config`)

The script_config object contains the parameters for the account warmup script. Below are the available parameters:

Parameters

Parameter	Type	Required	Default	Description
task_duration	number	No	600	Total duration of warmup task in seconds
browse_mode	string	No	"for_you"	Where to browse videos: `for_you` (For You on TikTok / Reels on Instagram), `following` (Following feed — on TikTok switches to the Following tab; on Instagram opens the Reels title dropdown and selects "Following"), or `search` (search by topic keyword)
topic	string	No	""	Search topic keywords (one per line, randomly selected). Only used when `browse_mode` is `"search"`
min_duration	number	No	15	Minimum video watch duration in seconds
max_duration	number	No	30	Maximum video watch duration in seconds
like_probable	number	No	0	Probability (0-100) of liking a video
floow_probable	number	No	0	Probability (0-100) of following the video creator. Note: also accepted as `follow_probable` — both spellings are supported for backward compatibility
collect_probable	number	No	0	Probability (0-100) of collecting/bookmarking a video
comment_probable	number	No	0	Probability (0-100) of commenting on a video
comment_mode	string	No	"post_comment"	Where to leave comments during warmup: `post_comment` (on the video post) or `reply_comment` (reply to an existing comment)
comment	string	No	""	Comment templates (one per line, randomly selected)
insert_emoji	boolean	No	false	Whether to insert random emoji in comments
comment_order	string	No	"random"	Comment selection order: `random` or `sequential`
generate_by_chatgpt	boolean	No	false	Whether to generate comments using ChatGPT
chatgpt_settings	object	No		ChatGPT configuration settings (see below)

ChatGPT Settings Structure

When generate_by_chatgpt is set to true, you can configure ChatGPT comment generation with the chatgpt_settings object:

Parameter	Type	Required	Description
api_key	string	Yes	Your OpenAI API key
model	string	No	The model to use (default: "gpt-3.5-turbo"). Options: "gpt-3.5-turbo", "gpt-4", "gpt-4-turbo"
prompt	string	No	Custom prompt for generating comments. Default generates friendly, relevant comments
max_tokens	number	No	Maximum tokens for the response (default: 100)
temperature	number	No	Creativity level 0-2 (default: 0.7). Higher values = more creative
base_url	string	No	Custom API endpoint URL (for Azure OpenAI or compatible APIs)

Example chatgpt_settings object:

{
  "api_key": "sk-your-openai-api-key",
  "model": "gpt-3.5-turbo",
  "prompt": "Generate a short, friendly comment about this video in English",
  "max_tokens": 50,
  "temperature": 0.8,
  "base_url": "https://api.openai.com/v1"
}

Recommendation

For new accounts, start with low interaction probabilities (5-15%) and gradually increase them over time. This mimics natural user behavior.

Examples

Basic Account Warmup

Simple warmup with video watching only:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 600,
      "min_duration": 10,
      "max_duration": 30
    }
  }'

Warmup with Topic Search

Warm up account by searching specific topics:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 900,
      "browse_mode": "search",
      "topic": "funny cats\ndog videos\npet compilation",
      "min_duration": 15,
      "max_duration": 45
    }
  }'

Warmup — Following Feed

Warm up an account by browsing the Following feed (works on both TikTok and Instagram):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 600,
      "browse_mode": "following",
      "min_duration": 15,
      "max_duration": 30,
      "like_probable": 20
    }
  }'

Warmup with Interactions

Full warmup with likes, follows, and comments:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 1200,
      "browse_mode": "search",
      "topic": "cooking\nrecipes\nfood",
      "min_duration": 20,
      "max_duration": 60,
      "like_probable": 30,
      "floow_probable": 10,
      "collect_probable": 5,
      "comment_probable": 15,
      "comment": "This is amazing! 🔥\nLove this content!\nSo good! 👏\nWow, incredible!",
      "insert_emoji": true,
      "comment_order": "random"
    }
  }'

Warmup with ChatGPT Comments

Generate intelligent comments using ChatGPT:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 1800,
      "topic": "tech reviews\ngadgets",
      "min_duration": 30,
      "max_duration": 90,
      "like_probable": 25,
      "comment_probable": 20,
      "generate_by_chatgpt": true,
      "chatgpt_settings": {
        "api_key": "your-api-key",
        "model": "gpt-3.5-turbo",
        "prompt": "Generate a short, friendly comment about this video"
      }
    }
  }'

Batch Warmup on Multiple Devices

Run warmup on multiple devices simultaneously:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 600,
      "min_duration": 15,
      "max_duration": 30,
      "like_probable": 20
    },
    "enable_multi_account": true
  }'

Schedule Warmup Task

Schedule warmup to run at a specific time:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 1200,
      "topic": "music\ndance\ntrending",
      "min_duration": 20,
      "max_duration": 40,
      "like_probable": 15,
      "floow_probable": 5
    },
    "start_time": "09:00"
  }'

Warmup by Username List

Create warmup tasks for specific accounts:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "account_warmup",
    "script_config": {
      "task_duration": 600,
      "min_duration": 15,
      "max_duration": 30,
      "like_probable": 20,
      "floow_probable": 5
    }
  }'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301, 302, 303],
    "created_count": 3
  }
}

Best Practices

Start with low probabilities: For new accounts, use low interaction probabilities (5-15%) and increase gradually over days/weeks.
Choose the right browse mode: Use for_you for brand-new accounts with no followers yet. Switch to following once the account is established (works on both TikTok and Instagram). Use search to target niche topics relevant to your account.
Use relevant topics: When using search mode, choose topics that align with your account niche to build a relevant engagement history.
Vary watch duration: Set a range between min_duration and max_duration to simulate natural viewing patterns.
Moderate task duration: Run warmup sessions of 10-30 minutes, 2-3 times daily, rather than continuous long sessions.
Use diverse comments: Provide multiple comment templates to avoid repetitive patterns that may trigger spam detection.
Schedule wisely: Use start_time to run warmup tasks during active hours in your target audience's timezone.

Overview​

Script Configuration (script_config)​

Parameters​

ChatGPT Settings Structure​

Examples​

Basic Account Warmup​

Warmup with Topic Search​

Warmup — Following Feed​

Warmup with Interactions​

Warmup with ChatGPT Comments​

Batch Warmup on Multiple Devices​

Schedule Warmup Task​

Warmup by Username List​

Response​

Best Practices​

See Also​