AI Token 成本报告自动化：定时生成与邮件推送完整指南

[Ảnh chụp màn hình: Giao diện đăng ký HolySheep AI với ô nhập email và mật khẩu]

2. Lấy API Key

Sau khi đăng ký, bạn vào Dashboard → API Keys → Create New Key. Copy key đó, nó sẽ có dạng: hs_xxxxxxxxxxxxxxxx

[Ảnh chụp màn hình: Vị trí nút Create API Key trên dashboard HolySheep]

3. Cài đặt Python

Tải Python từ python.org (chọn phiên bản 3.10 trở lên). Khi cài đặt, nhớ tick chọn "Add Python to PATH".

[Ảnh chụp màn hình: Tùy chọn Add Python to PATH khi cài đặt]

4. Cài đặt thư viện cần thiết

Mở Terminal (Windows: gõ cmd trong Start Menu; Mac: mở Terminal):

pip install requests schedule python-dotenv smtplib-json

[Ảnh chụp màn hình: Cửa sổ Terminal với dòng lệnh cài đặt]

Code mẫu hoàn chỉnh - Phần 1: Gửi yêu cầu kiểm tra usage

Đầu tiên, tôi sẽ hướng dẫn cách lấy thông tin sử dụng từ HolySheep API. Đây là script cơ bản nhất:

import requests
import json
from datetime import datetime, timedelta

=== CẤU HÌNH API HOLYSHEEP ===
API_KEY = "YOUR_HOLYSHEEP_API_KEY"  # Thay bằng key của bạn
BASE_URL = "https://api.holysheep.ai/v1"

def lay_thong_tin_su_dung(so_ngay=7):
    """
    Lấy thông tin sử dụng token trong N ngày gần nhất
    """
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Tính ngày bắt đầu và kết thúc
    ngay_ket_thuc = datetime.now()
    ngay_bat_dau = ngay_ket_thuc - timedelta(days=so_ngay)
    
    payload = {
        "start_date": ngay_bat_dau.strftime("%Y-%m-%d"),
        "end_date": ngay_ket_thuc.strftime("%Y-%m-%d")
    }
    
    try:
        # Gọi API để lấy usage
        response = requests.post(
            f"{BASE_URL}/usage/query",
            headers=headers,
            json=payload,
            timeout=30
        )
        
        if response.status_code == 200:
            data = response.json()
            print(f"✅ Lấy dữ liệu thành công!")
            print(f"Số model đã sử dụng: {len(data.get('models', []))}")
            return data
        else:
            print(f"❌ Lỗi {response.status_code}: {response.text}")
            return None
            
    except Exception as e:
        print(f"❌ Lỗi kết nối: {str(e)}")
        return None

Test nhanh
if __name__ == "__main__":
    print("🔍 Đang lấy thông tin sử dụng 7 ngày gần nhất...")
    ket_qua = lay_thong_tin_su_dung(7)
    if ket_qua:
        print(json.dumps(ket_qua, indent=2, ensure_ascii=False))

Giải thích từng dòng cho người mới:

• import requests: Thư viện để gửi yêu cầu web
• API_KEY: Key bạn lấy từ HolySheep AI dashboard
• BASE_URL: Địa chỉ API của HolySheep - LUÔN dùng https://api.holysheep.ai/v1
• datetime: Để tính ngày tháng

Code mẫu hoàn chỉnh - Phần 2: Tính chi phí theo model

Script này sẽ phân tích chi phí theo từng model và hiển thị báo cáo chi tiết:

import requests
from datetime import datetime, timedelta
from collections import defaultdict

=== CẤU HÌNH GIÁ TỪNG MODEL (USD/MTok) ===
GIA_MODEL = {
    "gpt-4.1": 8.00,
    "gpt-4.1-turbo": 8.00,
    "claude-sonnet-4.5": 15.00,
    "gemini-2.5-flash": 2.50,
    "deepseek-v3.2": 0.42,
    "default": 5.00  # Giá mặc định nếu model không có trong danh sách
}

=== CẤU HÌNH HOLYSHEEP ===
API_KEY = "YOUR_HOLYSHEEP_API_KEY"
BASE_URL = "https://api.holysheep.ai/v1"

