Tổng quan
Trạng thái dịch vụ và thông tin kết nối.
Kết nối
Tương thích OpenAI APImuse-spark chat/code · muse-image ảnh · muse-video video
Hệ thống
- Dịch vụ
- —
- Trình duyệt
- —
- Làm mới phiên
- —
- Phiên bản
- —
Tác vụ gần đây
Xem tất cả| Đang tải… |
Tài khoản
Phiên đăng nhập được tự làm mới mỗi 15 phút.
| Tài khoản | Trạng thái | Phiên | Hạn mức | Dùng gần nhất | Ghi chú | Thao tác |
|---|---|---|---|---|---|---|
| Đang tải… | ||||||
Tác vụ
Lịch sử tạo ảnh và video. Tác vụ đang chạy được cập nhật tự động.
| Mã | Loại | Mô tả | Trạng thái | Thời gian | Tạo lúc | Kết quả | Thao tác |
|---|---|---|---|---|---|---|---|
| Đang tải… | |||||||
Thư viện
Ảnh và video đã tạo. Liên kết /v1/media/* truy cập được mà không cần key.
Playground
Gửi request thật qua API để kiểm tra tài khoản và cấu hình.
Chat
POST /v1/chat/completions · streamTạo ảnh
POST /v1/images/tasksThường mất 10–30 giây.
Tạo video
POST /v1/videosChạy nền, thường mất 60–120 giây. Có thể rời trang và xem kết quả trong Tác vụ.
Tài liệu API
Đổi base_url và api_key trong client OpenAI là dùng được.
Bắt đầu
| Base URL | — |
| Xác thực | Authorization: Bearer <API key> |
| Model | muse-spark · muse-image · muse-video |
Các tên model phổ biến như gpt-4o, claude-sonnet-4, dall-e-3, sora được ánh xạ tự động sang model tương ứng.
/healthz, /readyz và /v1/media/* không yêu cầu key.
Chat
curl /v1/chat/completions \
-H "Authorization: Bearer $MUSE2API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"muse-spark","stream":true,"messages":[{"role":"user","content":"Hello"}]}'Bỏ "stream":true để nhận một response JSON duy nhất. Cũng hỗ trợ POST /v1/responses.
Tạo ảnh
curl /v1/images/generations \
-H "Authorization: Bearer $MUSE2API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"a shiba inu astronaut","size":"1:1","response_format":"url"}'
# {"created":1790148495,"data":[{"url":"/v1/media/xxxx.webp","kind":"image","bytes":23860}]}
# "response_format":"b64_json" để nhận base64Sửa ảnh: POST /v1/images/edits (multipart). Chạy nền: POST /v1/images/tasks → GET /v1/images/tasks/{id}.
Tạo video
# 1. Tạo tác vụ
curl /v1/videos \
-H "Authorization: Bearer $MUSE2API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"a cat walking on grass","duration":5,"size":"16:9"}'
# {"id":"task_xxx","status":"queued"}
# 2. Kiểm tra trạng thái
curl /v1/videos/task_xxx -H "Authorization: Bearer $MUSE2API_KEY"
# {"status":"succeeded","result":{"url":"/v1/media/xxx.mp4"}}Python SDK
from openai import OpenAI
client = OpenAI(base_url="/v1", api_key="m2a_...")
r = client.chat.completions.create(
model="muse-spark",
messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)
img = client.images.generate(model="muse-image", prompt="a shiba inu astronaut")
print(img.data[0].url)API quản trị
| Method | Path | Mô tả |
|---|---|---|
| GET | /admin/status | Tổng quan dịch 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, 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 |
| POST | /admin/accounts/{id}/keepalive | Làm mới phiên |
| POST | /admin/accounts/{id}/quota | Đọc hạn mức |
| 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 |
| POST | /admin/media/delete | Xóa nhiều tệp |
Giới hạn
Chưa hỗ trợ tool calling / function calling. Trường tools được chấp nhận nhưng bỏ qua, request xử lý như chat thường. Các agent cần đọc/ghi file hoặc chạy lệnh sẽ không hoạt động đầy đủ.
Lịch sử hội thoại được gộp thành một prompt cho mỗi request; trường usage là giá trị ước lượng.
Thời hạn Cookie
| Cookie | Thời hạn | Vai trò |
|---|---|---|
| hatch_sess | ~30 ngày | Phiên đăng nhập chính |
| hatch_gw | ~1 năm | Token gateway |
| hatch_vml | ~2 ngày | Token ngắn hạn, được hệ thống tự gia hạn |
| hatch_native_auth_device | ~30 ngày | Mã thiết bị |
Không đăng xuất muse.ai trên trình duyệt đã dùng để lấy Cookie — đăng xuất sẽ vô hiệu hóa phiên.