Muse Image

Tạo ảnh Muse Image từ prompt hoặc tối đa 9 ảnh tham chiếu với bảy tỷ lệ khung hình, một ảnh mỗi yêu cầu, tính phí mỗi ảnh và giao kết quả qua tác vụ.

Muse Image là mô hình ảnh của Meta Superintelligence Labs. Một yêu cầu tạo một ảnh từ prompt, hoặc từ prompt cùng tối đa 9 ảnh tham chiếu, với một trong bảy tỷ lệ khung hình. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc ảnh hoàn chỉnh từ tác vụ. Ảnh tham chiếu được truyền vào dưới dạng URL.

ID mô hình

ID mô hình	Đầu vào	Tỷ lệ khung hình	Số ảnh mỗi yêu cầu
`muse-image`	văn bản, 0–9 ảnh	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	1

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

Header	Giá trị
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải ảnh hoàn chỉnh. Hãy truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Hãy giữ khóa API trong code phía máy chủ. Ảnh tham chiếu được truyền trong cùng yêu cầu qua image_urls; mô hình này không dùng /v1/images/edits.

Tham số

Trường	Kiểu	Mặc định	Ghi chú
`model`	string	bắt buộc	`muse-image`
`prompt`	string	bắt buộc	Không được rỗng sau khi loại bỏ khoảng trắng ở hai đầu. Vẫn bắt buộc khi có ảnh tham chiếu.
`image_urls`	danh sách URL	không có	0–9 URL ảnh công khai, tổng cộng 11 MB. Không có ảnh thì yêu cầu tạo ảnh từ văn bản.
`aspect_ratio`	enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` hoặc `2:3`. Bỏ qua để chọn tự động: ảnh tham chiếu quyết định tỷ lệ; chỉ có văn bản thì dùng `1:1`. Không gửi `"auto"`.
`size`	enum	không có	Bí danh tương thích của `aspect_ratio`: một trong các tỷ lệ trên hoặc `auto`. Kích thước pixel như `1024x1024` bị từ chối. Khi cả hai đều hợp lệ, ưu tiên `aspect_ratio`.
`n`	integer	`1`	Chỉ `1`. Mỗi yêu cầu trả về một ảnh.

Các trường ngoài danh sách này bị loại bỏ trước khi chuyển tiếp yêu cầu; chúng không gây lỗi và không thay đổi đầu ra. Không có thiết lập độ phân giải, seed, prompt phủ định, mặt nạ hay định dạng đầu ra. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Ảnh tham chiếu

Truyền tối đa 9 ảnh vào image_urls và nêu trong prompt những gì cần giữ và cần thay đổi. Muse Image dùng chúng làm tham chiếu cho một ảnh mới; khi bỏ qua aspect_ratio, kết quả lấy theo tỷ lệ của chúng.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

Đầu vào media

Mỗi ảnh tham chiếu là một URL HTTP(S) công khai. Không chấp nhận data URI base64: hãy tải tệp lên kho lưu trữ của bạn và truyền URL của nó. Dùng ảnh PNG, JPEG hoặc WebP; tổng dung lượng tệp gốc của tất cả ảnh tham chiếu phải từ 11 MB trở xuống. Bộ ảnh vượt giới hạn này sẽ thất bại sau khi được tiếp nhận và không bị tính phí.

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. Muse Image có một mức giá cho mỗi ảnh:

cost = price per image × 1

Yêu cầu chỉ có văn bản và yêu cầu kèm ảnh tham chiếu có cùng giá, bất kể tỷ lệ khung hình. Số tiền tạm giữ khi tác vụ được tiếp nhận chính là số tiền bị tính. Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

Lấy thông tin tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Hãy truy vấn 10–20 giây một lần cho đến khi status là completed hoặc failed. Hết thời gian mạng trong lúc truy vấn không có nghĩa là việc tạo ảnh đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

Ảnh được giao ở định dạng WebP của chính mô hình; không có thiết lập định dạng đầu ra. Mô hình quyết định kích thước pixel. Trong thử nghiệm của chúng tôi, yêu cầu chỉ có văn bản trả về ảnh 1600 × 1600, 16:9 ở 2048 × 1152, 3:4 ở 1344 × 1792 và 9:16 ở 1152 × 2048, khoảng 50–180 giây sau khi gửi.

Lỗi

Những yêu cầu bị từ chối trước khi tác vụ được tạo sẽ trả về lỗi HTTP kèm đối tượng error và không bị tính phí. Tác vụ thất bại sau khi đã được tiếp nhận sẽ trả về HTTP 200 khi truy vấn, kèm status: "failed" và một đối tượng error.

Hãy xem danh mục lỗi dùng chung để biết mã lỗi, mã trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

Nêu chủ thể, bối cảnh, ánh sáng và bố cục khung hình; Muse Image bám sát yêu cầu cụ thể.
Khi dùng ảnh tham chiếu, nêu chính xác những gì phải giữ nguyên, chẳng hạn màu sắc hoặc hình dạng sản phẩm.
Bỏ qua aspect_ratio để khớp tỷ lệ của ảnh tham chiếu; đặt giá trị để cắt ảnh phù hợp với kênh.
Thêm no text, no logos để tránh các dấu hiệu tự bịa ra.