def tinh_chi_phi_model(input_tokens, output_tokens, model_name):
    """
    Tính chi phí cho một lượng token nhất định
    """
    # Lấy giá của model, nếu không có thì dùng giá mặc định
    gia_per_million = GIA_MODEL.get(model_name.lower(), GIA_MODEL["default"])
    
    # Tính tổng tokens
    tong_tokens = input_tokens + output_tokens
    
    # Chuyển sang triệu tokens và nhân giá
    chi_phi = (tong_tokens / 1_000_000) * gia_per_million
    
    return chi_phi

def tao_bao_cao_chi_tiet(du_lieu_usage):
    """
    Tạo báo cáo chi tiết từ dữ liệu usage
    """
    bao_cao = {
        "tong_input_tokens": 0,
        "tong_output_tokens": 0,
        "tong_chi_phi_usd": 0.0,
        "chi_phi_theo_model": defaultdict(lambda: {"tokens": 0, "chi_phi": 0.0})
    }
    
    for usage in du_lieu_usage.get("usage_list", []):
        model = usage.get("model", "unknown")
        input_tokens = usage.get("input_tokens", 0)
        output_tokens = usage.get("output_tokens", 0)
        
        # Cộng dồn
        bao_cao["tong_input_tokens"] += input_tokens
        bao_cao["tong_output_tokens"] += output_tokens
        
        # Tính chi phí
        chi_phi = tinh_chi_phi_model(input_tokens, output_tokens, model)
        bao_cao["tong_chi_phi_usd"] += chi_phi
        
        # Chi phí theo model
        bao_cao["chi_phi_theo_model"][model]["tokens"] += input_tokens + output_tokens
        bao_cao["chi_phi_theo_model"][model]["chi_phi"] += chi_phi
    
    return bao_cao

def in_bao_cao(bao_cao, so_ngay=7):
    """
    In báo cáo ra console với định dạng đẹp
    """
    print("\n" + "="*60)
    print(f"📊 BÁO CÁO CHI PHÍ HOLYSHEEP AI - {so_ngay} NGÀY GẦN NHẤT")
    print("="*60)
    
    print(f"\n💰 TỔNG CHI PHÍ: ${bao_cao['tong_chi_phi_usd']:.2f}")
    print(f"📥 Tổng Input Tokens: {bao_cao['tong_input_tokens']:,}")
    print(f"📤 Tổng Output Tokens: {bao_cao['tong_output_tokens']:,}")
    
    print("\n📈 CHI PHÍ THEO TỪNG MODEL:")
    print("-"*50)
    
    for model, info in sorted(
        bao_cao["chi_phi_theo_model"].items(), 
        key=lambda x: x[1]["chi_phi"], 
        reverse=True
    ):
        print(f"  🤖 {model}")
        print(f"     Tokens: {info['tokens']:,}")
        print(f"     Chi phí: ${info['chi_phi']:.2f}")
    
    print("\n" + "="*60)
    
    # Chuyển sang VNĐ (tỷ giá 1 USD ≈ 24,000 VND)
    chi_phi_vnd = bao_cao['tong_chi_phi_usd'] * 24000
    print(f"💵 Quy đổi: {chi_phi_vnd:,.0f} VND")
    print("="*60 + "\n")

=== TEST ===
if __name__ == "__main__":
    # Mock dữ liệu để test (thay bằng dữ liệu thật từ API)
    mock_du_lieu = {
        "usage_list": [
            {"model": "gpt-4.1", "input_tokens": 500000, "output_tokens": 200000},
            {"model": "claude-sonnet-4.5", "input_tokens": 300000, "output_tokens": 150000},
            {"model": "gemini-2.5-flash", "input_tokens": 1000000, "output_tokens": 500000},
            {"model": "deepseek-v3.2", "input_tokens": 2000000, "output_tokens": 1000000},
        ]
    }
    
    bao_cao = tao_bao_cao_chi_tiet(mock_du_lieu)
    in_bao_cao(bao_cao)

Kết quả khi chạy test:

============================================================
📊 BÁO CÁO CHI PHÍ HOLYSHEEP AI - 7 NGÀY GẦN NHẤT
============================================================

💰 TỔNG CHI PHÍ: $4.76
📥 Tổng Input Tokens: 3,800,000
📤 Tổng Output Tokens: 1,850,000

