Dịch vụ — Tài khoản — Trình duyệt — Tự làm mới API Key

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ênIDTrạng tháiPhiên hết hạnHạn mứcHoạt độngCookie Dùng gần nhấtGhi chúThao tác
Đang tả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ạiMô tảTrạng thái Thời gianNgày tạoKế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 base_url và api_key.
Địa chỉ API: —

1. Model khả dụng

Mã modelChức năngEndpoint
muse-sparkChat / lập trình (có streaming)POST /v1/chat/completions
POST /v1/responses
muse-imageTạo ảnh / chỉnh sửa ảnhPOST /v1/images/generations
muse-videoTạo video / video từ ảnhPOST /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ẫnMô tả
GET/admin/statusTổng quan dịch vụ, tài khoản và tác vụ
GET/admin/accountsDanh sách tài khoản
POST/admin/accountsThê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}/testKiể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}/cookiesCập nhật Cookie
GET/admin/tasksLịch sử tác vụ
GET/admin/mediaDanh sách tệp đã tạo
POST/admin/media/deleteXó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 tinGiá trị
Địa chỉ APIhttp://<IP-hoặc-tên-miền>:18610/v1
API keym2a_... (hiển thị ở đầu trang)
Modelmuse-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ụngAPI sử dụngTrạng thái
Ứng dụng chat / giao diện webPOST /v1/chat/completions✅ Dùng được
Phản hồi streamingstream:true (SSE)✅ Dùng được
Gợi ý mãPOST /v1/chat/completions✅ Dùng được
Dịch / tóm tắt / giải thíchPOST /v1/chat/completions✅ Dùng được
Ứng dụng tạo ảnhPOST /v1/images/generations✅ Dùng được
Ứng dụng tạo videoPOST /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.