Công cụ dòng lệnh chính thức

ZOOOP AI CLI: tạo hình ảnh, video và âm thanh ngay từ terminal

Chỉ một gói npm là terminal của bạn có thể dùng hơn 70 mô hình AI, gồm GPT Image, Nano Banana, Seedance, Kling và ElevenLabs. Đăng nhập qua trình duyệt, rồi báo giá, chạy và tải kết quả về chỉ bằng một lệnh, hoặc viết script để chạy trong CI.

Bắt đầu
npx zooop login
Nhập mã hiển thị trong terminal của bạn

macOS, Linux và Windows · Node.js 18 trở lên · không cần thư viện phụ thuộc nào khác

~/launch -- zsh
$npx zooop login
To log in, open this page in a browser:
https://zooop.ai/cli/login?code=QBKF-7XRM
Opened your browser.
Logged in as you@studio.com
$zooop run --template superhero-movie-poster \
-p 'image_urls=["@me.jpg"]' -p hero_name=NOVA
Uploading me.jpg...
[3s] running
[41s] succeeded (11 credits)
/home/you/8c2f41d7-5b1e-4a6f-9d3c-2e7b0a9f6c14.png
$
Poster phim siêu anh hùng tạo từ terminal bằng ZOOOP CLI
8c2f41d7-5b1e-4a6f-9d3c-2e7b0a9f6c14.png

Chạy các mô hình bạn vẫn đang dùng

  • GPT Image 2.5
  • Nano Banana 2.1
  • Seedream 5.0
  • Midjourney V8.2
  • Seedance 2.5
  • Kling
  • Wan 3.0
  • Vidu Q4
  • MiniMax H3
  • Gemini Omni
  • Grok Imagine
  • ElevenLabs
mô hình AI
70+
loại nội dung
3
lệnh để đăng nhập
1
thư viện phụ thuộc thêm
0

Mọi mô hình hàng đầu, chỉ một lệnh

CLI đọc trực tiếp danh mục ZOOOP, nên mô hình hình ảnh, video và âm thanh mới dùng được ngay trong ngày ra mắt. Không cần cập nhật.

$zooop models --type video

Sinh ra cho terminal và script

Mọi lệnh đều có --json, stdout sạch để dùng với pipe, tiến trình in ra stderr và exit code có ý nghĩa rõ ràng. Đưa thẳng vào shell script, Makefile hoặc job CI.

$zooop tasks --json | jq .tasks[0].status

Credit trả theo mức dùng

Mỗi lần tạo được trừ vào số dư ZOOOP của bạn. Không cần đăng ký gói, credit không bao giờ hết hạn, và bạn thấy giá chính xác trước khi chạy bất cứ thứ gì.

$zooop quote --template claymation-me

Bạn có thể tạo gì

Mọi thứ API công khai của ZOOOP cung cấp, cộng thêm các mẫu một chạm trong thư viện và các công cụ AI chuyên dụng như xóa nền và nâng độ phân giải.

Hình ảnh

Văn bản thành hình ảnh, hình ảnh thành hình ảnh, chỉnh sửa bằng prompt, inpainting, xuất vector SVG, nâng độ phân giải và xóa nền.

Video

Văn bản thành video, làm ảnh tĩnh chuyển động, nội suy khung hình đầu/cuối, sao chép chuyển động, đồng bộ môi, kéo dài video và đổi phong cách.

Âm thanh

Chuyển văn bản thành giọng nói với giọng tùy chọn, nhân bản giọng nói từ mẫu, hiệu ứng âm thanh và trọn bản nhạc.

Danh sách mô hình được đọc trực tiếp từ danh mục, nên mô hình ra mắt hôm nay dùng được ngay trong ngày. Xem tất cả mô hình.

Mỗi mẫu chỉ cách bạn một lệnh

Các mẫu một chạm trong thư viện cũng chạy được từ terminal. zooop templates show cho biết mẫu cần những đầu vào nào, còn zooop run --template tạo kết quả từ ảnh của bạn.

Bắt đầu trong ba bước

