API caption và hashtag TikTok: endpoint và giới hạn

Dùng thử Koda Kiểm tra lần cuối

Koda cung cấp ba endpoint POST — /api/v1/caption, /api/v1/hashtags và /api/v1/script — xác thực bằng một API key mà bạn tự tạo và tự thu hồi. Một caption hoặc một bộ hashtag tốn 1 credit, một kịch bản tốn 2, và mọi phản hồi đều trả về credits_used và credits_remaining để mã của bạn có thể dừng trước khi số dư cạn. Credit được mua theo gói, từ $0.05 mỗi credit xuống tới $0.03, và tách biệt với Koda Coins mà studio sử dụng.

Ba endpoint tốn bao nhiêu cho mỗi lệnh gọi

Mỗi lệnh gọi được tính bằng số credit nguyên, trừ theo kiểu nguyên tử khi việc tạo thành công — một lệnh gọi thất bại không bị tính tiền, vì việc trừ có điều kiện là số dư vẫn đủ tại thời điểm ghi.

EndpointCredit
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Mỗi lệnh gọi, mỗi key. Giới hạn tần suất là 5 yêu cầu mỗi 60 giây trên mỗi endpoint.

Một credit thực sự giá bao nhiêu?

Bốn cỡ gói, và đơn giá giảm theo cỡ: $0.05 mỗi credit ở gói 100, $0.03 ở gói 5000. Một caption ở mức giá tốt nhất là ba xu.

Credit không hết hạn theo kỳ thanh toán và chúng không phải Koda Coins. Một coin đại diện cho $0.001 chi phí nhà cung cấp thật bên trong studio; một API credit là một đơn vị bán lẻ giá cố định. Hai thứ không bao giờ quy đổi sang nhau, đó là lý do chúng được đếm riêng trong bảng điều khiển.

GóiGiá mỗi credit
100 credit$0.05
500 credit$0.04
1000 credit$0.035
5000 credit$0.03
Cỡ gói và giá quy ra cho một credit.

Phản hồi cho bạn gì ngoài văn bản

Mọi phản hồi thành công đều có credits_used và credits_remaining. Đó là phần đáng nối vào hệ thống: một tác vụ hàng loạt có thể đọc số dư còn lại từ lệnh gọi cuối cùng thay vì poll một endpoint riêng, và tự dừng một cách gọn gàng.

Khi số dư quá thấp, lệnh gọi trả về HTTP 402 với mã insufficient_credits và số dư hiện tại, nên lỗi được xử lý bằng chương trình thay vì phải phân tích một chuỗi thông báo lỗi.

Những gì tính năng này không làm

  • Nó không tạo video, hình ảnh hay giọng nói. API v1 chỉ có văn bản — caption, hashtag và kịch bản. Việc tạo video nằm trong studio, nơi giá được tính bằng coin theo model và theo giây.
  • Nó không đăng bài. Không có gì trong v1 đăng lên TikTok, Instagram hay YouTube; kết nối tài khoản và đăng bài là thao tác trong bảng điều khiển.
  • Nó bị giới hạn ở 5 yêu cầu mỗi phút trên mỗi endpoint, đây là trần cho các đợt dồn dập, không phải hạn mức hằng tháng. Một tác vụ cần nhiều hơn phải tự điều tiết nhịp độ.
  • API không có hạng miễn phí. Credit phải được mua trước lệnh gọi đầu tiên.

Câu hỏi thường gặp

API credit và Koda Coins có dùng chung số dư không?
Không. Đó là hai số dư riêng, hiển thị riêng trong bảng điều khiển. Koda Coins trả cho các lần tạo trong studio và theo dõi chi phí nhà cung cấp thật; API credit là đơn vị bán lẻ giá cố định mua theo gói cho các endpoint v1.
Chuyện gì xảy ra với một lệnh gọi thất bại?
Nó không bị tính tiền. Việc trừ là một thao tác ghi có điều kiện, chỉ áp dụng khi số dư vẫn đủ, và chạy sau khi việc tạo trả kết quả — nên lỗi từ nhà cung cấp hay bị từ chối do giới hạn tần suất đều không động tới số dư.
Có thể thu hồi API key không?
Có, từ trang Developer. Một key chỉ được hiển thị đầy đủ đúng một lần, lúc tạo, và có thể bị thu hồi bất cứ lúc nào; mức sử dụng được ghi theo từng key để bạn thấy key nào đã tiêu những gì.

Dùng thử Koda

Dùng thử Koda

Trang này được làm như thế nào: soạn với sự hỗ trợ của AI từ các thiết lập và giới hạn mà chính Koda đang chạy, kiểm tra vào .