TikTok 캡션·해시태그 API: 엔드포인트와 한도

Koda 사용해 보기 최종 확인일

Koda는 POST 엔드포인트 3개(/api/v1/caption, /api/v1/hashtags, /api/v1/script)를 제공하며, 직접 만들고 폐기할 수 있는 API 키로 인증합니다. 캡션이나 해시태그 세트는 1크레딧, 스크립트는 2크레딧이며, 모든 응답이 credits_used와 credits_remaining을 반환하므로 잔액이 바닥나기 전에 내 코드에서 멈출 수 있습니다. 크레딧은 팩으로 구매하며 크레딧당 $0.05에서 $0.03까지이고, 스튜디오에서 쓰는 Koda Coins와는 별개입니다.

세 엔드포인트의 호출당 비용

각 호출은 정수 크레딧으로 가격이 매겨지고, 생성이 성공하면 원자적으로 차감됩니다. 차감은 기록 시점에 잔액이 여전히 충분해야만 이뤄지므로, 실패한 호출은 과금되지 않습니다.

엔드포인트크레딧
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
호출당, 키별. 요청 한도는 각 엔드포인트에서 60초당 5건.

크레딧 하나는 실제로 얼마인가요?

팩 크기는 네 가지이고, 클수록 단가가 내려갑니다. 100크레딧에서는 크레딧당 $0.05, 5000크레딧에서는 $0.03입니다. 가장 좋은 단가라면 캡션 하나에 3센트입니다.

크레딧은 결제 주기와 함께 만료되지 않으며, Koda Coins도 아닙니다. 코인 하나는 스튜디오 안에서 실제 공급사 비용 0.001달러를 나타내고, API 크레딧은 고정 소매 단위입니다. 둘은 서로 전환되지 않으며, 그래서 대시보드에서도 따로 셉니다.

팩크레딧당 가격
100크레딧$0.05
500크레딧$0.04
1000크레딧$0.035
5000크레딧$0.03
팩 크기와 크레딧당 가격.

응답이 텍스트 외에 주는 것

성공한 모든 응답에는 credits_used와 credits_remaining이 들어 있습니다. 연결해 둘 가치가 있는 부분입니다. 배치 작업은 별도 엔드포인트를 폴링하는 대신 마지막 호출에서 남은 잔액을 읽고 깔끔하게 스스로 멈출 수 있습니다.

잔액이 부족하면 호출은 HTTP 402와 코드 insufficient_credits, 그리고 현재 잔액을 반환합니다. 실패를 오류 문자열 파싱이 아니라 프로그램으로 처리할 수 있습니다.

이 기능이 하지 않는 것

  • 영상, 이미지, 음성은 생성하지 않습니다. v1 API는 텍스트 전용으로 캡션, 해시태그, 스크립트만 다룹니다. 영상 생성은 스튜디오에 남아 있고, 그곳에서는 모델별·초 단위로 코인 가격이 매겨집니다.
  • 게시하지 않습니다. v1에는 TikTok, Instagram, YouTube에 게시하는 기능이 없습니다. 계정 연결과 게시는 대시보드에서 하는 작업입니다.
  • 요청 한도는 엔드포인트당 분당 5건으로, 월간 할당량이 아니라 순간적인 몰림에 대한 상한입니다. 그 이상이 필요한 작업은 스스로 속도를 조절해야 합니다.
  • API에는 무료 등급이 없습니다. 크레딧은 첫 호출 전에 구매합니다.

자주 묻는 질문

API 크레딧과 Koda Coins는 잔액을 공유하나요?
아닙니다. 두 개의 별도 잔액이며 대시보드에서도 따로 표시됩니다. Koda Coins는 스튜디오 생성 비용을 내고 실제 공급사 비용을 반영합니다. API 크레딧은 v1 엔드포인트용으로 팩 단위로 사는 고정 소매 단위입니다.
실패한 호출은 어떻게 되나요?
과금되지 않습니다. 차감은 잔액이 여전히 충분할 때만 적용되는 조건부 기록이고, 생성 결과가 돌아온 뒤에 실행됩니다. 그래서 공급사 오류나 요청 한도 거부가 있어도 잔액은 그대로입니다.
API 키를 폐기할 수 있나요?
네, Developer 페이지에서 할 수 있습니다. 키 전체는 생성할 때 단 한 번만 표시되며, 언제든 폐기할 수 있습니다. 사용량은 키별로 기록되므로 어떤 키가 무엇을 썼는지 확인할 수 있습니다.

Koda 사용해 보기

Koda 사용해 보기

이 페이지를 만든 방법: Koda가 실제로 사용하는 설정과 한도를 바탕으로 AI의 도움을 받아 작성. 확인일 .