Midjourney V8.2 API: gửi và truy vấn tác vụ ảnh
Gửi tác vụ ảnh Midjourney V8.2, lưu ID và lấy kết quả bằng Python. Tìm hiểu tham số theo phiên bản, thao tác ảnh và cách xem giá hiện tại.
Đọc dạng MarkdownTích hợp API Midjourney V8.2 cần phiên bản tường minh, yêu cầu ảnh hợp lệ và cách lấy tác vụ đã hoàn tất. Với SeedRouter, bạn gửi tới /v1/images/generations, giữ ID tác vụ được trả về rồi truy vấn định kỳ /v1/tasks/{id}. Gửi thành công chỉ xác nhận đã tiếp nhận tác vụ; ảnh xuất hiện trong kết quả hoàn tất.
Hướng dẫn này tuân theo đặc tả yêu cầu của SeedRouter. Một kiểm thử trả phí ngày 18 tháng 10 năm 2026 đã hoàn tất yêu cầu V8.2 Fast và trả về bốn ảnh 1024 × 1024. Ảnh chân dung bên dưới là một trong các đầu ra đó. Trang mô hình có Playground và giá hiện tại; tài liệu tham chiếu API phân biệt đầu vào được hỗ trợ với tổ hợp vẫn cần xác minh. [1]
Bắt đầu với yêu cầu API Midjourney V8.2 chỉ rõ phiên bản
Dùng ID mô hình đầy đủ midjourney-v8.2. SeedRouter yêu cầu chỉ định mô hình tường minh; đừng rút gọn thành midjourney hoặc suy ra từ thiết lập tài khoản trong giao diện khác. Ghi lại mô hình cùng yêu cầu đã gửi. [1]
Chuẩn bị khóa API phía máy chủ và prompt ngắn có kết quả dễ kiểm tra. Bắt đầu không dùng tham chiếu hay thao tác dựa trên ảnh cha để yêu cầu đầu tiên kiểm tra quy trình cơ bản. Yêu cầu bên dưới đã tạo bộ ảnh chân dung minh họa. Nó chọn Fast và bật bước kiểm tra nội dung bổ sung:
{
"model": "midjourney-v8.2",
"prompt": "Cinematic portrait of a young woman with freckles and wind-swept auburn hair, wearing a cream cable-knit sweater, laughing on a coastal cliff at golden hour, warm rim light, shallow depth of field, 85mm film photograph",
"speed": "fast",
"nsfw_check": true
}Yêu cầu tối thiểu chỉ cần model và prompt; nếu bỏ qua tốc độ, mặc định là Fast. Khi thêm size, dùng tỷ lệ khung hình như "16:9", không dùng chỉ dẫn pixel WIDTHxHEIGHT. Thiết lập sẵn của trình khách ảnh chung gửi 1024x1024, quality: "high" hoặc n tùy ý không khớp đặc tả mô hình này. Điều chỉnh phần thân theo bảng trường Midjourney thay vì dùng nguyên thiết lập của mô hình khác.
Gửi một lần, rồi truy vấn ID tác vụ đã lưu
Ví dụ Python có thể tải xuống dùng thư viện chuẩn, giữ khóa trong biến môi trường và ghi ID tác vụ đã được tiếp nhận vào tệp cục bộ. Nó có lệnh riêng cho gửi và truy vấn định kỳ. Việc tách riêng cho phép tiếp tục đọc mà không tạo công việc ảnh khác.
export SEEDROUTER_API_KEY='your-server-side-key'
python3 midjourney-v8-2.py submit request.json --state mj-task.json
python3 midjourney-v8-2.py poll --state mj-task.jsonLưu yêu cầu JSON phía trên thành request.json. Thay khóa mẫu bằng khóa bí mật của bạn trong môi trường cục bộ; không đưa khóa vào gói mã trình duyệt hoặc commit vào kho mã. Để thử bản triển khai cục bộ, đặt SEEDROUTER_BASE_URL của ví dụ thành URL gốc /v1 của bản triển khai đó.
Ví dụ từ chối ghi đè tệp trạng thái đã có khi gửi. Nó cũng không tự lặp lại POST sau lỗi kết nối. Nếu phản hồi bị mất, ứng dụng có thể không biết tác vụ đã được tiếp nhận hay chưa. Kiểm tra lịch sử tác vụ trước khi quyết định gửi lại.
Truy vấn định kỳ thì khác: nó đọc tác vụ đã tồn tại. Ví dụ dừng khi tác vụ hoàn tất hoặc thất bại và thông báo giới hạn chờ nếu tác vụ vẫn đang xử lý. Giới hạn chờ là quan sát phía trình khách, không phải bằng chứng cần tạo lại tác vụ.
Đọc cấu trúc kết quả theo thao tác
Thao tác ảnh hoàn tất trả URL trong output.data. Duyệt mảng đó thay vì cho rằng luôn có bốn phần tử. Tạo ảnh, chọn một ảnh, mô tả ảnh và bước nhập liệu chỉnh sửa có thể trả những loại đầu ra khác nhau.
| Trường kết quả | Ứng dụng cần làm gì |
|---|---|
status | Phân biệt tác vụ đang xử lý, hoàn tất và thất bại |
output.data[].url | Hiển thị hoặc lưu từng ảnh được trả về |
output.grid | Gắn nhãn lưới cho ảnh lưới được trả về; một tệp có thể chứa nhiều lựa chọn ảnh |
output.text | Hiển thị văn bản trả về, không mặc định có bốn gợi ý hoặc dùng tiếng Anh |
output.seed | Ghi lại khi có; không yêu cầu mọi kết quả đều phải có |
output.awaiting_input | Tiếp tục quy trình nhập liệu chỉnh sửa được ghi trong tài liệu |
Xử lý tác vụ thất bại như một lỗi trong ứng dụng, ngay cả khi yêu cầu HTTP dùng để đọc nó thành công. HTTP thành công nghĩa là truy vấn trạng thái đã được phục vụ; không có nghĩa ảnh yêu cầu đã được tạo.
Khi output.grid là true, một URL chứa lưới ảnh. Đừng tự tạo bốn URL riêng từ tệp đó. Lựa chọn sau này dùng vị trí ảnh trong lưới bắt đầu từ một; số URL không phải số lựa chọn khả dụng.
Ví dụ in đầu ra hoàn tất dưới dạng JSON. Ứng dụng có thể thêm lưu trữ, ảnh thu nhỏ và điều khiển chọn ảnh quanh các ảnh trả về. Giữ ID tác vụ cùng các kết quả để thao tác tiếp theo tham chiếu đúng tác vụ cha.
Chuyển tham số gốc mà không che khuất xung đột
Tích hợp chấp nhận trường có cấu trúc và cờ prompt gốc được hỗ trợ. Thứ tự ưu tiên là trường có cấu trúc, rồi extra, rồi cờ trong prompt. Giá trị số không và false được chỉ định tường minh sẽ được giữ lại.
Ví dụ, prompt chứa --stylize 700 kết hợp với "stylize": 0 sẽ dùng giá trị 0 được chỉ định rõ. Điều này hữu ích khi giao diện gửi điều khiển riêng, nhưng có thể gây bất ngờ nếu ứng dụng ghép prompt và JSON ở những nơi khác nhau. Nên dùng một nguồn duy nhất cho mỗi thiết lập.
Với yêu cầu SeedRouter V8.2, quality chấp nhận 0.25, 0.5, 1 hoặc 2 trong tổ hợp tương thích. Chất lượng và hd là đầu vào độc lập: đặt chất lượng không đồng nghĩa chọn HD. Xem giới hạn tổ hợp hiện tại trước khi thêm cả hai hoặc điều khiển tham chiếu khác; đầu vào có tài liệu không chứng minh tác động trên mọi phiên bản. Raw tách biệt với cả hai; hướng dẫn Raw giải thích sự khác biệt đó. [1]
Tích hợp này bỏ các trường JSON không xác định nhưng từ chối cờ gốc không xác định. Đừng xem yêu cầu được tiếp nhận là bằng chứng một trường JSON bổ sung không liên quan đã thay đổi đầu ra. Kiểm tra tên trường trong tài liệu và lưu nguyên phần thân đã gửi trong bản ghi kiểm thử.
Giữ thao tác ảnh gắn với tác vụ cha
Dùng parent_task_id của SeedRouter cho thao tác tiếp theo. Thao tác phụ thuộc vẫn gắn với ngữ cảnh thực thi gốc. Nếu ngữ cảnh đó không khả dụng, thao tác thất bại thay vì tạo tác vụ cha khác ở nơi khác. Tác vụ cha phải thuộc cùng tài khoản, dùng cùng mô hình và còn khả dụng cho thao tác được yêu cầu. Chỉ số ảnh công khai bắt đầu từ một.
Chọn ảnh và nâng độ phân giải sáng tạo là hai thao tác khác nhau. Không nên mô tả kết quả select là cải thiện độ phân giải. Tương tự, biến thể, remix và Edit Model V8.2 chính thức là các tính năng riêng với yêu cầu khác nhau.
Tích hợp hiện tại chưa cung cấp Edit Model mới như một thao tác API đã xác minh. Đừng thay bằng yêu cầu inpaint cũ rồi cho rằng hành vi tương đương. Hướng dẫn chỉnh sửa giải thích lựa chọn thay thế khả dụng và chuỗi chỉnh sửa bằng mặt nạ V6.1 đã xác minh; tài liệu tham chiếu API ghi giới hạn thao tác đã triển khai.
Ước tính theo công việc thay vì đếm ảnh thu nhỏ
Theo đặc tả tính giá của tích hợp này, một lần tạo ảnh hoàn tất là một công việc. Chọn ảnh đã có từ lưới không tạo thêm lần sinh ảnh tính phí. Vào bước nhập liệu chỉnh sửa không cộng phí tạo ảnh lần hai; thao tác modal cuối cùng mới là bước tính phí. Tạo bốn ảnh không tự động là bốn công việc được tính phí riêng. Kiểm thử V8.2 Draft ngày 18 tháng 10 trả 24 ảnh trong một công việc; số ảnh trả về không phải công thức tính giá đáng tin cậy.
Dùng giá hiện tại cho phiên bản, thao tác, tốc độ và chế độ đã chọn. Thao tác dựa trên ảnh cha có thể kế thừa thiết lập, nên giá cần lấy từ yêu cầu thực tế có hiệu lực thay vì đoán giá trị mặc định. Trang mô hình đọc giá đã cấu hình thay vì gắn cố định số tiền đô la trong hướng dẫn này.
Trong kiểm thử nghiệm thu, ghi lại yêu cầu, ID tác vụ, trạng thái cuối, số đầu ra và số tiền thực tế bị trừ trên tài khoản. Biên dịch thành công hoặc kiểm thử HTTP giả lập không xác lập được các sự kiện khi chạy này. SeedRouter không tính phí yêu cầu thất bại.
Câu hỏi thường gặp
Tôi có thể dùng cùng khóa API trong JavaScript phía giao diện không?
Giữ khóa trên máy chủ. Để trình duyệt gọi điểm cuối ứng dụng đã xác thực, rồi điểm cuối đó gửi yêu cầu bằng khóa phía máy chủ.
Có ID tác vụ nghĩa là ảnh đã sẵn sàng chưa?
Chưa. Đọc tác vụ đến khi báo hoàn tất hoặc thất bại, rồi xử lý kết quả tương ứng. Lưu ID trước khi bắt đầu vòng truy vấn đó.
Hết thời gian chờ có nên tạo ảnh mới không?
Không tự động tạo lại. Giữ mọi ID tác vụ đã biết và kiểm tra tác vụ hiện có. Hết thời gian chờ kết nối hoặc chờ ở trình khách không chứng minh lần gửi ban đầu bị từ chối.
Tôi có thể đổi phiên bản cho thao tác dựa trên ảnh cha không?
Tích hợp này yêu cầu cùng mô hình với tác vụ cha. Bắt đầu lần tạo riêng khi muốn đánh giá phiên bản khác.
Bắt đầu tích hợp API Midjourney V8.2 bằng một yêu cầu tường minh và ID tác vụ đã lưu. Xác minh đầu ra được trả về và khoản phí trước khi thêm tham chiếu hoặc chuỗi thao tác ảnh.
Nguồn
Đặc tả và bằng chứng thực thi được kiểm tra ngày 18 tháng 10 năm 2026. Ảnh trong bài là đầu ra của kiểm thử tích hợp trả phí, không phải đánh giá chuẩn cho toàn bộ mô hình.