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 API key của bạn.
🎁 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 YOUR_API_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.
Bảng giá mô hình
| Model | Vendor | Context | Chính hãng / 1M | OClaw / 1M |
|---|---|---|---|---|
Gemini 4 Argon NEW google / gemini-4-argon | — | Input: $2 Output: $10 | Input: $1.6 Output: $8 Tiết kiệm 20% | |
Gemini 3.8 Flash NEW google / gemini-3.8-flash | — | Input: $0.75 Output: $3.75 | Input: $0.75 Output: $3.75 | |
GPT-6 Astra NEW openai / gpt-6-astra | OpenAI | — | Input: $20 Output: $75 | Input: $16 Output: $60 Tiết kiệm 20% |
GPT-6 Sol NEW openai / gpt-6-sol | OpenAI | — | Input: $4 Output: $15 | Input: $3.2 Output: $12 Tiết kiệm 20% |
GPT-6.1 Sol NEW openai / gpt-6.1-sol | OpenAI | — | Input: $4 Output: $15 | Input: $3.2 Output: $12 Tiết kiệm 20% |
GPT-6 Luna NEW openai / gpt-6-luna | OpenAI | — | Input: $0.2 Output: $0.75 | Input: $0.16 Output: $0.6 Tiết kiệm 20% |
Claude Opus 5 5 NEW anthropic / claude-opus-5-5 | Anthropic | — | Input: $4 Output: $20 | Input: $3.84 Output: $19.2 Tiết kiệm 4% |
Claude Sonnet 5 5 NEW anthropic / claude-sonnet-5-5 | Anthropic | — | Input: $2 Output: $10 | Input: $1.92 Output: $9.6 Tiết kiệm 4% |
Claude Haiku 5.5 NEW anthropic / claude-haiku-5-5 | Anthropic | — | Input: $0.5 Output: $2.5 | Input: $0.48 Output: $2.4 Tiết kiệm 4% |
MiniMax M3 NEW minimax / MiniMax/MiniMax-M3 | MiniMax | — | Input: $0.6 Output: $2.4 | Input: $0.54 Output: $2.16 Tiết kiệm 10% |
DeepSeek V4.1 Flash NEW deepseek / deepseek-v4-1-flash-260910 | DeepSeek | — | Off peak Input: $0.14 Off peak Output: $0.56 Peak Input: $0.28 Peak Output: $1.12 | Off peak Input: $0.084 Off peak Output: $0.336 Peak Input: $0.168 Peak Output: $0.672 Tiết kiệm 40% |
GLM 5.3 NEW zhipu / glm-5.3 | Zhipu | — | Input: $1.4 Output: $4.4 | Input: $1.4 Output: $4.4 |
GPT Image 2.5 Sunburst NEW Hình ảnh openai / gpt-image-2.5-sunburst | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens Tiết kiệm 5% |
GPT Image 2.5 Flare NEW Hình ảnh openai / gpt-image-2.5-flare | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens Tiết kiệm 5% |
Gemini 3.5 Flash google / gemini-3.5-flash | — | Input: $1.5 Output: $9 | Input: $1.2 Output: $7.2 Tiết kiệm 20% | |
GPT-5.6 Sol openai / gpt-5.6-sol | OpenAI | — | Input: $8 Output: $30 | Input: $6.4 Output: $24 Tiết kiệm 20% |
GPT-5.6 Terra openai / gpt-5.6-terra | OpenAI | — | Input: $4 Output: $18 | Input: $3.2 Output: $14.4 Tiết kiệm 20% |
GPT-5.6 Luna openai / gpt-5.6-luna | OpenAI | — | Input: $0.4 Output: $1.8 | Input: $0.32 Output: $1.44 Tiết kiệm 20% |
Deepseek V4 Flash deepseek / deepseek-v4-flash | DeepSeek | — | Off peak Input: $0.22 Off peak Output: $0.66 Peak Input: $0.44 Peak Output: $1.32 | Off peak Input: $0.22 Off peak Output: $0.66 Peak Input: $0.44 Peak Output: $1.32 |
Deepseek V4 Pro deepseek / deepseek-v4-pro | DeepSeek | — | Off peak Input: $0.66 Off peak Output: $1.98 Peak Input: $1.32 Peak Output: $3.96 | Off peak Input: $0.66 Off peak Output: $1.98 Peak Input: $1.32 Peak Output: $3.96 |
Kimi K3 moonshot / kimi-k3 | Moonshot | — | Input: $3 Output: $15 | Input: $2.85 Output: $14.25 Tiết kiệm 5% |
Qwen3.7 Plus alibaba / qwen3.7-plus | Alibaba | — | Input: $1.2 Output: $4.8 | Input: $0.96 Output: $3.84 Tiết kiệm 20% |
Qwen3.7 Max alibaba / qwen3.7-max | Alibaba | — | Input: $2.5 Output: $7.5 | Input: $2 Output: $6 Tiết kiệm 20% |
Qwen3.8 Max alibaba / qwen3.8-max | Alibaba | — | Input: $2 Output: $6 | Input: $2 Output: $6 |
Glm 5.2 zhipu / glm-5.2 | Zhipu | — | Input: $1.12 Output: $3.92 | Input: $0.952 Output: $3.332 Tiết kiệm 15% |
Gemini 3 Pro Image Hình ảnh google / gemini-3-pro-image | Image | Input: $2 Output: $12 Image output: $120 | Input: $1.6 Output: $9.6 Image output: $96 Tiết kiệm 20% | |
Gemini 3.1 Flash Image Hình ảnh google / gemini-3.1-flash-image | Image | Input: $0.5 Output: $3 Image output: $60 | Input: $0.4 Output: $2.4 Image output: $48 Tiết kiệm 20% | |
Gpt Image 2 Hình ảnh openai / gpt-image-2 | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens Tiết kiệm 5% |
Doubao Seedream 4 5 251128 Hình ảnh bytedance / doubao-seedream-4-5-251128 | ByteDance | Image | Image: ¥0.25 / image | Image: ¥0.25 / image |
Seedance 2.0 Video bytedance / doubao-seedance-2-0-260128 | ByteDance | Video | 480p: ≈¥0.46 / giây 720p: ≈¥0.99 / giây | 480p: ≈¥0.45 / giây 720p: ≈¥0.96 / giây Tiết kiệm 3% |
Seedance 2.0 Fast Video bytedance / doubao-seedance-2-0-fast-260128 | ByteDance | Video | 480p: ≈¥0.37 / giây 720p: ≈¥0.80 / giây | 480p: ≈¥0.36 / giây 720p: ≈¥0.78 / giây Tiết kiệm 3% |
Seedance 2.0 Mini Video bytedance / doubao-seedance-2-0-mini-260615 | ByteDance | Video | 480p: ≈¥0.23 / giây 720p: ≈¥0.50 / giây | 480p: ≈¥0.22 / giây 720p: ≈¥0.49 / giây Tiết kiệm 3% |
Seedance 2.5 Video bytedance / doubao-seedance-2-5-260628 | ByteDance | Video | 480p: ≈¥0.67 / giây 720p: ≈¥1.51 / giây | 480p: ≈¥0.65 / giây 720p: ≈¥1.46 / giây Tiết kiệm 3% |
Grok Imagine Video Video xai / grok-imagine-video | xAI | Video | 480p: $0.05 / giây 720p: $0.07 / giây Reference image: $0.002 / image | 480p: $0.05 / giây 720p: $0.07 / giây Reference image: $0.002 / image |
Grok Imagine 1.5 Video Apimart Video xai / grok-imagine-1.5-video-apimart | xAI | Video | 480p: $0.05 / giây 720p: $0.07 / giây Reference image: $0.002 / image | 480p: $0.05 / giây 720p: $0.07 / giây Reference image: $0.002 / image |
Seedance 2.0 Mini (BytePlus) Video bytedance / seedance-2.0-mini | ByteDance | Video | 480p: $0.04 / giây 720p: $0.08 / giây | 480p: $0.0388 / giây 720p: $0.0776 / giây Tiết kiệm 3% |
Seedance 2.0 (BytePlus) Video bytedance / seedance-2.0 | ByteDance | Video | 480p: $0.07 / giây 720p: $0.15 / giây 1080p: $0.37 / giây 4k: $0.78 / giây | 480p: $0.0679 / giây 720p: $0.1455 / giây 1080p: $0.3589 / giây 4k: $0.7566 / giây Tiết kiệm 3% |
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.