본문으로 건너뛰기

댓글 스크립트 설정

이 페이지는 작업 생성을 위한 comment 스크립트의 설정 매개변수를 소개합니다.

개요​

comment 스크립트는 TikTok 또는 Instagram 게시물에 자동으로 댓글을 작성하는 데 사용됩니다. API를 통해 여러 대상 게시물 URL을 제공할 때, 각 대상 게시물 URL에 대해 하나의 작업이 생성됩니다. start_time 매개변수를 사용하여 각 작업의 실행 시간을 제어할 수 있습니다.

스크립트 설정 (script_config)​

script_config 객체는 댓글 스크립트의 매개변수를 포함합니다. 다음은 사용 가능한 매개변수입니다:

매개변수​

매개변수유형필수기본값설명
target_post_urlsstring[]예*[]댓글을 작성할 대상 게시물 URL 배열(각 URL당 하나의 작업)
target_post_urlstring예*""단일 대상 게시물 URL 또는 줄바꿈/쉼표로 구분된 여러 URL
comment_contentstring예""댓글 텍스트 내용. 줄바꿈으로 구분된 여러 댓글을 포함할 수 있습니다
comment_orderstring아니요"random"댓글을 선택하는 방법: random(무작위) 또는 sequential(순차)
insert_emojiboolean아니요false댓글에 무작위 이모지를 삽입할지 여부
comment_image_pathstring아니요""이미지 댓글의 이미지 파일 경로(TikTok만 해당). 절대 경로 또는 work_dir/upload/에 상대적인 경로를 지원합니다
노트

target_post_urls 배열 또는 target_post_url 문자열을 제공해야 합니다. 둘 다 제공되면 target_post_urls가 우선됩니다.

이미지 댓글(TikTok만 해당)

comment_image_path 매개변수를 사용하면 댓글에 이미지를 첨부할 수 있습니다. 이 기능은 TikTok에서만 지원됩니다 - Instagram 댓글은 이미지 첨부를 지원하지 않습니다. 이미지는 기기로 푸시되고 갤러리의 첫 번째 이미지로 선택됩니다.

작업 생성

여러 대상 게시물 URL을 제공할 때, API는 각 대상 게시물 URL에 대해 하나의 작업을 생성합니다. 예를 들어 3개의 게시물 URL과 2개의 기기를 지정하면 6개의 작업이 생성됩니다. start_time 매개변수를 사용하여 작업이 실행을 시작하는 시간을 제어합니다.

예제​

단일 게시물에 댓글 작성​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "멋진 콘텐츠! 🔥"
    }
  }'

여러 댓글 옵션 사용​

줄바꿈으로 구분된 여러 댓글을 제공합니다. 시스템은 comment_order에 따라 그 중 하나를 선택합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "멋진 영상이에요!\n이 콘텐츠 좋아요!\n계속 힘내세요! 👏\n정말 좋네요!",
      "comment_order": "random"
    }
  }'

여러 게시물에 댓글 작성​

여러 게시물에 댓글을 작성할 때, 각 게시물에 대해 하나의 작업이 생성됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ],
      "comment_content": "좋은 영상!\n멋져요!\n최고예요!",
      "comment_order": "sequential"
    }
  }'

이렇게 하면 3개의 독립적인 작업이 즉시 실행됩니다.

예약된 댓글​

start_time을 사용하여 작업이 실행을 시작하는 시간을 예약합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "예약 댓글!"
    },
    "start_time": "14:30"
  }'

이모지 삽입이 있는 댓글​

자동 이모지 삽입을 활성화하여 댓글을 더 매력적으로 만듭니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "정말 멋지네요",
      "insert_emoji": true
    }
  }'

사용자명 목록 패턴별 댓글​

특정 계정에 대해 직접 댓글 작업을 생성합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "comment_content": "좋은 영상이에요!"
    }
  }'

여러 기기에서 일괄 댓글​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999",
      "comment_content": "내용이 정말 좋아요!\n훌륭한 작업!\n정말 좋아요!",
      "comment_order": "random"
    },
    "enable_multi_account": true
  }'

Instagram 댓글 예제​

동일한 API가 Instagram 게시물에 적용됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/",
      "comment_content": "아름다운 사진! 📸",
      "insert_emoji": true
    }
  }'

TikTok 이미지 댓글 예제​

TikTok 댓글에 이미지를 첨부합니다(Instagram은 지원하지 않음):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "이 이미지를 확인해 보세요!",
      "comment_image_path": "C:/images/my_image.jpg"
    }
  }'
이미지 경로

comment_image_path는 다음과 같을 수 있습니다:

  • 절대 경로: C:/images/my_image.jpg 또는 /home/user/images/my_image.jpg
  • 상대 경로: my_image.jpg(work_dir/upload/에 상대적)

응답​

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

댓글 순서​

무작위 순서 (random)​

  • 제공된 목록에서 무작위로 댓글을 선택합니다
  • 댓글을 더 자연스럽게 보이게 하는 데 적합합니다
  • 기본 동작

순차 순서 (sequential)​

  • job_count에 따라 순서대로 댓글을 선택합니다
  • 첫 번째 작업은 첫 번째 댓글을 사용하고, 두 번째 작업은 두 번째 댓글을 사용하는 식입니다
  • 목록의 끝에 도달하면 처음부터 다시 시작합니다
  • 여러 작업 간에 다양한 댓글을 배포하는 데 적합합니다

게시물 URL 형식​

TikTok​

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram​

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

모범 사례​

  1. 댓글 다양성 사용: 스팸처럼 보이는 것을 방지하기 위해 여러 댓글 옵션을 제공합니다.

  2. 다양성을 위해 순차 모드 사용: 동일한 기기로 여러 게시물에 댓글을 작성할 때 sequential 순서를 사용하여 다양한 댓글을 배포합니다.

  3. 이모지 삽입 활성화: insert_emoji: true를 설정하여 댓글을 더 자연스럽고 매력적으로 보이게 합니다.

  4. 작업 예약: start_time 매개변수를 사용하여 일정 기간 동안 댓글을 분산시키고 속도 제한을 트리거할 가능성을 줄입니다.

  5. 플랫폼 제한 준수: 한 번에 너무 많은 댓글 작업을 생성하지 마세요. 대부분의 플랫폼은 댓글에 대한 속도 제한이 있습니다.

오류 코드​

코드설명
40001대상 게시물 URL 또는 댓글 내용 누락
40003API가 스크립트를 지원하지 않습니다
40301API 접근에는 Pro+ 계획이 필요합니다

참조​