Tài liệu tích hợp CadHayVN

Bắt đầu nhanh

Cài đúng thư viện theo ví dụ, dùng runtime được thư viện hỗ trợ và thiết lập STALI_API_KEY trong môi trường. Thay model mẫu bằng model hiện có phù hợp giao thức.

read -r -s -p "STALI_API_KEY: " STALI_API_KEY
export STALI_API_KEY
printf '\n'
curl -fsS https://api.cadhayvn.com/v1/models -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}"

Ví dụ cURL dùng Bash trên macOS/Linux hoặc WSL/Git Bash. Python sẽ hỏi key nếu chưa có STALI_API_KEY; Node.js đọc biến môi trường.

curl -N https://api.cadhayvn.com/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?Hãy đặt STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Viết hàm quicksort bằng Python" }
    ]
  }'

Các ví dụ tạo nội dung là lượt gọi thật và có thể phát sinh phí. Kiểm tra đơn vị tính và mức tối thiểu trước khi chạy.

Cài API CLI

Cần Node.js từ 18. Cài API CLI rồi chạy api-cli để nhập key trong wizard. Dùng api-cli doctor để kiểm tra cấu hình; yêu cầu chat hoặc ping vẫn có thể tính phí.

# Khuyến nghị (Win / macOS / Linux giống nhau) — cần Node.js >= 18
npm install -g stali-cli@latest

# Hoặc one-liner (npm bên trong; fallback GitHub+Bun nếu npm lỗi):
# curl -fsSL "https://api.cadhayvn.com/install/stali-cli.sh" | bash

# Chỉ cài, không mở wizard:
# curl -fsSL "https://api.cadhayvn.com/install/stali-cli.sh" | STALI_CLI_NO_RUN=1 bash

stali

Kết nối ứng dụng

Tìm hướng dẫn theo công cụ và giao thức.

Tạo video

Tạo video từ mô tả và ảnh, theo dõi tiến độ và tải MP4 qua Videos API.

Đọc hình ảnh

Kiểm tra định dạng và vòng đời tác vụ.

Tiêu đề phản hồi

Lưu x-cadhayvn-request-id nếu có và thời điểm lỗi để đối chiếu. Không gửi khóa API hoặc dữ liệu nhạy cảm trong báo lỗi.

Khắc phục sự cố

Tôn trọng Retry-After; dùng exponential backoff có jitter, giới hạn số lần và tổng thời gian thử lại. Với tác vụ video đã có thể được tạo, tra cứu ID trước để tránh yêu cầu trùng.