Trước khi bắt đầu: lấy API key
Mọi thứ bên dưới — agent, tạo ảnh, tạo video, gọi API trực tiếp — đều dùng chung một key này.
- Mở bảng điều khiển Octer: octer.ai/workspace/o/ → (chưa có tài khoản thì đăng ký trước)
- Ở trang OClaw, bấm sao chép để lấy key bắt đầu bằng
sk-.
🎁 Người dùng mới đăng ký / đăng nhập được tặng điểm dùng thử — lấy key là chạy thử miễn phí ngay, nạp tiền tính sau. Đăng ký nhận điểm →
Dành một giây kiểm tra key có chạy không (chọn hệ điều hành của bạn trước rồi sao chép — nhận về JSON nghĩa là key lẫn mạng đều ổn):
Hãy thay sk-YOUR_KEY trong mọi câu lệnh bên dưới bằng key của chính bạn.
Không thấy JSON trả về, hoặc gặp 401 / 403? "Xử lý sự cố →" có cách giải quyết cho từng trường hợp.
Kết nối agent của bạn
OpenClaw và Hermes đều là 'trợ lý AI cục bộ' miễn phí, mã nguồn mở — cài trên máy của bạn và trò chuyện qua terminal. Chưa cài cũng không sao, bước 1 bên dưới sẽ hướng dẫn từ đầu.
Chọn agent và hệ điều hành bạn dùng — mọi câu lệnh bên dưới sẽ tự đổi theo.
Bước 1 · Cài client
Kiểm tra CLI đã dùng được:
Bước 2 · Chuyển sang mô hình Octer
Script sẽ ghi sẵn địa chỉ endpoint, API key và mô hình, khởi động lại gateway rồi gửi thử một câu “chào” — mô hình trả lời bình thường là xong.
Bước 3 · Kiểm tra lại
Chạy lần lượt hai lệnh sau:
Đổi ý? Hoàn tác ngay
Câu lệnh này xóa phần cấu hình mô hình Octer và giữ nguyên mọi thiết lập còn lại của bạn.
Ảnh & video
Bước trên mới chỉ lo phần trò chuyện. Muốn agent tạo được cả ảnh và video, hãy thêm skill oclaw — một CLI nhỏ gói cả ba khả năng lại, lưu thẳng file tạo ra về máy bạn.
Cách dễ nhất: dán câu này vào khung chat OpenClaw / Hermes, agent sẽ tự cài.
Chưa cài OpenClaw / Hermes? Xem mục "Kết nối agent →" — hai lệnh là xong. Không dùng agent? Dùng cách chạy trong terminal bên dưới.
Nhớ thay bằng key của chính bạn. Cài xong, chỉ cần nói kiểu bình dân “tạo cho tôi một tấm ảnh…” hay “làm một video về…” — agent sẽ tự lo phần còn lại.
Bạn cũng có thể dùng ngay trong terminal (không cần gì ngoài Python 3):
Trên Windows: công cụ này là script bash — hãy chạy trong WSL hoặc Git Bash (không chạy trực tiếp trong PowerShell được).
- Ảnh được lưu vào
images/, còn video vàovideos/. - Video chạy bất đồng bộ: thường mất 1–3 phút, và CLI sẽ tự chờ rồi tải về cho bạn. Nếu hết thời gian chờ cũng không mất gì — tác vụ vẫn đang chạy trên máy chủ. Chạy
./oclaw.sh statusđể tìm task id, rồi./oclaw.sh watch <task-id>. - Link video hết hạn sau khoảng 24 giờ, nên hãy tải về ngay khi tác vụ hoàn tất. CLI đã làm sẵn việc này — nếu tự gọi API, đừng chỉ lưu mỗi đường link.
Gọi API trực tiếp
Không cần agent — muốn đưa Octer vào chương trình của riêng bạn, cứ gọi thẳng HTTP API. Gateway tương thích giao thức OpenAI, nên SDK chính thức chỉ cần đổi base_url là chạy được.
Mô hình
model id là thứ bạn điền vào lời gọi API hoặc cấu hình agent — chính là chuỗi được tô nền trong bảng, bấm nút bên cạnh để sao chép một chạm.
| Loại | Mô hình | model id | Ghi chú |
|---|
Đổi qua lại giữa các mô hình cùng loại chỉ là đổi model id. Trò chuyện và suy luận dùng chung một endpoint; tạo ảnh và tạo video có endpoint riêng — các đoạn code phía trên sẽ tự đổi theo mô hình bạn chọn.
Cấu hình thủ công
Bất kỳ client nào hỗ trợ giao thức OpenAI đều kết nối được tới Octer với bốn thông số sau.
Cách dùng khác
Hai cách dùng còn lại được gom ở đây — cùng một key dùng được cho tất cả, cần thì mở ra xem.
Xử lý sự cố
Về dữ liệu của bạn: prompt và ảnh tham chiếu được gửi tới gateway Octer để tạo kết quả; API key chỉ đi trong header của request và không bao giờ được ghi xuống đĩa; ảnh và video tạo ra chỉ nằm trên máy của bạn.