Thông tin kết nối Dùng cho ứng dụng của bạn
Sao chép hai giá trị dưới đây vào ứng dụng cần kết nối.
Model:
muse-spark (chat / code), muse-image (ảnh), muse-video (video).
Xem ví dụ đầy đủ trong tab “Hướng dẫn API”.
Tổng tài khoản
0
Sẵn sàng
0
Gặp lỗi
0
Đã tắt
0
Tệp đã tạo
0
Thêm tài khoản Có thể nhập nhiều tài khoản
Dán Cookie của muse.ai vào đây. Mỗi dòng nhập một tài khoản; có thể thêm tên theo dạng
tên | Cookie.
Danh sách tài khoản 0
Tự làm mới phiên (30 phút)Phiên đăng nhập được tự làm mới định kỳ. Chọn “Kiểm tra” để xác minh tài khoản trên muse.ai.
| Tên | ID | Trạng thái | Phiên hết hạn | Hạn mức | Hoạt động | Cookie | Dùng gần nhất | Ghi chú | Thao tác |
|---|---|---|---|---|---|---|---|---|---|
| Đang tải… | |||||||||
Cách nhanh nhất: tiện ích trình duyệt Khuyên dùng
Dùng tiện ích để chuyển phiên đăng nhập muse.ai từ trình duyệt của bạn sang dịch vụ. Không cần dùng dòng lệnh.
1
1. Tải tiện ích
Tải và giải nén vào một thư mục dễ tìm.
⬇ Tải tiện ích trình duyệt
2
2. Nạp tiện ích vào trình duyệt
Chrome, Edge và các trình duyệt tương thích Chromium đều dùng được:
- Mở
chrome://extensions - Bật Chế độ dành cho nhà phát triển
- Chọn Tải tiện ích đã giải nén
- Chọn thư mục đã giải nén ở bước 1
3
3. Đăng nhập và nhập tài khoản
Đăng nhập
https://muse.ai/, sau đó mở tiện ích ngay trên trang này. Địa chỉ dịch vụ và API key sẽ tự điền; bạn chỉ cần chọn “Lấy Cookie và thêm tài khoản”.
Cách khác: nhập Cookie thủ công Nâng cao
Nếu không dùng tiện ích, hãy lấy Cookie trong công cụ dành cho nhà phát triển của trình duyệt.
Chọn tab Network, sao chép dòng
cookie: trong Request Headers.
- Mở và đăng nhập
https://muse.ai/ - Nhấn F12, chọn tab Network
- Nhấn F5 để tải lại trang
- Chọn một yêu cầu tới muse.ai
- Trong Headers → Request Headers, tìm dòng
cookie: - Sao chép toàn bộ nội dung sau dấu hai chấm, bắt đầu từ
hatch_sess= - Dán Cookie vào ô nhập bên dưới
Lưu ý: sao chép dòng
cookie: trong Request Headers, không dùng set-cookie trong Response Headers.
Nhập Cookie hoặc dùng script
Dán Cookie đã sao chép vào đây để nhập.
Hoặc dùng script Python để đăng nhập bằng cửa sổ trình duyệt riêng. Không cần cài thêm thư viện.
Sao chépĐang tạo lệnh…
③ Đăng nhập muse.ai trong cửa sổ bật lên. Script sẽ tự gửi Cookie rồi đóng cửa sổ.
Thời hạn Cookie Tham khảo
Thời hạn tham khảo; có thể khác nhau tùy tài khoản.
| Cookie | httpOnly | Thời hạn | Vai trò |
|---|---|---|---|
| hatch_sess | Có | Khoảng 30 ngày | Phiên đăng nhập chính |
| hatch_gw | Có | Khoảng 1 năm | Token gateway |
| hatch_vml | Có | Khoảng 2 ngày | Token ngắn hạn, quyết định thời hạn phiên |
| hatch_native_auth_device | Có | Khoảng 30 ngày | Mã thiết bị |
Thời hạn phiên thường phụ thuộc vào
hatch_vml (khoảng 2 ngày) và không tự kéo dài khi sử dụng.
Khi phiên hết hạn hoặc tài khoản báo lỗi, hãy đăng nhập lại và nhập Cookie mới.
Tác vụ đã chạy 0
Tác vụ video chạy nền và cập nhật trạng thái tự động.
| Mã tác vụ | Loại | Mô tả | Trạng thái | Thời gian | Ngày tạo | Kết quả / lỗi | |
|---|---|---|---|---|---|---|---|
| Đang tải… | |||||||
Thư viện tệp 0
Ảnh và video đã tạo. Bạn có thể xem, tải xuống hoặc dùng liên kết trong ứng dụng khác.
Đang tải…
Tạo ảnh thử POST /v1/images/generations
Gửi yêu cầu tạo ảnh thật tới muse.ai; thường mất 10–30 giây.
Tạo video thử POST /v1/videos
Tác vụ chạy nền, thường mất 60–120 giây. Trang sẽ tự cập nhật tiến độ.
Hướng dẫn kết nối
API tương thích OpenAI. Trong ứng dụng của bạn, chỉ cần đổi
Địa chỉ API:
base_url và api_key.
Địa chỉ API:
—
1. Model khả dụng
| Mã model | Chức năng | Endpoint |
|---|---|---|
| muse-spark | Chat / lập trình (có streaming) | POST /v1/chat/completions POST /v1/responses |
| muse-image | Tạo ảnh / chỉnh sửa ảnh | POST /v1/images/generations |
| muse-video | Tạo video / video từ ảnh | POST /v1/videos → GET /v1/videos/{id} |
Các model Muse có chức năng tương ứng: Muse Spark (chat / lập trình), Muse Image (tạo ảnh),
Muse Video (tạo video). Trang muse.ai tự chọn model, nên các tên phổ biến như
gpt-4o, claude-sonnet-4 hoặc dall-e-3 sẽ được ánh xạ tự động.
2. Chat / lập trình
Sao chép# Không streaming curl -X POST "BASE/v1/chat/completions" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"muse-spark","messages":[{"role":"user","content":"Viết thuật toán quicksort bằng Python"}]}' # Streaming: thêm "stream":true để nhận SSE chuẩn
3. Tạo ảnh (curl)
Sao chépcurl -X POST "BASE/v1/images/generations" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"Một chú chó Shiba đội mũ phi hành gia","size":"1:1","response_format":"url"}' # Kết quả {"created":1790148495,"data":[{ "revised_prompt":"Một chú chó Shiba đội mũ phi hành gia", "url":"http://your-server:18610/v1/media/xxxx.webp", "kind":"image","bytes":23860}]} # url là địa chỉ đầy đủ để hiển thị/tải; /v1/media/* không cần xác thực. # Để nhận base64, đặt "response_format":"b64_json".
4. Tạo video (curl, chạy nền)
Sao chép# ① Tạo tác vụ curl -X POST "BASE/v1/videos" \ -H "Authorization: Bearer $MUSE2API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"Một chú mèo đi trên bãi cỏ","duration":5,"size":"16:9"}' # → {"id":"task_xxx","status":"queued"} # ② Kiểm tra kết quả curl "BASE/v1/videos/task_xxx" -H "Authorization: Bearer $MUSE2API_KEY" # → {"status":"succeeded","result":{"url":"/v1/media/xxx.mp4"}}
5. Python (tương thích OpenAI SDK)
Sao chépfrom openai import OpenAI import time client = OpenAI(base_url="BASE/v1", api_key="m2a_...") # Tạo ảnh r = client.images.generate(model="muse-image", prompt="Một chú chó Shiba đội mũ phi hành gia") print(r.data[0].url) # Tạo video (dùng API riêng vì tác vụ chạy nền) import requests t = requests.post("BASE/v1/videos", json={"prompt":"Mèo đang đi","duration":5}, headers={"Authorization":"Bearer m2a_..."}).json() while True: s = requests.get(f"BASE/v1/videos/{t['id']}", headers={"Authorization":"Bearer m2a_..."}).json() if s["status"] in ("succeeded","failed"): break time.sleep(5) print(s)
6. API quản trị
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
| GET | /admin/status | Tổng quan dịch vụ, tài khoản và tác vụ |
| GET | /admin/accounts | Danh sách tài khoản |
| POST | /admin/accounts | Thêm một hoặc nhiều tài khoản |
| PATCH | /admin/accounts/{id} | Đổi tên hoặc bật / tắt |
| DELETE | /admin/accounts/{id} | Xóa tài khoản |
| POST | /admin/accounts/{id}/test | Kiểm tra phiên đăng nhập và hạn mức |
| POST | /admin/accounts/{id}/quota | Đọc hạn mức còn lại |
| POST | /admin/accounts/{id}/cookies | Cập nhật Cookie |
| GET | /admin/tasks | Lịch sử tác vụ |
| GET | /admin/media | Danh sách tệp đã tạo |
| POST | /admin/media/delete | Xóa nhiều tệp cùng lúc |
7. Xác thực
Ngoại trừ
/healthz, /readyz và /v1/media/*, các API khác cần
Authorization: Bearer <API Key>. Cấu hình key trong MUSE2API_KEY ở file `.env`.
8. Kết nối ứng dụng và agent
Ứng dụng hỗ trợ endpoint tương thích OpenAI chỉ cần ba thông tin sau:
| Thông tin | Giá trị |
|---|---|
| Địa chỉ API | http://<IP-hoặc-tên-miền>:18610/v1 |
| API key | m2a_... (hiển thị ở đầu trang) |
| Model | muse-spark |
Có thể dùng nhiều tên model: các tên thông dụng (
gpt-4o, gpt-5,
claude-sonnet-4, deepseek-chat, gemini-2.5-pro)
được ánh xạ tự động; muse.ai sẽ chọn khả năng phù hợp.
Khả năng tương thích
| Loại ứng dụng | API sử dụng | Trạng thái |
|---|---|---|
| Ứng dụng chat / giao diện web | POST /v1/chat/completions | ✅ Dùng được |
| Phản hồi streaming | stream:true (SSE) | ✅ Dùng được |
| Gợi ý mã | POST /v1/chat/completions | ✅ Dùng được |
| Dịch / tóm tắt / giải thích | POST /v1/chat/completions | ✅ Dùng được |
| Ứng dụng tạo ảnh | POST /v1/images/generations | ✅ Dùng được |
| Ứng dụng tạo video | POST /v1/videos (kiểm tra trạng thái) | ✅ Dùng được |
| Agent cần gọi công cụ | tool_calls / function calling | ⚠️ Chưa hỗ trợ |
Giới hạn về tool calling: Muse chưa hỗ trợ tạo lời gọi công cụ. Agent cần tự đọc/ghi tệp hoặc chạy lệnh chưa dùng được.
Chat, lập trình, dịch, tóm tắt, tạo ảnh và video vẫn hoạt động. Nếu gửi trường
tools, API sẽ bỏ qua và xử lý như hội thoại thông thường.