Tích hợp Tổng Kho API
API tạo ảnh và video theo cơ chế bất đồng bộ. Bạn gửi yêu cầu, nhận job_id, sau đó kiểm tra trạng thái để lấy kết quả.
https://tongkhoapi.net/v1Xác thực API key
Tạo key trong Dashboard, rồi gửi ở header của mọi request. Không đưa API key vào URL hoặc mã JavaScript chạy trên trình duyệt.
Authorization: Bearer tk_live_xxxxxxxxxModel Grok và GPT
Giá dưới đây được trừ trực tiếp theo từng job. Mở hướng dẫn trên từng model để lấy đúng endpoint, model ID và câu lệnh mẫu.
GPT Image 2
Tạo ảnh mới và chỉnh sửa ảnh với khả năng bám prompt, chữ và ảnh tham chiếu.
tongkho-image-2Grok Imagine Video 1.5 480p
Tạo video Grok nhanh, tiết kiệm credit, phù hợp bản nháp và nội dung số lượng lớn.
tongkho-video-480pGrok Imagine Video 1.5 720p
Cân bằng giữa chất lượng và chi phí, phù hợp nội dung mạng xã hội và quảng cáo.
tongkho-video-720pGrok Imagine Video 1.5 1080p
Độ phân giải Full HD dành cho video thành phẩm cần chất lượng hiển thị cao.
tongkho-video-1080pcurl https://tongkhoapi.net/v1/models \
-H "Authorization: Bearer $TONGKHO_API_KEY"Cách tải ảnh tham chiếu
Nếu tạo ảnh/video từ ảnh có sẵn, hãy tải ảnh lên trước. API nhận JPG, PNG, WEBP tối đa 15 MB.
C:/duong-dan/anh.jpg bằng vị trí ảnh thật trên máy. Sau khi chạy, sao chép trường url trong kết quả.curl -X POST https://tongkhoapi.net/v1/uploads \
-H "Authorization: Bearer $TONGKHO_API_KEY" \
-F "file=@C:/Users/PC/Pictures/anh-nhan-vat.jpg"{
"object": "file",
"type": "image",
"url": "https://.../anh-da-tai-len.jpg",
"expires_in": 3600
}Câu lệnh mẫu theo từng trường hợp
Tag chuẩn là @Image1, @Image2… Hệ thống cũng nhận @Ảnh 1 và [Ảnh 1], sau đó tự chuẩn hóa.
1. Tải ảnh lên
Tải từng ảnh JPG, PNG hoặc WEBP trước. Thứ tự URL sau khi tải quyết định tag @Image1, @Image2…
curl -X POST https://tongkhoapi.net/v1/uploads \
-H "Authorization: Bearer $TONGKHO_API_KEY" \
-F "file=@C:/duong-dan/anh-nhan-vat.jpg"Viết câu lệnh ảnh đúng cách
Mô tả theo thứ tự chủ thể, hành động, bối cảnh, ánh sáng, góc máy và điều cần giữ nguyên.
Người phụ nữ từ ảnh tham chiếuđứng cầm sản phẩm và nhìn vào máy ảnhtrong studio thời trang tối giảnánh sáng mềm, tông vàng ấmmedium shot, chính diện, 9:16giữ đúng khuôn mặt, tóc và màu daChọn đúng reference_roles
characterKhóa danh tính và khuôn mặt nhân vậtproductGiữ hình dạng, nhãn, logo và màu sản phẩmsceneDùng ảnh làm bối cảnh và bố cụcoutfitChỉ tham chiếu trang phụcreferenceẢnh gợi ý chungKiểm tra trạng thái và tải file
Dùng ID trả về khi tạo job. Khi trạng thái là completed, trường output_url sẽ có đường dẫn tải.
curl https://tongkhoapi.net/v1/generations/JOB_ID \
-H "Authorization: Bearer $TONGKHO_API_KEY"
curl -L https://tongkhoapi.net/v1/files/JOB_ID \
-H "Authorization: Bearer $TONGKHO_API_KEY" \
--output ket-qua.mp4Mã lỗi và hoàn credit
Nếu Worker tạo thất bại, credit của job được hoàn tự động về đúng tài khoản API.