================================================================================ TÀI LIỆU KỸ THUẬT HƯỚNG DẪN KẾT NỐI VÀ TÍCH HỢP HỆ THỐNG API (TUAN SU API STORE - PHIÊN BẢN V2.0) ================================================================================ Chào mừng bạn đến với hệ thống API Store. Toàn bộ API của hệ thống được chuẩn hóa tương thích 100% theo định dạng OpenAI API và Anthropic API, hỗ trợ Streaming, Tool Calling, Vision (đọc ảnh), Image Generation (tạo ảnh), Image Edits (sửa ảnh, ghép nhiều ảnh tham chiếu) và Mua tài nguyên tự động. ================================================================================ PHẦN 1: THÔNG TIN ENDPOINT & BASE URL KẾT NỐI ================================================================================ Hệ thống cung cấp 2 Tunnel / Base URL tốc độ cao qua Cloudflare: 1.1. CỔNG CHÍNH (MAIN ROUTE) - Dùng cho đa số các Model: • Base URL: https://tuansuapi.store/v1 • Hỗ trợ: Claude (Fable 5, Opus 4.8, Sonnet 5, Opus 5), DeepSeek (Flash 4.1, Pro, Vision), Qwen 3.8, GLM 5.3, Kimi K3, Gemini Image... 1.2. CỔNG RIÊNG (GPT-5.6 DEDICATED TUNNEL 2): • Base URL: https://router.danlapkythuattonghop-hanoi.com.vn/v1 • Hỗ trợ: Dòng GPT-5.6 (Luna, Terra, Sol), GPT-6-Astra và Claude CCmax. * Xác thực (Authentication): - Header bắt buộc: Authorization: Bearer - Hoặc header riêng cho Claude: x-api-key: - Content-Type: application/json • Cổng Web Check Usage & Nạp tiền: - https://tuansuapi.store/portal (hoặc https://router.danlapkythuattonghop-hanoi.com.vn/key) (Tra cứu 5 chỉ số KPI, lịch sử từng request In/Cache/Out/Chi phí, nạp VietQR tự động) • Quản lý qua Bot Telegram: Menu "API CỦA TÔI" hoặc "VÍ & SỐ DƯ". • Hỗ trợ kỹ thuật 24/7: Admin Telegram: @tuansu_28 ================================================================================ PHẦN 2: DANH MỤC MODEL CHÍNH & BẢNG GIÁ THAM KHẢO ================================================================================ 1. DÒNG SUY LUẬN & LẬP TRÌNH CHUYÊN SÂU (GPT & DEEPSEEK): • Dòng GPT Mới (Gọi qua URL Tunnel 2: https://router.danlapkythuattonghop-hanoi.com.vn/v1): - gpt-5.6-luna : Giá 550đ In / 600đ Out (1M token) | Cache hit 110đ (Tối thiểu 5đ/req) - gpt-5.6-terra : Giá 900đ In / 900đ Out (1M token) | Cache hit 180đ (Tối thiểu 8đ/req) - gpt-5.6-sol : Giá 1500đ In / 1500đ Out (1M token) | Cache hit 300đ (Tối thiểu 12đ/req) - gpt-6-astra : Giá 2300đ In / 2300đ Out (1M token) | Cache hit 460đ (Tối thiểu 20đ/req) * ƯU ĐÃI ĐẶC BIỆT: Nạp từ 500.000đ giảm 50đ/1M In và Out cho cả 4 model GPT trong tuần đầu! • Các model khác (Gọi qua URL chung: https://tuansuapi.store/v1): - grok-4.7 : Giá 700đ In / 700đ Out (1M token) | Cổng chính API tốc độ cao, lý luận & lập trình sâu - deepseek-v4.1-flash : Bản Flash siêu nhanh, hỗ trợ prefix cache token siêu rẻ. - deepseek-v4-pro-0813 : Bản Pro lập trình, viết code và giải thuật chuyên sâu. - deepseek-v4-flash-vision-exp: Nhìn và đọc hiểu hình ảnh (Multimodal Vision). - qwen3.8-flash, glm-5.3 : Tốc độ cao, đa năng. 2. DÒNG GOOGLE GEMINI FLASH HIGH (MỚI - TỐC ĐỘ CAO, SIÊU TIẾT KIỆM): • gemini-3.6-flash-high (hoặc ag/gemini-3.6-flash-high): Giá 250đ In / 550đ Out (1M token) | Cache 25đ • gemini-3.7-flash-high (hoặc ag/gemini-3.7-flash-high): Giá 300đ In / 600đ Out (1M token) | Cache 30đ • gemini-3.8-flash-high (hoặc ag/gemini-3.8-flash-high): Giá 400đ In / 650đ Out (1M token) | Cache 40đ * Được điều phối qua cổng API tốc độ cao, thích hợp xử lý context lớn, chatbot và tự động hóa. 3. DÒNG CLAUDE CAO CẤP: • claude-sonnet-5 / claude-sonnet-5-ccmax: Tốc độ cao, viết code và phân tích sắc bén. • claude-opus-4-8 / claude-opus-4-8-ccmax: Viết code, tư duy logic và suy luận sâu. • claude-opus-5 / claude-opus-5-ccmax : Model thông minh nhất, Extended Thinking cực sâu. • claude-fable-5-ts : Phiên bản tối ưu chi phí theo lượt gọi. 4. DÒNG VẼ & XỬ LÝ ẢNH (IMAGE AI): • gpt-image-2 : Tạo ảnh siêu nét 1024x1024, hỗ trợ sửa ảnh và GHÉP 2+ ẢNH THAM CHIẾU. • gpt-image-2.5-flare : Dòng Flare ánh sáng rực rỡ, nghệ thuật. • gpt-image-2.5-sunburst : Dòng Sunburst điện ảnh chân thực, chi tiết cao. • gemini-3.1-flash-image-preview (nanobanana 2): Nanobanana 2 tốc độ cực nhanh, hỗ trợ tham chiếu. 5. DÒNG TẠO VIDEO AI (VIDEO GENERATION - /v1/videos): • seedance_2.0_fast : Tốc độ render cực nhanh, giá rẻ (5s: 1.100đ · 10s: 2.100đ · 15s: 3.400đ) • seedance_2.5 : Chất lượng cao, hỗ trợ video dài đến 30s (5s: 1.300đ · 10s: 2.400đ · 15s: 3.500đ · 20-30s: 6.000đ) • Veo-3.1 : Model video cao cấp Google DeepMind Veo (1.400đ/video) • gemini-omni-flash-preview : Google Omni Flash (2.200đ/video) 6. DÒNG GIỌNG NÓI & ÂM THANH AI (AUDIO AI - TTS, CLONE GIỌNG & STT): • Qwen/Qwen3-TTS : 650đ / 1.000 ký tự (9 giọng preset + HỖ TRỢ CLONE GIỌNG TỪ AUDIO MẪU ~3s) • Qwen/Qwen3-TTS-VoiceDesign : 650đ / 1.000 ký tự (Thiết kế giọng độc bản bằng prompt mô tả tự nhiên) • inworld-ai/realtime-tts-1.5-mini : 900đ / 1.000 ký tự (Realtime độ trễ siêu thấp <130ms, thoại/Agent) • inworld-ai/realtime-tts-2 : 1.100đ / 1.000 ký tự (Lái cảm xúc qua prompt [be excited], [be happy]...) • inworld-ai/realtime-tts-1.5-max : 1.500đ / 1.000 ký tự (Chất lượng phòng thu cao nhất, truyền cảm) • openai/whisper-large-v3 : 20đ / phút audio (Speech-to-Text bóc băng nhận dạng chuẩn xác nhất) • openai/whisper-large-v3-turbo : 15đ / phút audio (Bóc băng siêu nhanh, giá rẻ tối ưu chi phí) • tts-eleven-* : 695đ - 1.190đ / 1.000 ký tự (Giọng ElevenLabs biểu cảm, hỗ trợ tiếng Việt) • tts-avevoice-* : 1.190đ - 1.685đ / 1.000 ký tự (Đa ngôn ngữ chuyên nghiệp) ================================================================================ PHẦN 3: MẪU CODE GỌI API CHAT / SUY LUẬN (TEXT & CODE) ================================================================================ Endpoint: POST https://tuansuapi.store/v1/chat/completions (Hoặc https://router.danlapkythuattonghop-hanoi.com.vn/v1/chat/completions cho dòng GPT) 3.1. cURL (Streaming): curl -X POST "https://router.danlapkythuattonghop-hanoi.com.vn/v1/chat/completions" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-luna", "messages": [ {"role": "system", "content": "Bạn là trợ lý AI chuyên nghiệp."}, {"role": "user", "content": "Viết thuật toán QuickSort bằng Python ngắn gọn kèm giải thích."} ], "stream": true }' 3.2. Python (Dùng thư viện chính thức openai): ```python from openai import OpenAI client = OpenAI( api_key="sk-9r-xxxx", base_url="https://router.danlapkythuattonghop-hanoi.com.vn/v1" ) response = client.chat.completions.create( model="gpt-5.6-luna", messages=[ {"role": "system", "content": "Bạn là lập trình viên chuyên nghiệp."}, {"role": "user", "content": "Giải thích Decorator trong Python kèm ví dụ."} ], stream=True ) for chunk in response: content = chunk.choices[0].delta.content or "" print(content, end="", flush=True) print() ``` 3.3. Python (Dùng thư viện requests tiêu chuẩn): ```python import requests import json URL = "https://tuansuapi.store/v1/chat/completions" headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } payload = { "model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "Giải bài toán tháp Hà Nội với 4 đĩa."}], "stream": True } response = requests.post(URL, headers=headers, json=payload, stream=True) for line in response.iter_lines(): if line: decoded = line.decode('utf-8') if decoded.startswith("data: ") and decoded != "data: [DONE]": chunk = json.loads(decoded[6:]) content = chunk["choices"][0]["delta"].get("content", "") print(content, end="", flush=True) print() ``` ================================================================================ PHẦN 4: MẪU CODE GỌI VISION (PHÂN TÍCH VÀ ĐỌC HÌNH ẢNH) ================================================================================ Lưu ý quan trọng: Nên truyền ảnh dưới dạng Base64 Data URL (data:image/png;base64,...). Kích thước ảnh tối thiểu 16x16 px. Mẫu code Python hoàn chỉnh: ```python import base64 from openai import OpenAI with open("anh_can_doc.png", "rb") as f: b64_img = base64.b64encode(f.read()).decode("utf-8") client = OpenAI( api_key="sk-9r-xxxx", base_url="https://tuansuapi.store/v1" ) res = client.chat.completions.create( model="deepseek-v4-flash-vision-exp", # hoặc claude-sonnet-5-ccmax messages=[{ "role": "user", "content": [ {"type": "text", "text": "Hãy đọc và phân tích chi tiết hình ảnh này:"}, {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{b64_img}"}} ] }], max_tokens=1000 ) print(res.choices[0].message.content) ``` ================================================================================ PHẦN 5: HƯỚNG DẪN TẠO ẢNH TỪ VĂN BẢN (KHÔNG CÓ ẢNH THAM CHIẾU) ================================================================================ Sử dụng khi bạn muốn vẽ một bức ảnh hoàn toàn mới chỉ từ câu lệnh mô tả (Prompt). 1. ENDPOINT: POST https://tuansuapi.store/v1/images/generations 2. CÁC THAM SỐ CHÍNH (BODY JSON): - model: "gpt-image-2" (hoặc "gpt-image-2.5-flare", "gemini-3.1-flash-image-preview") - prompt: "Câu mô tả chi tiết hình ảnh bạn muốn tạo..." - n: 1 (số lượng ảnh tạo ra) - size: "1024x1024" (hoặc "1024x1792" ảnh dọc, "1792x1024" ảnh ngang) - response_format: "url" (trả về link tải ảnh) HOẶC "b64_json" (trả về chuỗi base64) 3. MẪU REQUEST cURL: curl -X POST https://tuansuapi.store/v1/images/generations \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "Một chú rồng nhỏ dễ thương phong cách 3D Pixar, nền rừng tuyết lung linh, 8k", "n": 1, "size": "1024x1024" }' Phản hồi mẫu từ API: { "created": 1789634367, "data": [ { "url": "https://img.apimatou.cc/i/example_image_123.png", "revised_prompt": "Một chú rồng nhỏ dễ thương..." } ] } 4. CODE PYTHON HOÀN CHỈNH TỰ ĐỘNG TẢI VÀ LƯU ẢNH: ```python import requests API_KEY = "sk-9r-xxxx" URL = "https://tuansuapi.store/v1/images/generations" headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } payload = { "model": "gpt-image-2", "prompt": "Cyberpunk city night view, neon lights, ultra realistic 8k, cinematic lighting", "n": 1, "size": "1024x1024" } response = requests.post(URL, headers=headers, json=payload, timeout=60) result = response.json() if "data" in result and len(result["data"]) > 0: item = result["data"][0] if "url" in item: img_url = item["url"] print(f"Ảnh đã tạo thành công: {img_url}") img_data = requests.get(img_url).content with open("anh_tao_moi.png", "wb") as f: f.write(img_data) print("Đã lưu vào file anh_tao_moi.png") elif "b64_json" in item: import base64 img_bytes = base64.b64decode(item["b64_json"]) with open("anh_tao_moi.png", "wb") as f: f.write(img_bytes) print("Đã lưu ảnh từ base64 vào file anh_tao_moi.png") else: print("Lỗi tạo ảnh:", result) ``` ================================================================================ PHẦN 6: HƯỚNG DẪN SỬA ẢNH (CÓ 1 ẢNH THAM CHIẾU - IMAGE-TO-IMAGE) ================================================================================ Sử dụng khi bạn đã có 1 bức ảnh gốc và muốn: - Thay đổi trang phục, màu tóc, khuôn mặt của nhân vật. - Thay đổi bối cảnh đằng sau (từ phòng khách ra bãi biển, vũ trụ...). - Chuyển đổi phong cách (từ ảnh chụp thật sang phong cách anime/hoạt hình 3D/sơn dầu). 1. ENDPOINT: POST https://tuansuapi.store/v1/images/edits 2. CÁCH 1: GỬI QUA JSON DATA URL (KHUYÊN DÙNG, TIỆN DỤNG NHẤT): Ảnh gốc được mã hóa thành dạng Base64 Data URL: "data:image/png;base64,iVBORw0KGgo..." Ví dụ cURL: curl -X POST https://tuansuapi.store/v1/images/edits \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "Chuyển nhân vật trong bức ảnh này sang phong cách tranh sơn dầu cổ điển", "image": "data:image/png;base64,", "n": 1, "size": "1024x1024" }' 3. CÁCH 2: GỬI MULTIPART FORM-DATA (UPLOAD FILE TRỰC TIẾP): curl -X POST https://tuansuapi.store/v1/images/edits \ -H "Authorization: Bearer " \ -F "model=gpt-image-2" \ -F "prompt=Thêm một chiếc kính râm phong cách ngầu cho nhân vật" \ -F "image=@anh_goc.png;type=image/png" \ -F "size=1024x1024" 4. CODE PYTHON HOÀN CHỈNH SỬA ẢNH TỪ FILE CÓ SẴN TRONG MÁY: ```python import requests import base64 API_KEY = "sk-9r-xxxx" URL = "https://tuansuapi.store/v1/images/edits" def file_to_data_uri(path): with open(path, "rb") as f: encoded = base64.b64encode(f.read()).decode("utf-8") ext = path.split(".")[-1].lower() mime = "image/jpeg" if ext in ["jpg", "jpeg"] else "image/png" return f"data:{mime};base64,{encoded}" anh_goc_uri = file_to_data_uri("anh_chan_dung.png") payload = { "model": "gpt-image-2", "prompt": "Giữ nguyên nét mặt nhân vật, thay đổi nền phía sau thành quán cà phê vintage ngập nắng", "image": anh_goc_uri, "size": "1024x1024" } headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } res = requests.post(URL, headers=headers, json=payload, timeout=90) data = res.json() print("Kết quả:", data) ``` ================================================================================ PHẦN 7: HƯỚNG DẪN GHÉP & KẾT HỢP NHIỀU ẢNH THAM CHIẾU (2+ ẢNH) ================================================================================ ĐÂY LÀ TÍNH NĂNG CỰC KỲ MẠNH MẼ CỦA MODEL `gpt-image-2`: Bạn có thể truyền vào 2 (hoặc 3, 4) bức ảnh khác nhau để AI kết hợp: - Ảnh 1: Khuôn mặt hoặc nhân vật mẫu. - Ảnh 2: Bối cảnh, tư thế hoặc phong cách nghệ thuật mong muốn. -> AI sẽ trích xuất đặc trưng của cả 2 ảnh và kết hợp hài hòa ra bức ảnh mới! 1. ENDPOINT: POST https://tuansuapi.store/v1/images/edits 2. ĐỊNH DẠNG BODY JSON: Truyền mảng danh sách các ảnh vào trường "image" hoặc "images": { "model": "gpt-image-2", "prompt": "Lấy nhân vật nữ từ ảnh thứ nhất, đặt vào khung cảnh lễ hội hoa anh đào từ ảnh thứ hai, phong cách điện ảnh sắc nét", "image": [ "data:image/png;base64,", "data:image/png;base64," ], "size": "1024x1024" } *(Ghi chú: Gateway tự động hỗ trợ cả key "image": [...] lẫn "images": [...])* 3. CODE PYTHON ĐẦY ĐỦ GHÉP 2 ẢNH THAM CHIẾU: ```python import requests import base64 API_KEY = "sk-9r-xxxx" URL = "https://tuansuapi.store/v1/images/edits" def image_to_base64_uri(file_path): with open(file_path, "rb") as f: b64 = base64.b64encode(f.read()).decode("utf-8") ext = file_path.split(".")[-1].lower() mime = "image/jpeg" if ext in ["jpg", "jpeg"] else "image/png" return f"data:{mime};base64,{b64}" # Chuẩn bị 2 ảnh tham chiếu uri_nhan_vat = image_to_base64_uri("nhan_vat_mau.png") # Ảnh 1: Nhân vật uri_boi_canh = image_to_base64_uri("boi_canh_mau.png") # Ảnh 2: Bối cảnh / phong cách payload = { "model": "gpt-image-2", "prompt": "Kết hợp hài hòa hai bức ảnh tham chiếu: Đặt nhân vật ở ảnh thứ nhất vào bối cảnh vũ trụ ở ảnh thứ hai, giữ trọn vẹn đặc điểm trang phục và màu sắc", "image": [uri_nhan_vat, uri_boi_canh], "n": 1, "size": "1024x1024" } headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } print("Đang gửi yêu cầu ghép 2 ảnh...") response = requests.post(URL, headers=headers, json=payload, timeout=120) res_data = response.json() if "data" in res_data and len(res_data["data"]) > 0: item = res_data["data"][0] if "url" in item: print("Link ảnh kết quả:", item["url"]) with open("anh_ghep_ket_qua.png", "wb") as f: f.write(requests.get(item["url"]).content) elif "b64_json" in item: with open("anh_ghep_ket_qua.png", "wb") as f: f.write(base64.b64decode(item["b64_json"])) print("✅ Đã lưu kết quả thành công vào file anh_ghep_ket_qua.png!") else: print("❌ Thất bại:", res_data) ``` 4. MẪU FORM-DATA NHIỀU FILE TRỰC TIẾP BẰNG PYTHON (REQUESTS): ```python import requests files = [ ('image', ('ref1.png', open('anh1.png', 'rb'), 'image/png')), ('image', ('ref2.png', open('anh2.png', 'rb'), 'image/png')) ] data = { 'model': 'gpt-image-2', 'prompt': 'Kết hợp hai ảnh này lại thành tranh vẽ màu nước tuyệt đẹp', 'size': '1024x1024' } headers = {'Authorization': 'Bearer '} res = requests.post("https://tuansuapi.store/v1/images/edits", headers=headers, data=data, files=files) print(res.json()) ``` ================================================================================ ================================================================================ PHẦN 8: HƯỚNG DẪN TẠO VIDEO AI (OPENAI VIDEOS API STANDARD) ================================================================================ Hệ thống hỗ trợ chuẩn OpenAI Videos API (`/v1/videos`) cho phép tạo video từ văn bản (Text-to-Video), tạo chuyển động từ ảnh (Image-to-Video), ghép nhiều ảnh tham chiếu (1-10 ảnh), tạo video từ ảnh đầu & ảnh cuối (First + Last frame), upscale 1080p Full HD và hủy task chưa chạy (`DELETE`). * Xem tài liệu video chuyên sâu và đầy đủ nhất tại: https://tuansuapi.store/docs/video 8.1. ENDPOINTS & THÔNG TIN KẾT NỐI: • Base URL: https://tuansuapi.store/v1 (hoặc https://tuansuapi.store/v1) • Endpoint tạo video: POST https://tuansuapi.store/v1/videos • Endpoint tra cứu / tiến độ: GET https://tuansuapi.store/v1/videos/{video_id} • Endpoint tải trực tiếp MP4: GET https://tuansuapi.store/v1/videos/{video_id}/content • Endpoint hủy task trong hàng đợi: DELETE https://tuansuapi.store/v1/videos/{video_id} • Header: - Authorization: Bearer - Content-Type: application/json (hoặc multipart/form-data) 8.2. BẢNG THAM SỐ CẤU HÌNH VIDEO: ----------------------------------------------------------------------------------------------------------------- Tham số Kiểu Bắt buộc Ý nghĩa & Giá trị hợp lệ ----------------------------------------------------------------------------------------------------------------- model string CÓ Tên model video: • seedance_2.0_fast (cực nhanh, 5s-15s, tối ưu chi phí) • seedance_2.5 (chất lượng điện ảnh cao, 5s-30s) • Veo-3.1 (Google DeepMind Veo, First+Last frame, 1080p) • Omni-Flash (Gemini Vision biến đổi video Video-to-Video) prompt string CÓ Nội dung mô tả video cần tạo (hỗ trợ cả tiếng Việt & Anh) seconds int/string KHÔNG Thời lượng video (mặc định: 5s): • seedance_2.0_fast: 5, 10, 15 • seedance_2.5: 5, 10, 15, 20, 25, 30 • Veo-3.1: 4, 6, 8 • Omni-Flash: 5, 10 size string KHÔNG Độ phân giải khung hình: • 720x1280 (Mặc định: Dọc 9:16 TikTok/Reels/Shorts) • 1280x720 (Ngang 16:9 YouTube/PC) • 1024x1792 (Dọc nét cao) | 1792x1024 (Ngang nét cao) • Seedance hỗ trợ thêm: 1024x1024, 768x1024, 1024x768, 1680x720 aspect_ratio string KHÔNG Tỉ lệ khung hình (thay cho size): 9:16, 16:9, 1:1, 3:4, 4:3, 21:9 input_reference obj/arr/file KHÔNG Ảnh tham chiếu (tối đa 10 ảnh với Seedance, 3 ảnh với Veo/Omni): • 1 ảnh: First frame (tạo video từ ảnh) • Nhiều ảnh: Tham chiếu nhân vật/phong cách/bối cảnh • JSON: {"image_url": "https://..."} hoặc [{"image_url": "url1"}, ...] • Multipart: gửi nhiều trường cùng tên input_reference last_frame obj/file KHÔNG (Chỉ có trên Veo-3.1) Ảnh kết thúc video để chuyển cảnh mượt từ ảnh đầu (input_reference) đến ảnh cuối (last_frame). input_video string/obj KHÔNG (Chỉ có trên Omni-Flash) URL video MP4 gốc cho Video-to-Video. resolution string KHÔNG Đặt "1080p" để upscale Full HD (hỗ trợ trên Veo-3.1). Mặc định: 720p. ----------------------------------------------------------------------------------------------------------------- 8.3. BẢNG GIÁ CHI TIẾT THEO SỐ GIÂY (VNĐ): • Seedance 2 Fast: 5s: 1.100đ | 10s: 2.100đ | 15s: 3.400đ • Seedance 2.5 : 5s: 1.300đ | 10s: 2.400đ | 15s: 3.500đ | 20s/25s/30s: 6.000đ • Veo 3.1 : 1.400đ / video • Omni-Flash : 2.200đ / video * Không phụ thu thêm tiền cho ảnh tham chiếu, last_frame hay upscale 1080p. * Job thất bại do lỗi hệ thống hoặc hủy bằng DELETE sẽ KHÔNG bị trừ tiền. 8.4. CHẾ ĐỘ CHỜ ĐỒNG BỘ (?sync=true) HOẶC ASYNC (OPENAI SDK): • Chuẩn OpenAI SDK: API trả về ngay trạng thái `queued` kèm ID để client polling `client.videos.create_and_poll()`. • Chế độ Sync nhận ngay: Nếu bạn muốn gọi HTTP 1 lần và đợi nhận ngay link MP4 cuối cùng, chỉ cần thêm `?sync=true` vào URL: `POST https://tuansuapi.store/v1/videos?sync=true` Hệ thống đã tích hợp sẵn cơ chế ping keepalive 25s chống ngắt kết nối Cloudflare timeout. 8.5. MẪU GỌI BẰNG PYTHON (OPENAI SDK TIÊU CHUẨN): ```python from openai import OpenAI client = OpenAI( api_key="sk-9r-xxxx", base_url="https://tuansuapi.store/v1" ) # 1. Tạo video tự động thăm dò (create_and_poll) video = client.videos.create_and_poll( model="seedance_2.5", prompt="Cinematic drone shot flying through futuristic neon Tokyo at night, 4k", seconds="10", size="1280x720" ) print("Video đã hoàn tất! ID:", video.id) # 2. Tải trực tiếp file MP4 về máy content = client.videos.download_content(video.id) content.write_to_file("tokyo.mp4") print("Đã lưu video thành công vào file tokyo.mp4!") ``` 8.6. MẪU GỌI BẰNG CURL: a) Text-to-Video 10s màn ngang 16:9: curl -X POST "https://tuansuapi.store/v1/videos" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance_2.5", "prompt": "Cinematic drone shot flying through futuristic neon Tokyo at night, 4k", "seconds": 10, "aspect_ratio": "16:9" }' b) Image-to-Video từ ảnh có sẵn: curl -X POST "https://tuansuapi.store/v1/videos" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance_2.0_fast", "prompt": "The character in the photo smiles gently and looks toward the camera", "seconds": 5, "size": "720x1280", "input_reference": { "image_url": "https://example.com/portrait.jpg" } }' c) Ghép nhiều ảnh tham chiếu nhân vật / bối cảnh (Seedance 2.5): curl -X POST "https://tuansuapi.store/v1/videos" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance_2.5", "prompt": "The woman from image 1 walks her dog from image 2 along the beach in image 3", "seconds": 10, "aspect_ratio": "16:9", "input_reference": [ { "image_url": "https://example.com/woman.jpg" }, { "image_url": "https://example.com/dog.jpg" }, { "image_url": "https://example.com/beach.jpg" } ] }' d) First Frame + Last Frame chuyển cảnh mượt (Veo-3.1, 1080p): curl -X POST "https://tuansuapi.store/v1/videos" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "Veo-3.1", "prompt": "The flower slowly blooms, soft morning light", "seconds": 8, "size": "1280x720", "resolution": "1080p", "input_reference": { "image_url": "https://example.com/bud.jpg" }, "last_frame": { "image_url": "https://example.com/bloom.jpg" } }' e) Hủy task video đang trong hàng đợi: curl -X DELETE "https://tuansuapi.store/v1/videos/video_abc123" \ -H "Authorization: Bearer sk-9r-xxxx" 8.7. MẪU GỌI BẰNG PYTHON (REQUESTS KÈM ?sync=true NHẬN KẾT QUẢ NGAY): ```python import requests API_KEY = "sk-9r-xxxx" URL = "https://tuansuapi.store/v1/videos?sync=true" payload = { "model": "seedance_2.0_fast", "prompt": "A cute Golden Retriever puppy running happily in autumn park, 4k", "seconds": 5, "size": "720x1280" } headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } print("Đang tạo video...") resp = requests.post(URL, headers=headers, json=payload, timeout=900) result = resp.json() print("Trạng thái:", result.get("status")) print("Link video MP4 trực tiếp:", result.get("url")) ``` ================================================================================ PHẦN 9: HƯỚNG DẪN DÙNG TRONG CÁC ỨNG DỤNG CHAT (KHÔNG CẦN CODE) ================================================================================ Nếu bạn sử dụng các phần mềm chat như NextChat, Cherry Studio, Chatbox, LibreChat: 1. KHI TẠO ẢNH MỚI (TEXT-TO-IMAGE): - Chọn model `gpt-image-2` (hoặc `gemini-3.1-flash-image-preview`). - Gõ prompt mô tả ảnh cần tạo: "Vẽ một bức tranh sơn thủy hữu tình lúc hoàng hôn..." - Bot sẽ tự động trả về bức ảnh vẽ được trực tiếp trong cửa sổ chat! 2. KHI CẦN THAM CHIẾU ẢNH (IMAGE-TO-IMAGE HOẶC GHÉP NHIỀU ẢNH): - Chọn model `gpt-image-2`. - Nhấn nút ĐÍNH KÈM / TẢI ẢNH (biểu tượng Kẹp giấy 📎 hoặc dấu Cộng ➕). - Chọn 1 hoặc 2 bức ảnh từ máy tính / điện thoại tải lên khung chat. - Nhập prompt: "Dựa vào 2 ảnh trên, hãy ghép nhân vật ở ảnh 1 vào khung cảnh ở ảnh 2 giúp tôi". - Nhấn Gửi -> Gateway tự động gom chuyển 2 ảnh vào luồng xử lý `edits` và trả về ảnh kết hợp ngay trong chat! ================================================================================ PHẦN 10: CẤU HÌNH CHERRY STUDIO VÀ CHATBOX AI ================================================================================ Cherry Studio và Chatbox AI đều kết nối được qua giao thức OpenAI-compatible. Trước khi thêm model, gọi GET /v1/models và dùng đúng model ID được cấp cho API key. 1. CHERRY STUDIO: • Cài đặt (Settings) -> Model Provider -> Add -> OpenAI Compatible • Tên provider: TUAN SU API • API Base URL: https://tuansuapi.store/v1 • API Key: key đã mua • Manage Models -> Add model -> nhập đúng ID lấy từ /v1/models 2. CHATBOX AI: • Cài đặt -> Model Provider -> OpenAI API Compatible • API Host / Base URL: https://tuansuapi.store/v1 • API Key: key của bạn • Model: chọn hoặc nhập đúng model ID • Nếu Chatbox tách Host và Path: Host https://tuansuapi.store, Path /v1 3. CHẾ ĐỘ CLAUDE / ANTHROPIC: • Nếu ứng dụng có provider Anthropic riêng, dùng Base URL https://tuansuapi.store (không thêm /v1) • Gửi key ở x-api-key và dùng giao thức Messages 4. KIỂM TRA KẾT NỐI: curl --fail-with-body https://tuansuapi.store/v1/models -H "Authorization: Bearer YOUR_API_KEY" Luôn bật streaming. Với model suy luận dài, đặt read timeout 120-180 giây. Model phải được cấp cho key; nhập sai tên model sẽ báo lỗi. ================================================================================ PHẦN 11: CÁC LƯU Ý KỸ THUẬT QUAN TRỌNG ================================================================================ 1. LƯU Ý SỐNG CÒN VỀ STREAM & TIMEOUT: - Với các model suy luận sâu như `gpt-5.6-luna`, `claude-opus-5`, `deepseek-v4-pro`, AI cần thời gian suy nghĩ (reasoning) từ 20 đến 45 giây trước khi ra câu trả lời hoàn chỉnh. - Hầu hết các ứng dụng (NextChat, Chatbox, thư viện code) mặc định Request Timeout là 30s. - NẾU TẮT STREAM ("stream": false): Trong suốt 30s suy luận, server chưa gửi byte nào về, phần mềm client sẽ tưởng server bị treo và TỰ ĐỘNG NGẮT KẾT NỐI (dẫn đến lỗi Status 499 / 524)! - KHI BẬT STREAM ("stream": true): Hệ thống phát nhịp tim (heartbeat) và gửi từng token về client liên tục, đảm bảo kết nối mượt mà, nhanh và không bao giờ bị timeout. - Khuyến nghị: Luôn cấu hình Request Timeout của client từ 60s - 120s và luôn bật STREAM. 2. CƠ CHẾ CACHE TOKEN (PROMPT CACHING): - Hệ thống tự động cache ngữ cảnh (prompt cache) đối với các chuỗi prompt dài. - Khi cache hit, giá token đầu vào sẽ được giảm cực mạnh (chỉ từ 50đ - 180đ/1M token thay vì giá đầy đủ). 3. QUẢN LÝ HẠN MỨC & NẠP VÍ TỰ ĐỘNG: - Bạn có thể kiểm tra số dư và lịch sử chi tiết từng request tại Bot Telegram hoặc qua: Web Portal: https://tuansuapi.store/portal (đăng nhập bằng mã API key). ================================================================================ PHẦN 12: HƯỚNG DẪN MUA TÀI KHOẢN GMAIL / SOCIAL QUA REST API (CHUẨN REST API) ================================================================================ Hệ thống hỗ trợ REST API trực tiếp giúp bạn tra cứu danh mục, mã loại (product_id), giá tiền, tồn kho và đặt mua số lượng lớn tài khoản Gmail tự động. Chi phí mua tài khoản sẽ được trừ trực tiếp vào số dư Ví chung của API Key. 11.1. Tra cứu danh mục & mã loại Gmail (GET): • Endpoint: GET https://tuansuapi.store/v1/gmail/products • Header: Authorization: Bearer Mẫu gọi curl: curl -X GET "https://tuansuapi.store/v1/gmail/products" \ -H "Authorization: Bearer sk-9r-xxxx" Kết quả trả về (JSON): { "status": "success", "total": 76, "products": [ { "product_id": "75441", "type_id": "75441", "name": "Gmail New Random đã ngâm 3 - 7 ngày (ID|Pass)", "price_vnd": 28400, "stock": 1249, "description": "Login bằng app gmail trên phone...", "category": "Gmail New" } ] } 11.2. Đặt mua tài khoản theo mã loại & số lượng (POST): • Endpoint: POST https://tuansuapi.store/v1/gmail/buy • Header: - Authorization: Bearer - Content-Type: application/json • Body JSON: { "product_id": "75441", // Mã loại lấy từ danh mục ở bước 11.1 "quantity": 2 // Số lượng tài khoản cần mua } Mẫu gọi curl: curl -X POST "https://tuansuapi.store/v1/gmail/buy" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "product_id": "75441", "quantity": 2 }' Kết quả trả về thành công (200 OK): { "status": "success", "message": "Mua thành công 2 tài khoản Gmail New Random", "order": { "product_id": "75441", "product_name": "Gmail New Random đã ngâm 3 - 7 ngày", "quantity": 2, "price_each_vnd": 28400, "total_amount_vnd": 56800, "remaining_balance_vnd": 143200, "accounts": [ "username1@gmail.com|password123|recovery1@gmail.com", "username2@gmail.com|password456|recovery2@gmail.com" ] } } 11.3. Mẫu Python gọi trực tiếp: ```python import requests API_KEY = "sk-9r-xxxx" BASE_URL = "https://tuansuapi.store/v1" HEADERS = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } # 1. Lấy danh sách sản phẩm còn hàng res = requests.get(f"{BASE_URL}/gmail/products", headers=HEADERS) products = res.json().get("products", []) print(f"Tổng số loại: {len(products)}") # 2. Mua 2 tài khoản loại 75441 order = requests.post(f"{BASE_URL}/gmail/buy", json={ "product_id": "75441", "quantity": 2 }, headers=HEADERS).json() if order.get("status") == "success": print("Mua thành công! Danh sách tài khoản:") for acc in order["order"]["accounts"]: print(" ->", acc) else: print("Lỗi:", order.get("message")) ``` 11.4. Tương thích phụ qua Chat Completions: Bạn cũng có thể gọi qua `/v1/chat/completions` với model `gmail` hoặc `gmail-{product_id}` và ghi số lượng trong messages (ví dụ: "Mua 2 gmail"). Hệ thống vẫn hỗ trợ song song. ================================================================================ PHẦN 13: XỬ LÝ SỰ CỐ VÀ CÁC CÂU HỎI THƯỜNG GẶP (FAQ) ================================================================================ Hỏi: Tôi gọi model `gpt-5.6-luna` bị lỗi đỏ status 499 hoặc 524? Đáp: Lỗi 499/524 là do client của bạn tự ngắt kết nối khi hết 30s timeout trong lúc AI đang suy luận. Hãy BẬT "stream": true hoặc tăng Request Timeout trong app của bạn lên 90s - 120s. Hỏi: Muốn ghép 2 ảnh thì ảnh kích thước thế nào? Đáp: Bạn có thể dùng ảnh PNG, JPG dung lượng dưới 10MB mỗi ảnh. Hệ thống sẽ tự chuẩn hóa và sinh ra ảnh vuông 1024x1024 (hoặc tỉ lệ bạn chọn trong tham số `size`). Hỏi: Kiểm tra số dư tài khoản ở đâu? Đáp: Mở Bot Telegram bán hàng của shop -> Nhấn menu "API CỦA TÔI" hoặc "VÍ & SỐ DƯ", hoặc truy cập Web Portal: https://tuansuapi.store/portal nhập mã key để xem chi tiết. Hỏi: Khi dùng hết tiền thì nạp thêm bằng cách nào? Đáp: Vào Bot Telegram hoặc Web Portal -> Chọn Nạp thêm tiền cho API bằng mã VietQR chuyển khoản tự động qua Pay2s. Chọn đúng ngân hàng/tài khoản và nội dung chuyển khoản trên mã QR của đơn. ================================================================================ Chúc bạn có những trải nghiệm lập trình và sáng tạo tuyệt vời cùng dịch vụ API! Hỗ trợ kỹ thuật 24/7 qua Telegram: @tuansu_28 PHẦN 14: TEXT-TO-SPEECH (TTS) & VOICE CLONING (NHÂN BẢN GIỌNG NÓI) ================================================================================ Hệ thống hỗ trợ chuẩn OpenAI Audio API (/v1/audio/speech) và DeepInfra Voice Gateway, cho phép tạo giọng nói AI chất lượng cao, thiết kế giọng tự do bằng prompt (VoiceDesign) và nhân bản giọng nói tức thì (Instant Voice Cloning) từ file âm thanh mẫu ngắn ~3 giây. 14.1. ENDPOINTS & THÔNG TIN KẾT NỐI: • Base URL: https://tuansuapi.store/v1 (hoặc https://tuansuapi.store/v1) • Tạo giọng nói (TTS) : POST https://tuansuapi.store/v1/audio/speech • Upload & nhân bản giọng nói : POST https://tuansuapi.store/v1/voices/add • Xem danh sách giọng đã clone : GET https://tuansuapi.store/v1/voices • Xóa giọng đã clone : DELETE https://tuansuapi.store/v1/voices/{voice_id} • Tra cứu danh sách giọng mẫu : GET https://tuansuapi.store/v1/audio/voices • Header: - Authorization: Bearer - Content-Type: application/json (hoặc multipart/form-data khi upload file clone) 14.2. DANH MỤC MODEL TTS & BẢNG GIÁ (VNĐ / 1.000 KÝ TỰ): ----------------------------------------------------------------------------------------------------------------- Model Giá / 1.000 ký tự Đặc điểm & Khả năng nổi bật ----------------------------------------------------------------------------------------------------------------- Qwen/Qwen3-TTS 650đ 9 giọng preset + HỖ TRỢ CLONE GIỌNG TỪ FILE MẪU ~3s Qwen/Qwen3-TTS-VoiceDesign 650đ Thiết kế giọng độc bản bằng prompt mô tả tự nhiên inworld-ai/realtime-tts-1.5-mini 900đ Realtime độ trễ siêu thấp (<130ms), hội thoại AI/Agent inworld-ai/realtime-tts-2 1.100đ Hỗ trợ lái cảm xúc qua prompt ([be excited], [be happy]...) inworld-ai/realtime-tts-1.5-max 1.500đ Chất lượng phòng thu cao nhất, tự nhiên, truyền cảm tts-eleven-* (Dòng ElevenLabs) 695đ - 1.190đ Kho giọng biểu cảm ElevenLabs, hỗ trợ tiếng Việt & quốc tế tts-avevoice-* (Dòng AveVoice) 1.190đ - 1.685đ Đa ngôn ngữ chuyên nghiệp (42 ngôn ngữ) ----------------------------------------------------------------------------------------------------------------- * Tiền tính theo số ký tự Unicode thực tế trong trường "input". Tối thiểu 1đ/request. * Request lỗi do hệ thống không bị trừ tiền. * Kết quả trả về trực tiếp định dạng nhị phân MP3 (Content-Type: audio/mpeg). 14.3. HƯỚNG DẪN CHI TIẾT VOICE CLONING (NHÂN BẢN GIỌNG NÓI VỚI QWEN3-TTS): Mô hình `Qwen/Qwen3-TTS` cho phép nhân bản bất kỳ giọng nói nào chỉ từ 1 đoạn ghi âm mẫu ~3 đến 15 giây. Quy trình gồm 2 bước cực kỳ đơn giản: [Bước 1: Upload file mẫu] ──> Nhận mã voice_id (ví dụ: "32us5e83orq6ub8803am") │ ▼ [Bước 2: Gọi TTS] ──────────> Truyền "voice": "" vào POST /v1/audio/speech ► BƯỚC 1: Tải file mẫu lên để lấy voice_id (POST /v1/voices/add): Gửi request dạng multipart/form-data: - files: File âm thanh mẫu (.wav, .mp3, .m4a) từ 3s - 15s (rõ tiếng, không tạp âm) - name: Tên gợi nhớ cho giọng (ví dụ: Giong_MC_Thao) - description: Mô tả (tùy chọn) Ví dụ cURL: curl -X POST "https://tuansuapi.store/v1/voices/add" \ -H "Authorization: Bearer sk-9r-xxxx" \ -F "files=@giong_mau.wav" \ -F "name=Giong_MC_Thao" \ -F "description=Giong nu am ap phat thanh vien" Phản hồi JSON (200 OK): { "voice_id": "32us5e83orq6ub8803am", "name": "Giong_MC_Thao", "description": "Giong nu am ap phat thanh vien", "created_at": 1791350446 } => Lưu lại mã `voice_id` này để dùng cho mọi lần gọi TTS sau này! ► BƯỚC 2: Gọi TTS với voice_id đã clone (POST /v1/audio/speech): Truyền `model: "Qwen/Qwen3-TTS"` và `voice: ""`: Ví dụ cURL: curl -X POST "https://tuansuapi.store/v1/audio/speech" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "Qwen/Qwen3-TTS", "voice": "32us5e83orq6ub8803am", "input": "Xin chào quý vị, đây là giọng nói đã được AI nhân bản thành công từ đoạn ghi âm mẫu 3 giây.", "response_format": "mp3" }' \ --output ket_qua_clone.mp3 ► Quản lý danh sách Voice đã clone: - Tra cứu tất cả giọng đã clone: GET https://tuansuapi.store/v1/voices - Xóa giọng đã clone: DELETE https://tuansuapi.store/v1/voices/{voice_id} 14.4. HƯỚNG DẪN THIẾT KẾ GIỌNG TỰ DO BẰNG PROMPT (Qwen/Qwen3-TTS-VoiceDesign): Không cần file ghi âm mẫu! Bạn chỉ cần miêu tả tính cách, độ tuổi và âm sắc mong muốn trong tham số `voice`: curl -X POST "https://tuansuapi.store/v1/audio/speech" \ -H "Authorization: Bearer sk-9r-xxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "Qwen/Qwen3-TTS-VoiceDesign", "voice": "a young cheerful female Vietnamese speaker with a warm and friendly tone", "input": "Chào mừng bạn đến với ứng dụng trợ lý thông minh, chúc bạn một ngày làm việc tuyệt vời!", "response_format": "mp3" }' \ --output voicedesign_demo.mp3 Một số gợi ý mô tả giọng: • "a deep authoritative male voice with a calm tone" (Giọng nam trầm ấm, uy quyền) • "a gentle, warm and sweet young female voice" (Giọng nữ trẻ trung, ngọt ngào, dịu dàng) • "an enthusiastic energetic male podcast host" (Giọng nam dẫn podcast năng động, nhiệt huyết) 14.5. DANH SÁCH GIỌNG CÓ SẴN (PRESET VOICES): • Dòng Qwen3-TTS (9 giọng chuẩn): - Vivian (Nữ trẻ trung - Mặc định), Serena (Nữ dịu dàng), Uncle_Fu (Nam trung niên kể chuyện), - Dylan (Nam hiện đại), Eric (Nam tin tức chuyên nghiệp), Ryan (Nam năng động), - Aiden (Nam sách nói rõ ràng), Ono_Anna (Nữ phong cách Á), Sohee (Nữ nhẹ nhàng). • Dòng Inworld 2.0: Hỗ trợ gắn thẻ cảm xúc trực tiếp trong văn bản để tự động uốn lượn ngữ điệu: Ví dụ input: "[be excited and joyful] Thật tuyệt vời! Chúng ta đã hoàn thành xuất sắc dự án!" • Dòng ElevenLabs: - Giọng tiếng Việt: elevenlabs_Jxl0M2KOcLjO5ReRA5rH (Đạt - chuẩn Bắc), elevenlabs_njal9ZYZB2BSvEp2g2Fe (Cường Nguyễn - ấm áp) - Giọng tiếng Anh & đa ngôn ngữ: Rachel, Domi, Antoni, Josh, Arnold, Adam, Sam, Elli, Daniel. • Dòng AveVoice: Aanya (Nữ tiếng Việt/đa ngữ), Amara, Ananya, Rohan, Kabir. 14.6. MẪU CODE PYTHON GỌI TTS & VOICE CLONE HOÀN CHỈNH: ```python import requests API_KEY = "sk-9r-xxxx" BASE_URL = "https://tuansuapi.store/v1" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Cách 1: Clone giọng từ file mẫu và đọc văn bản # 1. Upload file mẫu lấy voice_id with open("sample.wav", "rb") as f: r = requests.post(f"{BASE_URL}/voices/add", headers=HEADERS, files={"files": f}, data={"name": "MyVoice"}).json() voice_id = r.get("voice_id") print(f"Đã clone thành công voice_id: {voice_id}") # 2. Gọi đọc bằng giọng vừa clone tts_payload = { "model": "Qwen/Qwen3-TTS", "voice": voice_id, "input": "Xin chào bạn, đây là giọng đọc vừa được nhân bản bằng AI!", "response_format": "mp3" } tts_res = requests.post(f"{BASE_URL}/audio/speech", headers={**HEADERS, "Content-Type": "application/json"}, json=tts_payload) with open("cloned_speech.mp3", "wb") as f: f.write(tts_res.content) print("Đã lưu cloned_speech.mp3 thành công!") ``` ================================================================================ PHẦN 15: SPEECH-TO-TEXT (STT) — NHẬN DẠNG & BÓC BĂNG ÂM THANH (OPENAI WHISPER) ================================================================================ Hệ thống hỗ trợ chuẩn OpenAI Audio Transcriptions API (`/v1/audio/transcriptions`) với 2 mô hình nhận diện giọng nói hàng đầu thế giới từ OpenAI Whisper. Hỗ trợ bóc băng văn bản, tự động phát hiện ngôn ngữ, tạo phụ đề video (.srt, .vtt) và xuất mốc thời gian chi tiết (timestamps từng từ). 15.1. ENDPOINTS & BẢNG GIÁ: • Endpoint: POST https://tuansuapi.store/v1/audio/transcriptions • Header: - Authorization: Bearer - Content-Type: multipart/form-data • Danh mục model & Đơn giá: ----------------------------------------------------------------------------------------------------------------- Model Đơn giá Đơn vị tính Đặc điểm nổi bật ----------------------------------------------------------------------------------------------------------------- openai/whisper-large-v3 20đ / phút audio Thời lượng thực tế Độ chính xác cao nhất, tiếng Việt cực chuẩn openai/whisper-large-v3-turbo 15đ / phút audio Thời lượng thực tế Tốc độ xử lý siêu nhanh, tối ưu chi phí ----------------------------------------------------------------------------------------------------------------- * Tính tiền theo thời lượng file âm thanh thực tế (quy đổi từ giây ra phút, chỉ ~0.25đ - 0.33đ/giây). * Hỗ trợ mọi định dạng phổ biến: mp3, wav, m4a, flac, ogg, webm, mp4. * Giới hạn dung lượng file tải lên đến 25MB (nếu file dài hơn nên cắt nhỏ thành từng đoạn). 15.2. CÁC THAM SỐ GỬI LÊN (FORM-DATA): • file : File âm thanh cần nhận dạng (Bắt buộc) • model : "openai/whisper-large-v3" hoặc "openai/whisper-large-v3-turbo" (Bắt buộc) • response_format : Định dạng phản hồi mong muốn (Tùy chọn, mặc định: "json"): - "json" : Trả về {"text": "văn bản..."} - "verbose_json": Trả về chi tiết {"duration", "language", "segments": [{"start", "end", "text"}]} - "text" : Trả về chuỗi văn bản thuần (plain text) - "srt" : Xuất file phụ đề SubRip (.srt) cho trình phát video - "vtt" : Xuất file phụ đề WebVTT (.vtt) cho web video • language : Mã ngôn ngữ (ví dụ "vi", "en", "zh"...). Mặc định Whisper tự động nhận diện ngôn ngữ. • temperature : 0 (Mặc định, chính xác nhất) 15.3. MẪU cURL BÓC BĂNG ÂM THANH: a) Nhận kết quả JSON cơ bản: curl -X POST "https://tuansuapi.store/v1/audio/transcriptions" \ -H "Authorization: Bearer sk-9r-xxxx" \ -F "file=@ghi_am_cuoc_hop.mp3" \ -F "model=openai/whisper-large-v3-turbo" b) Nhận chi tiết timestamps và thời lượng (verbose_json): curl -X POST "https://tuansuapi.store/v1/audio/transcriptions" \ -H "Authorization: Bearer sk-9r-xxxx" \ -F "file=@ghi_am.wav" \ -F "model=openai/whisper-large-v3" \ -F "response_format=verbose_json" Phản hồi mẫu: { "task": "transcribe", "language": "vi", "duration": 42.5, "text": "Chào các bạn, hôm nay chúng ta sẽ bắt đầu buổi thảo luận về dự án mới...", "segments": [ {"id": 0, "start": 0.0, "end": 4.2, "text": "Chào các bạn,"}, {"id": 1, "start": 4.2, "end": 9.5, "text": "hôm nay chúng ta sẽ bắt đầu buổi thảo luận về dự án mới..."} ] } c) Xuất trực tiếp file phụ đề SRT: curl -X POST "https://tuansuapi.store/v1/audio/transcriptions" \ -H "Authorization: Bearer sk-9r-xxxx" \ -F "file=@video_podcast.mp4" \ -F "model=openai/whisper-large-v3-turbo" \ -F "response_format=srt" \ -o phu_de.srt 15.4. MẪU PYTHON (DÙNG OPENAI SDK CHÍNH THỨC): ```python from openai import OpenAI client = OpenAI( api_key="sk-9r-xxxx", base_url="https://tuansuapi.store/v1" ) # Bóc băng âm thanh với Whisper with open("cuoc_hop.mp3", "rb") as audio_file: transcript = client.audio.transcriptions.create( model="openai/whisper-large-v3-turbo", file=audio_file, response_format="verbose_json" ) print("Ngôn ngữ nhận dạng:", transcript.language) print("Thời lượng:", transcript.duration, "giây") print("Nội dung bóc băng:\n", transcript.text) ``` 15.5. MẪU PYTHON (DÙNG THƯ VIỆN REQUESTS XUẤT FILE PHỤ ĐỀ SRT): ```python import requests API_KEY = "sk-9r-xxxx" URL = "https://tuansuapi.store/v1/audio/transcriptions" with open("podcast.m4a", "rb") as f: files = {"file": ("podcast.m4a", f, "audio/mp4")} data = { "model": "openai/whisper-large-v3-turbo", "response_format": "srt", "language": "vi" } res = requests.post(URL, headers={"Authorization": f"Bearer {API_KEY}"}, files=files, data=data) if res.status_code == 200: with open("subtitles.srt", "w", encoding="utf-8") as out: out.write(res.text) print("Đã tạo file phụ đề subtitles.srt thành công!") else: print("Lỗi bóc băng:", res.status_code, res.text) ``` ================================================================================ Tài liệu chuyên sâu chi tiết: • Audio & TTS & Voice Clone : https://tuansuapi.store/docs/tts (hoặc /docs/audio) • Video AI (Tạo/Poll/Tải) : https://tuansuapi.store/docs/video • Embeddings AI : https://tuansuapi.store/docs/embeddings • Hỗ trợ kỹ thuật 24/7 qua Telegram: @tuansu_28 ================================================================================ ## Kiểm tra số dư qua API [BALANCE_API_20261022] GET /v1/balance GET /v1/account/balance GET chỉ đọc, không trừ tiền. Xác thực bằng Authorization: Bearer hoặc X-Api-Key; không truyền key trên URL. Alias: /v1/account/balance. available_vnd là số khả dụng sau khi trừ reserved_vnd; balance_vnd là số dư trước khoản giữ chỗ. scope=wallet dùng chung giữa các key cùng ví. Key USDT có thêm available_usdt và balance_usdt (quy đổi 26.000 VND/USDT). unlimited=true trả số dư null, không phải 0. HTTP 401: key sai/không hoạt động; 403: bị khóa; 409: key không dùng số dư tiền; 503: tạm không đọc được số dư. updated_at là thời điểm kiểm tra. Không cache phản hồi. curl https://tuansuapi.store/v1/balance -H "Authorization: Bearer YOUR_API_KEY" { "object": "account.balance", "currency": "VND", "account_currency": "USDT", "scope": "key", "unlimited": false, "limit_vnd": 520000, "spent_vnd": 104000, "reserved_vnd": 26000, "balance_vnd": 416000, "available_vnd": 390000, "exchange_rate_vnd_per_usdt": 26000, "balance_usdt": 16, "available_usdt": 15, "requests": 120, "updated_at": "2026-10-22T13:00:00.000Z" } [customer-pricing-api-v1] TRA CỨU GIÁ MODEL QUA API GET https://tuansuapi.store/v1/pricing GET https://tuansuapi.store/v1/pricing?model=deepseek-v4.1-flash-1017 GET https://tuansuapi.store/v1/pricing?catalog=ohmyapis GET https://tuansuapi.store/v1/pricing?catalog=ohmyapis&model=gpt-6.1-sol Công khai, chỉ đọc, không cần API key, không trừ tiền. Mặc định: giá niêm yết Tuansu bằng VND; catalog=ohmyapis: public default-group prices in USD. Read currency, unit, minimum_per_request, prices.input_per_1m, output_per_1m, cache_read_per_1m, cache_write_per_1m, cache_write_1h_per_1m, context_tiers and top_up_offers. Fixed/media prices use price_per_request, duration_prices, price_per_second or price_per_unit. TTS uses price_per_1000_characters. Null is an unpublished separate rate, not free. Scope is public_catalog, personalized=false; private key discounts and offer eligibility/expiry are not evaluated here. Price reader cache: 10 seconds. HTTP 200 success; 400 invalid query; 404 unknown model; 405 use GET; 503 catalog unavailable. Never send an API key in query parameters. Docs: https://tuansuapi.store/docs#pricingApiSection [/customer-pricing-api-v1] QWEN EDIT UNCENSORED — IMAGE EDITING / CHỈNH SỬA ẢNH Model: qwen-edit-uncensored Price: $0.04 = 1.040 VND / successful request. One edited output image (n=1). POST /v1/images/edits or /v1/images/generations. A source image is REQUIRED. Send JSON image/image_url as an HTTPS image URL or complete data:image/...;base64,... URI. Multiple images: input_images or images arrays, up to 8. First image is the base. SDK upload: multipart image or image[] file parts. Each image <=8 MiB; multipart total <=12 MiB; JSON <=10 MiB. Masks are unsupported. Output follows source composition; size/quality do not set a new output resolution. Example JSON: {"model":"qwen-edit-uncensored","prompt":"Change the red circle to blue; keep the white background.","image":"data:image/png;base64,","n":1,"response_format":"b64_json"} Save the image by decoding data[0].b64_json. response_format=url returns an inline data URI. Missing image, n>1, unsupported masks and failed/empty outputs are not successful billable image requests.