Khoảng hai phút. Bạn cần một terminal và một tài khoản ZOOOP.

  1. 1

    Cài đặt CLI

    Cài đặt toàn cục bằng trình quản lý gói của bạn, hoặc chạy khi cần bằng npx. Chỉ cần Node.js 18 trở lên, không cần gì khác.

    npm install -g zooop
    zooop --help

    Cài lệnh zooop cho tài khoản người dùng của bạn.

  2. 2

    Đăng nhập qua trình duyệt

    zooop login hiển thị một mã ngắn và mở zooop.ai/cli/login. Kiểm tra trình duyệt hiển thị đúng mã đó, chọn tài khoản và dự án, rồi nhấn Ủy quyền. Không cần sao chép hay dán khóa nào.

    Tạo khóa API cho CI

    Chỉ phê duyệt mã do chính bạn khởi tạo. Bạn có thể thu hồi khóa bất cứ lúc nào trên trang khóa API hoặc bằng zooop logout.

    zooop login

    Mở trình duyệt mặc định của bạn. Khóa chỉ được lưu trên máy tính này, trong một tệp chỉ bạn đọc được.

  3. 3

    Tạo kết quả đầu tiên

    Tìm mô hình, xem giá rồi chạy. CLI sẽ chờ kết quả và lưu vào thư mục hiện tại.

    Lần chạy đầu tiên
    zooop models --type image --subtype default
    zooop quote --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"
    zooop run --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"

Đăng nhập bằng trình duyệt, không cần dán khóa

zooop login hiển thị một mã ngắn và mở zooop.ai/cli/login. Kiểm tra hai mã khớp nhau rồi phê duyệt, thế là CLI đã đăng nhập. Khóa không bao giờ đi qua bộ nhớ tạm của bạn.

$ zooop login
code:
QBKF-7XRM

Terminal hiển thị mã dùng một lần

zooop.ai/cli/login
QBKF-7XRM
Ủy quyền

Trình duyệt hiển thị đúng mã đó. Hãy phê duyệt

Đã đăng nhập

CLI đã đăng nhập và lưu khóa ngay trên máy

Danh sách lệnh

Mọi lệnh đều nhận --json và -h. Thêm --help vào bất kỳ lệnh nào để xem toàn bộ tùy chọn của lệnh đó.

zooop login

Đăng nhập qua trình duyệt và lưu khóa cho máy tính này.

zooop login
zooop whoami

Hiển thị tài khoản, dự án, số dư credit và thời hạn của khóa.

zooop whoami
zooop models

Liệt kê mô hình cùng phiên bản, đầu vào và giá tham khảo.

zooop models --type video --subtype text-ref
zooop templates

Duyệt các mẫu trong thư viện và xem mỗi mẫu cần đầu vào gì.

zooop templates show <slug>
zooop tools

Liệt kê các công cụ AI như xóa nền và nâng độ phân giải.

zooop tools
zooop quote

Báo giá một yêu cầu mà không cần chạy.

zooop quote --model <id> --version <id> -p prompt="..."
zooop run

Gửi yêu cầu, chờ kết quả và tải về. Tệp trên máy được tải lên tự động.

zooop run --template <slug> -p image_url=@photo.jpg
zooop tasks

Liệt kê tác vụ gần đây, xem hoặc chờ một tác vụ, hoặc hủy khi tác vụ còn đang xếp hàng.

zooop tasks get <task-id> --wait
zooop upload

Tải lên tệp hình ảnh, video hoặc âm thanh và in ra URL của tệp.

zooop upload ./clip.mp4
zooop describe

Chuyển một hình ảnh thành prompt có thể dùng lại (1 credit).

zooop describe @./reference.jpg
zooop logout

Thu hồi khóa đã lưu trên máy chủ và xóa khóa khỏi máy.

zooop logout

Ví dụ

Sao chép một lệnh, thay ID mô hình bằng một ID lấy từ zooop models, rồi chạy.

Văn bản thành hình ảnh

Tạo một khung hình màn ảnh rộng và lưu vào ./renders.

zooop run --model <model-id> --version <version-id> \
-p prompt="a neon-lit rainy Tokyo alley, cinematic" \
-p aspect_ratio=16:9 --out ./renders