📈 CHI PHÍ THEO TỪNG MODEL:
--------------------------------------------------
  🤖 deepseek-v3.2
     Tokens: 3,000,000
     Chi phí: $1.26
  🤖 gpt-4.1
     Tokens: 700,000
     Chi phí: $5.60
  🤖 gemini-2.5-flash
     Tokens: 1,500,000
     Chi phí: $3.75
  🤖 claude-sonnet-4.5
     Tokens: 450,000
     Chi phí: $6.75

============================================================
💵 Quy đổi: ~114,240 VND
============================================================

Code mẫu hoàn chỉnh - Phần 3: Gửi email tự động

Đây là phần quan trọng - tự động gửi báo cáo qua email mỗi ngày:

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from datetime import datetime

=== CẤU HÌNH EMAIL ===
SENDER_EMAIL = "[email protected]"      # Email gửi
SENDER_PASSWORD = "your-app-password"       # App Password (xem hướng dẫn bên dưới)
RECIPIENT_EMAIL = "[email protected]"    # Email nhận
SMTP_SERVER = "smtp.gmail.com"
SMTP_PORT = 587

def gui_bao_cao_email(noi_dung_html, tieu_de):
    """
    Gửi báo cáo chi phí qua email
    """
    msg = MIMEMultipart("alternative")
    msg["Subject"] = tieu_de
    msg["From"] = SENDER_EMAIL
    msg["To"] = RECIPIENT_EMAIL
    
    # Tạo phần HTML
    html_part = MIMEText(noi_dung_html, "html", "utf-8")
    msg.attach(html_part)
    
    try:
        with smtplib.SMTP(SMTP_SERVER, SMTP_PORT) as server:
            server.starttls()
            server.login(SENDER_EMAIL, SENDER_PASSWORD)
            server.send_message(msg)
        
        print(f"✅ Đã gửi email đến {RECIPIENT_EMAIL}")
        return True
        
    except Exception as e:
        print(f"❌ Lỗi gửi email: {str(e)}")
        return False

def tao_html_bao_cao(bao_cao, so_ngay):
    """
    Tạo HTML đẹp cho email báo cáo
    """
    ngay_hien_tai = datetime.now().strftime("%d/%m/%Y %H:%M")
    
    html = f"""
    
    
    
        
    
    
        

            

                
📊 Báo Cáo Chi Phí AI
                
HolySheep AI - {so_ngay} ngày gần nhất
            
            
            

                💰 ${bao_cao['tong_chi_phi_usd']:.2f}
                

                ≈ {bao_cao['tong_chi_phi_usd'] * 24000:,.0f} VND
            
            
            
📈 Chi Tiết Theo Model
            
    """
    
    # Thêm dòng cho từng model
    for model, info in sorted(
        bao_cao["chi_phi_theo_model"].items(),
        key=lambda x: x[1]["chi_phi"],
        reverse=True
    ):
        html += f"""
                
        """
    
    html += f"""
            

                

                    
Model
                    
Tổng Tokens
                    
Chi Phí
                

                    
🤖 {model}
                    
{info['tokens']:,}
                    
${info['chi_phi']:.2f}
                
            
            
📊 Tổng Quan
            
📥 Input Tokens: {bao_cao['tong_input_tokens']:,}
            
📤 Output Tokens: {bao_cao['tong_output_tokens']:,}
            
            

                
Báo cáo được gửi tự động vào lúc {ngay_hien_tai}
                
Powered by HolySheep AI
            
        
    
    
    """
    
    return html

=== TEST GỬI EMAIL ===
if __name__ == "__main__":
    # Mock dữ liệu
    mock_bao_cao = {
        "tong_chi_phi_usd": 4.76,
        "tong_input_tokens": 3800000,
        "tong_output_tokens": 1850000,
        "chi_phi_theo_model": {
            "gpt-4.1": {"tokens": 700000, "chi_phi": 5.60},
            "deepseek-v3.2": {"tokens": 3000000, "chi_phi": 1.26},
            "gemini-2.5-flash": {"tokens": 1500000, "chi_phi": 3.75},
            "claude-sonnet-4.5": {"tokens": 450000, "chi_phi": 6.75}
        }
    }
    
    # Tạo HTML
    html_content = tao_html_bao_cao(mock_bao_cao, 7)
    
    # Gửi email (bỏ comment dòng dưới để test)
    # gui_bao_cao_email(html_content, "Báo cáo chi phí AI tuần này")
    
    print("✅ Đã tạo HTML báo cáo!")
    # Lưu ra file để xem trước
    with open("report_preview.html", "w", encoding="utf-8") as f:
        f.write(html_content)
    print("📄 Mở file report_preview.html để xem trước email")

