Tài liệu tham khảo · Credits
Bảng giá Photta API credit cho mỗi lệnh gọi
Tóm tắt trong một câu
Photta API được định giá theo credits cho mỗi lượt gọi, không tính theo tháng truy cập. Try-on tốn 5 credits ở 2K, ghost mannequin tốn 4, ảnh chi tiết cố định 3. Credits được hoàn lại tự động khi tác vụ thất bại.
- Credits mỗi lệnh gọi: Đã định giá 7 endpoint
- Xử lý: async, polling
- Giới hạn: 600 requests/min
Mọi số liệu credits trên trang này đều đến từ tài liệu Photta API · đã kiểm tra
Credits cho mỗi lượt gọi
Cùng một bảng dữ liệu mà tài liệu API công bố, được trích xuất trực tiếp từ đó.
Chi phí credits theo tính năng và độ phân giải
Apparel Try-On
2K: 5 credits
4K: 6 credits
Jewelry Try-On
2K: 5 credits
4K: 6 credits
Ghost Mannequin
2K: 4 credits
4K: 5 credits
Eyewear Studio
2K: 5 credits
4K: 6 credits
Workflows (per image)
2K: 4 credits
4K: 5 credits
Detail Photo
2K: 3 credits (flat)
4K: 3 credits (flat)
Mannequin Generation
2K: 4 credits (flat)
4K: 4 credits (flat)
Nguồn gốc của credits
Mỗi gói Photta đều bao gồm credits API. Giá được hiển thị theo đơn vị tiền tệ của bạn.
Các gói và số credits hàng tháng tương ứng
Hobby
Hàng tháng: $14
Credits mỗi tháng: 150
Seller
Hàng tháng: $29
Credits mỗi tháng: 500
Brand
Hàng tháng: $79
Credits mỗi tháng: 1,500
Studio
Hàng tháng: $249
Credits mỗi tháng: 5,000
Giá gói là mức giá được áp dụng hôm nay tại photta.app/pricing
Cơ chế trừ phí hoạt động như thế nào
Hoàn tiền khi thất bại
Credits được trừ khi request bắt đầu xử lý và được hoàn lại tự động nếu quá trình khởi tạo thất bại. Một tác vụ thất bại sẽ không tốn chi phí.
Tác vụ batch giữ trước credits
Một batch sẽ giữ trước credits cho toàn bộ ảnh trước khi ảnh đầu tiên được render. Nếu số dư không đủ để giữ chỗ, request sẽ trả về 402 và không có nội dung nào được tạo.
Các lượt gọi miễn phí
Các resource endpoint, phân tích ảnh chi tiết, và mọi thao tác tải lên — mannequin, phông nền, nhãn thương hiệu — đều miễn phí. Chỉ các tác vụ tạo ảnh mới bị tính phí.
Nguồn cấp credits
Credits được cấp theo gói Photta và gia hạn cùng gói đó. Bảng trên niêm yết giá các gói này theo đơn vị tiền tệ của bạn; GET `/api/v1/account` trả về số dư theo từng nguồn và ngày gia hạn tiếp theo.
Câu hỏi thường gặp về credits của API
Credits được trừ vào lúc nào?
Ngay tại thời điểm request được chấp nhận, không phải lúc ảnh hoàn tất. Phản hồi 202 ở hầu hết các endpoint đã báo trước chi phí của tác vụ.
Điều gì xảy ra khi một tác vụ thất bại?
Credits sẽ tự động được hoàn lại. Trong một batch, các mục thất bại được báo cáo riêng biệt và số credits đã giữ trước của chúng được hoàn trả trong `credits_refunded`.
Làm thế nào để kiểm tra số dư của tôi?
GET `/api/v1/account` trả về số dư chi tiết theo từng nguồn cùng với thông tin gói và kỳ gia hạn tiếp theo, còn GET `/api/v1/account/usage` báo cáo mức tiêu hao trong tháng thanh toán hiện tại.
Có mức giá tiền cụ thể cho mỗi ảnh không?
Không trực tiếp — API được tính phí theo credits, và giá của một credit phụ thuộc vào gói đi kèm. Bảng gói dịch vụ trên trang này định giá từng gói theo đơn vị tiền tệ của bạn và ghi rõ số credits đi kèm, vì vậy chi phí cho một hình ảnh bằng giá gói đó chia cho số credits của gói, nhân với số credits mà lượt gọi API tiêu tốn.
Danh sách endpoint và tài liệu tham khảo
Tính năng
Virtual try-on API cho trang phục
REST API giúp mặc trang phục lên mannequin AI. Bất đồng bộ, thời gian tạo 1.5–4 phút, 5 credits ở 2K, 6 ở 4K. Kèm ví dụ cURL, Node.js và Python.
ĐọcTính năng
API try-on trang sức dành cho dây chuyền, nhẫn, vòng tay và hoa tai
Đưa dây chuyền, nhẫn, vòng tay và hoa tai lên người mẫu AI qua REST. 5 credits ở độ phân giải 2K, tích hợp sẵn mannequin cận cảnh, render chuẩn phản chiếu theo tài liệu Photta.
ĐọcTính năng
API ghost mannequin dành cho ảnh sản phẩm kiểu người vô hình
AI ghost mannequin endpoint. Xóa bỏ mannequin khỏi ảnh chụp trang phục và bảo toàn chi tiết bên trong. Dạng 3D hoặc flat-lay, xử lý hàng loạt, 4 credits ở 2K.
ĐọcTài liệu tham khảo
Tạo ảnh Photta đầu tiên trong vòng chưa đầy năm phút.
Đăng ký, tạo API key, chạy lệnh cURL đầu tiên, polling cho đến khi hoàn thành, lưu trữ kết quả. Năm bước, có tài liệu hướng dẫn trọn gói từ đầu đến cuối.
ĐọcTài liệu tham khảo
Xác thực Photta API
Cách xác thực với Photta API: header Authorization, tiền tố key, nơi tạo key và cách xoay vòng key an toàn.
ĐọcTài liệu tham khảo
Rate limit của Photta API
Rate limit của Photta API, khung thời gian, header Retry-After, khoảng thời gian polling và giới hạn đồng thời theo từng gói, tất cả đều được lấy từ tài liệu API.
ĐọcTài liệu tham khảo
Mã lỗi Photta API
Danh sách đầy đủ các loại lỗi của Photta API kèm theo status code, cấu trúc body của lỗi, và những lỗi nào có thể thử lại.
ĐọcTài liệu tham khảo
Các endpoint tài nguyên của Photta API
Liệt kê ma-nơ-canh, tư thế, phông nền, giày dép và nhãn thương hiệu, tải lên nội dung của riêng bạn và xem số dư credit. Các tác vụ tra cứu đằng sau mọi lượt tạo.
Đọc
Mọi số liệu credits trên trang này đều đến từ tài liệu Photta API · đã kiểm tra
Thử nghiệm API trong năm phút
Tạo một Photta API key, dán đoạn mã cURL ở trên, và bạn sẽ nhận được bức ảnh mẫu mặc đồ đầu tiên trước khi pha xong ly cà phê.
- Đã định giá 7 endpoint
- async, polling
- 600 requests/min