Hình ảnh thành video

Làm một ảnh trên máy chuyển động. Tệp được tải lên trước; tên các đầu vào lấy từ zooop models.

zooop run --model <model-id> --version <version-id> \
-p prompt="slow push-in, hair moving in the wind" \
-p image_url=@./portrait.jpg -p duration=5

Chạy một mẫu trong thư viện

Chọn một mẫu và đưa ảnh của bạn vào.

zooop templates --type video
zooop run --template <slug> -p 'image_urls=["@./me.jpg"]' --out ./results

Chạy hàng loạt bằng script

Xếp hàng nhiều prompt cùng lúc và thu thập ID tác vụ bằng jq.

for subject in "red fox" "snow owl" "arctic hare"; do
zooop run --model <model-id> --version <version-id> \
-p prompt="$subject, studio photo" --no-wait --json | jq -r .taskId
done
zooop tasks --status running

An toàn ngay từ mặc định

CLI tiêu credit thật, nên rất cẩn thận với khóa và tiền.

Không có khóa trong lịch sử shell
Đăng nhập qua trình duyệt giao khóa trực tiếp cho CLI. Không phải dán gì cả, và khóa được lưu trong một tệp chỉ bạn đọc được.
Mỗi khóa đều có giới hạn
Mỗi khóa CLI hết hạn sau 30, 90 hoặc 365 ngày, chỉ gắn với một dự án, và có thể kèm giới hạn credit hằng ngày do bạn đặt khi phê duyệt.
Biết giá trước
zooop quote cho biết chính xác số credit và thời gian ước tính trước khi bạn chạy bất cứ thứ gì.
Chạy lại không bị trừ tiền hai lần
Mỗi lần chạy đều kèm một khóa idempotency, nên chạy lại cùng một lệnh trong vòng 24 giờ sẽ trả về tác vụ đã có thay vì tính phí lần nữa.

Câu hỏi thường gặp

ZOOOP AI CLI là gì?

Một ứng dụng dòng lệnh miễn phí của ZOOOP. Nó giúp bạn tạo hình ảnh, video và âm thanh bằng AI từ terminal hoặc script, với cùng các mô hình và credit như ứng dụng web.

Cần gì để chạy được?

Node.js 18.17 trở lên trên macOS, Linux hoặc Windows, và một tài khoản ZOOOP. Gói này không có thư viện phụ thuộc nào khác.

Tôi dùng được những mô hình nào?

Mọi mô hình trên API công khai của ZOOOP: mô hình hình ảnh như GPT Image và Nano Banana, mô hình video như Seedance, Kling và Wan, cùng các mô hình âm thanh cho giọng nói, nhân bản giọng nói, hiệu ứng âm thanh và âm nhạc. Chạy zooop models để xem danh sách mới nhất.

Chi phí bao nhiêu?

Bản thân CLI miễn phí. Mỗi lần tạo tốn số credit giống như trên trang web, và zooop quote cho biết giá chính xác trước khi bạn chạy.

Có dùng được trong CI hoặc script không?

Có. Đặt ZOOOP_API_KEY thay vì đăng nhập, thêm --json để có đầu ra máy đọc được, và kiểm tra exit code: 0 là thành công, 1 là lỗi API hoặc tác vụ thất bại, 2 là dùng sai lệnh.

Làm sao để đăng xuất hoặc thu hồi quyền truy cập?

Chạy zooop logout để thu hồi khóa và xóa khóa khỏi máy tính, hoặc thu hồi khóa trên trang khóa API. Khóa đã thu hồi sẽ ngừng hoạt động ở mọi nơi.

CLI khác gì so với kỹ năng agent của ZOOOP?

CLI là dành cho bạn: tự gõ lệnh, hoặc gọi lệnh từ script của riêng bạn. Còn kỹ năng agent dạy một AI agent như Claude Code hoặc Codex dùng ZOOOP ngay trong cuộc trò chuyện.

Tài nguyên

Tạo ngay từ terminal

Tạo tài khoản miễn phí, rồi chạy npx zooop login.

$npx zooop login