Hướng dẫn

Đưa mô hình Octer vào agent và code của bạn

Chỉ một API key: trỏ agent chạy máy bạn (OpenClaw / Hermes) sang mô hình của Octer, hoặc gọi thẳng API để trò chuyện, tạo ảnh và tạo video.

Bạn muốn làm gì?

Chưa biết chọn cái nào? Đa số chọn thẻ ở giữa — để agent tạo ảnh và video ngay trong khung chat, cách bắt đầu nhanh nhất. Chọn rồi vẫn đổi được bất cứ lúc nào.

AgentHệ điều hànhMô hình
1

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 →

Sau khi dán, mọi lệnh trên trang này sẽ dùng key thật của bạn — copy là chạy được ngay. Key chỉ nằm trong trang này, không được gửi đi và không được lưu; tải lại hoặc đóng tab là mất.

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ệ điều hành

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.

2

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.

AgentHệ điều hành

Bước 1 · Cài client

Kiểm tra CLI đã dùng được:

Bước 2 · Chuyển sang mô hình Octer

Mô hình

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.

3

Ả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ào videos/.
  • 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.
4

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.

Endpointhttps://oclaw.octer.ai/v1
Xác thựcAuthorization: Bearer sk-YOUR_KEY
Tác vụMô hình
💻 Mã ví dụ

5

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ạiMô hìnhmodel idGhi 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.

6

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.

Endpointhttps://oclaw.octer.ai/v1
Giao thứcTương thích OpenAI
API Keysk-YOUR_KEY
Mô hìnhgemini-3-flash-preview
7

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.

Tham gia & nhận Free Credits 🎁

Tham gia cộng đồng chính thức để trải nghiệm model sớm, sự kiện và tín dụng miễn phí.

DiscordCộng đồng lập trình viên toàn cầuWhatsAppNhóm người dùngThêm cộng đồng · sắp ra mắt