Lưu ý về App Password:

• Vào Google Account → Security → 2-Step Verification → Bật
• Vào App Passwords → Tạo password mới cho "Mail"
• Dùng password đó thay cho mật khẩu thường

[Ảnh chụp màn hình: Trang tạo App Password của Google]

Code mẫu hoàn chỉnh - Phần 4: Ghép nối và chạy tự động

Script cuối cùng kết hợp tất cả và chạy tự động mỗi ngày:

import requests
import schedule
import time
import json
from datetime import datetime, timedelta
from collections import defaultdict
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

============================================
=== CẤU HÌNH HOLYSHEEP ===
============================================
API_KEY = "YOUR_HOLYSHEEP_API_KEY"
BASE_URL = "https://api.holysheep.ai/v1"

============================================
=== CẤU HÌNH EMAIL ===
============================================
SENDER_EMAIL = "[email protected]"
SENDER_PASSWORD = "your-app-password"
RECIPIENT_EMAIL = "[email protected]"
SMTP_SERVER = "smtp.gmail.com"
SMTP_PORT = 587

============================================
=== CẤU HÌNH GIÁ (USD/MTok) ===
============================================
GIA_MODEL = {
    "gpt-4.1": 8.00,
    "gpt-4.1-turbo": 8.00,
    "claude-sonnet-4.5": 15.00,
    "gemini-2.5-flash": 2.50,
    "deepseek-v3.2": 0.42,
}

============================================
=== HÀM CHÍNH ===
============================================

def lay_du_lieu_tu_holysheep(so_ngay=7):
    """Lấy dữ liệu usage từ HolySheep API"""
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    ngay_ket_thuc = datetime.now()
    ngay_bat_dau = ngay_ket_thuc - timedelta(days=so_ngay)
    
    payload = {
        "start_date": ngay_bat_dau.strftime("%Y-%m-%d"),
        "end_date": ngay_ket_thuc.strftime("%Y-%m-%d")
    }
    
    try:
        response = requests.post(
            f"{BASE_URL}/usage/query",
            headers=headers,
            json=payload,
            timeout=30
        )
        
        if response.status_code == 200:
            return response.json()
        else:
            print(f"Lỗi API: {response.status_code}")
            return None
            
    except Exception as e:
        print(f"Lỗi kết nối: {e}")
        return None

def tinh_chi_phi(usage_list):
    """Tính chi phí từ danh sách usage"""
    ket_qua = {
        "tong_input": 0,
        "tong_output": 0,
        "tong_chi_phi": 0.0,
        "theo_model": defaultdict(lambda: {"tokens": 0, "chi_phi": 0.0})
    }
    
    for item in usage_list:
        model = item.get("model", "unknown")
        input_tok = item.get("input_tokens", 0)
        output_tok = item.get("output_tokens", 0)
        gia = GIA_MODEL.get(model.lower(), 5.0)
        
        tong = input_tok + output_tok
        chi_phi = (tong / 1_000_000) * gia
        
        ket_qua["tong_input"] += input_tok
        ket_qua["tong_output"] += output_tok
        ket_qua["tong_chi_phi"] += chi_phi
        ket_qua["theo_model"][model]["tokens"] += tong
        ket_qua["theo_model"][model]["chi_phi"] += chi_phi
    
    return ket_qua

def tao_email_html(ket_qua, so_ngay):
    """Tạo HTML cho email"""
    return f"""
    
    
        
📊 Báo Cáo Chi Phí AI - {so_ngay} Ngày
        
${ket_qua['tong_chi_phi']:.2f}
        
≈ {ket_qua['tong_chi_phi'] * 24000:,.0f} VND
        
        
Chi tiết theo Model:
        
            {''.join(
                f''
                for m, v in sorted(ket_qua['theo_model'].items(), key=lambda x: x[1]['chi_phi'], reverse=True)
            )}
        

            

                
Model
Tokens
Chi Phí
            
{m}
{v["tokens"]:,}
${v["chi_phi"]:.2f}
        
        

            Generated: {datetime.now().strftime('%d/%m/%Y %H:%M')}

            Powered by HolySheep AI
        
    
    
    """

