Skip to main content

Tìm hiểu khái niệm cốt lõi

MidJourney API mô phỏng các tương tác nút trên Discord. Không giống các REST API thông thường, API này hoạt động như một máy trạng thái trong đó mỗi thao tác trả về các nút mới cho bước tiếp theo.

4 API cốt lõi


Sơ đồ quy trình hoàn chỉnh


Khái niệm chính: Buttons và customId

Mọi tác vụ thành công đều trả về một mảng buttons. Mỗi nút có một customId mà bạn dùng để kích hoạt hành động tiếp theo. Phản hồi ví dụ từ /mj/task/\{id\}/fetch:
customId không phải là một giá trị cố định. Giá trị này thay đổi với mỗi tác vụ. Luôn lấy giá trị từ mảng buttons.

Tham chiếu nút theo giai đoạn

Sau IMAGINE (Sau IMAGINE ()

Các nút này được trả về khi quá trình tạo ảnh ban đầu của bạn hoàn tất:

Sau UPSCALE (Sau UPSCALE ()

Sau khi upscale, bạn có quyền truy cập vào các công cụ chỉnh sửa:
Lưu ý: Nhãn nút và định dạng customId có thể thay đổi tùy theo phiên bản MJ được chỉ định trong Prompt của bạn (ví dụ: --v 6.1 so với --v 5.2). Luôn đọc các nút từ phản hồi API.
Nút Inpaint (Vary Region) chỉ xuất hiện sau khi Upscale.

Ví dụ hoàn chỉnh: Tạo ảnh và upscale

Bước 1: Gửi yêu cầu imagine

Phản hồi:

Bước 2: Thăm dò trạng thái tác vụ

Phản hồi (khi hoàn tất):

Bước 3: Nhấn U1 để upscale

Phản hồi:

Bước 4: Thăm dò tác vụ mới và nhận kết quả


Khi nào cần Modal?

Khi bạn gọi /mj/submit/action và trạng thái tác vụ chuyển thành MODAL thay vì SUCCESS, bạn phải gọi /mj/submit/modal để cung cấp dữ liệu đầu vào bổ sung.

Các thao tác Modal đã được xác nhận

Ví dụ: Quy trình Inpaint Bắt đầu thao tác Inpaint:
Truy vấn tác vụ mới một lần. Trạng thái MODAL nghĩa là tác vụ cần mặt nạ và Prompt:
Gửi mặt nạ và Prompt thông qua Modal API:

Chọn chế độ tốc độ

Thêm tiền tố tốc độ vào đường dẫn:

Các điểm truy cập khác

Các API này là các điểm truy cập độc lập không tuân theo quy trình imagine → action:

Mẹo khắc phục sự cố

Dựa trên thiết kế API và quy trình làm việc, dưới đây là các vấn đề phổ biến bạn có thể gặp phải:
Lần sửa đổi cuối 31 tháng 7, 2026