MiniMax H3 Image

Ví dụ nhanh

Gửi một yêu cầu ảnh, lưu id được trả về và thăm dò cho đến khi tác vụ có trạng thái completed hoặc failed. API này sử dụng tác vụ bất đồng bộ và đầu ra dạng URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Điểm cuối và tiêu đề

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

Giữ khóa trên máy chủ của bạn. Phản hồi HTTP thành công xác nhận tác vụ đã được tiếp nhận; không có nghĩa là ảnh đã sẵn sàng.

Tham số

Có 13 trường được chấp nhận. Chỉ model và prompt là bắt buộc. Bỏ qua các trường tùy chọn để sử dụng giá trị mặc định; không trường nào chấp nhận null. Playground cung cấp mô hình cố định và mười mục nhập có thể chỉnh sửa. Định dạng phản hồi URL và cách phân phối tác vụ không truyền luồng là cố định.

Điều kiện phụ thuộc của kích thước và prompt

size được chỉ định rõ phải chứa các kích thước là số nguyên dương, với diện tích từ 655.360 đến 20.000.000 pixel, bao gồm cả hai giới hạn. Chiều rộng chia cho chiều cao phải nằm trong khoảng 1/3 đến 3. Ví dụ, 2048x1152 là hợp lệ. Khi dùng kích thước chỉ định rõ, bỏ qua cả aspect_ratio và area, ngay cả khi giá trị của chúng là auto.

Khi bỏ qua kích thước hoặc dùng auto, hãy dùng aspect_ratio cùng với area. Diện tích là kích thước mục tiêu; hãy kiểm tra tệp được cung cấp để biết kích thước chính xác. Đây không phải là mức giá cố định cho một ảnh.

Thiết lập disable_prompt_enhanced: true yêu cầu kích thước pixel được chỉ định rõ hoặc tỷ lệ khung hình cố định. Khi tắt tính năng tăng cường, mô hình đọc khoảng 4.096 token đầu tiên của prompt. Giới hạn gửi 32.000 ký tự vẫn áp dụng. Khi chỉnh sửa, prompt luôn được tăng cường, nên true bị từ chối khi có images.

Không chấp nhận trường mặt nạ, seed, phong cách, chất lượng, prompt phủ định, nền hay trường độ phân giải riêng. Tham số không xác định trả về lỗi trước khi gửi. API này không cung cấp truyền luồng, ảnh base64 hay đầu ra WebP.

Ảnh tham chiếu

Sử dụng URL HTTP(S) có thể truy cập công khai, không chứa thông tin xác thực nhúng. Mỗi ảnh phải là JPEG, PNG, WebP, HEIC hoặc HEIF; tối đa 64 MiB; mỗi cạnh 128–8.192 pixel; và tỷ lệ cạnh dài trên cạnh ngắn tối đa là 4. Giữ phần thân JSON không quá 64 MiB. Tệp ảnh được tham chiếu qua URL, các byte ảnh không được nhúng trong phần thân JSON.

Gán mục đích rõ ràng cho từng ảnh tham chiếu và mô tả những gì cần giữ nguyên. Thứ tự mảng xác định <Picture 1>, <Picture 2> và tiếp theo.

{
  "model": "minimax-h3-image",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Thay các URL minh họa bằng tệp ảnh có thể truy cập của riêng bạn.

Tính phí

Việc tính phí gồm ba loại token: văn bản đầu vào, ảnh đầu vào và ảnh đầu ra. Nhân mức sử dụng thực tế trong mỗi loại với đơn giá hiện hành của loại đó. Số lượng đầu ra, kích thước ảnh và ảnh tham chiếu ảnh hưởng đến mức sử dụng; tên độ phân giải không xác định hóa đơn cố định. Yêu cầu thất bại không bị tính phí. Xem giá hiện hành.

Phản hồi tác vụ và thăm dò

Yêu cầu được chấp nhận trả về một tác vụ bất đồng bộ:

{"id":"task_example","model":"minimax-h3-image","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Phản hồi đã hoàn tất chứa URL ảnh trong output.data. Mỗi ảnh được cung cấp bao gồm size và có thể bao gồm revised_prompt (mô tả đã được tăng cường). output.created là thời điểm tạo tính bằng giây Unix, còn output.output_format xác định định dạng được cung cấp. output.usage cho biết số token văn bản đầu vào, ảnh đầu vào và ảnh đầu ra, cùng số generated_images được cung cấp. Các URL và ID bên dưới chỉ nhằm minh họa:

{
  "id": "task_example",
  "model": "minimax-h3-image",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Thăm dò mỗi 10–20 giây. Hết thời gian chờ phía máy khách không có nghĩa là tác vụ thất bại: giữ ID và tiếp tục thăm dò thay vì gửi yêu cầu trùng lặp. Phản hồi công khai không chứa số dư tài khoản hoặc chi phí.

Lỗi

Lỗi HTTP sử dụng {"error":{"code":integer,"message":string}}. Tác vụ thất bại có status: "failed" và một lỗi. Sửa tham số không hợp lệ trước khi gửi yêu cầu mới. Xem danh mục lỗi dùng chung và vòng đời tác vụ.

Trang liên quan

• Playground và giá MiniMax H3 Image
• MiniMax H3 Image Highspeed