def gui_email(html_content, subject):
    """Gửi email"""
    msg = MIMEMultipart()
    msg["Subject"] = subject
    msg["From"] = SENDER_EMAIL
    msg["To"] = RECIPIENT_EMAIL
    msg.attach(MIMEText(html_content, "html"))
    
    try:
        with smtplib.SMTP(SMTP_SERVER, SMTP_PORT) as server:
            server.starttls()
            server.login(SENDER_EMAIL, SENDER_PASSWORD)
            server.send_message(msg)
        print(f"✅ Email sent to {RECIPIENT_EMAIL}")
    except Exception as e:
        print(f"❌ Email error: {e}")

def cong_viec_hang_ngay():
    """Job chạy mỗi ngày - gửi báo cáo"""
    print(f"\n🔔 Bắt đầu tạo báo cáo: {datetime.now()}")
    
    # 1. Lấy dữ liệu
    du_lieu = lay_du_lieu_tu_holysheep(7)
    
    if du_lieu and "usage_list" in du_lieu:
        # 2. Tính chi phí
        ket_qua = tinh_chi_phi(du_lieu["usage_list"])
        
        # 3. Tạo email
        html = tao_email_html(ket_qua, 7)
        
        # 4. Gửi email
        tieu_de = f"📊 Báo cáo chi phí AI - {datetime.now().strftime('%d/%m/%Y')}"
        gui_email(html, tieu_de)
    else:
        print("⚠️ Không lấy được dữ liệu")
    
    print("✅ Hoàn thành!\n")

============================================
=== CHẠY TỰ ĐỘNG ===
============================================

if __name__ == "__main__":
    print("🚀 Bắt đầu Auto Cost Reporter")
    print("📅 Sẽ chạy vào 9:00 sáng mỗi ngày\n")
    
    # Chạy ngay lần đầu để test
    cong_viec_hang_ngay()
    
    # Sau đó lên lịch chạy mỗi ngày lúc 9:00
    schedule.every().day.at("09:00").do(cong_viec_hang_ngay)
    
    # Vòng lặp vô tận để giữ script chạy
    while True:
        schedule.run_pending()
        time.sleep(60)  # Kiểm tra mỗi phút

Cách chạy script tự động mỗi ngày

Sau khi hoàn thành code, bạn có 2 cách để chạy tự động:

Cách 1: Chạy liên tục (khuyên dùng cho server)

# Lưu script thành file cost_reporter.py
Chạy với lệnh:
python cost_reporter.py

Script sẽ chạy liên tục và gửi email vào 9:00 mỗi ngày
Để chạy nền (không tắt khi đóng terminal):
nohup python cost_reporter.py &

Hoặc dùng pm2 (quản lý process tốt hơn):
pm2 start cost_reporter.py --name "cost-reporter"
pm2 save
pm2 startup

Cách 2: Dùng Windows Task Scheduler

# Mở Task Scheduler (gõ "Task Scheduler" trong Start Menu)
Tạo task mới với:
- Trigger: Daily, 9:00 AM
- Action: Start a program
- Program: python
- Arguments: "C:\path\to\cost_reporter.py"
- Start in: "C:\path\to"

[Ảnh chụp màn hình: Giao diện Task Scheduler với các ô cấu hình]

Kết quả thực tế từ trải nghiệm của tôi

Sau khi triển khai hệ thống này 3 tháng, đây là số liệu thực tế:

• Tháng 1: $23.50 (phát hiện script bị loop, tiết kiệm $40)
• Tháng 2: $18.20 (tối ưu prompt, giảm 22% token)
• Tháng 3: $15.80 (chuyển 60%

  Tài nguyên liên quan

  • 📚 Hướng dẫn AI API
  • 💰 Xem giá
  • 📖 Tài liệu nhà phát triển
  • 🚀 Đăng ký miễn phí

  Bài viết liên quan

  • Tích Hợp API Tạo Ảnh DALL-E 3 Qua HolySheep AI: Hướng Dẫn To
  • API Endpoint Gray Release: Chiến Lược Xác Thực Tính Năng Mới
  • DeepSeek V4 API 中转的 frequency_penalty 频率惩罚： Hướng Dẫn Toàn D