Tạo ảnh Midjourney v8.2 / Niji 7

Sử dụng API tạo ảnh bất đồng bộ tại https://apimaster.ai/v1 với midjourney-v8.2 hoặc midjourney-niji-7. ID mô hình sẽ chọn phiên bản; không thêm các trường ghi đè phiên bản.

Tạo tác vụ

POST https://apimaster.ai/v1/midjourney/generations

curl -s "https://apimaster.ai/v1/midjourney/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v8.2",
    "prompt": "a quiet Japanese garden at dawn, cinematic composition",
    "size": "16:9",
    "speed": "relax"
  }'

Đối với Niji 7, đặt model thành midjourney-niji-7:

{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}

Trường	Loại	Bắt buộc	Mô tả
model	chuỗi	Có	midjourney-v8.2 hoặc midjourney-niji-7
prompt	chuỗi	Có	Mô tả ảnh, bao gồm các tham số Midjourney được hỗ trợ
size	chuỗi	Không	Tỷ lệ khung hình như 1:1 hoặc 16:9; mặc định là 1:1
speed	chuỗi	Không	relax, fast hoặc turbo; mặc định là relax
image_urls	chuỗi[]	Không	URL ảnh tham chiếu từ 1–20; các URL dữ liệu ảnh được hỗ trợ cũng được chấp nhận
iw	số	Không	Trọng số ảnh tham chiếu 0–3; yêu cầu image_urls
quality	chuỗi	Không	0.25, 0.5, 1 hoặc 2; không được Niji 7 hỗ trợ
stylize / chaos / weird	số nguyên	Không	Phạm vi: lần lượt 0–1000, 0–100 và 0–3000
seed	số nguyên	Không	Seed ngẫu nhiên 0–4294967295
negative_prompt	chuỗi	Không	Nội dung cần loại trừ
sref / sw	chuỗi / số nguyên	Không	URL tham chiếu phong cách công khai và trọng số 0–1000; sw yêu cầu sref
dref / dw	chuỗi hoặc chuỗi[] / số	Không	URL tham chiếu (tối đa 20) và trọng số 0–100; dw yêu cầu dref
raw / tile / hd	boolean	Không	Phong cách raw, tiling và HD; tile và hd chỉ có ở v8.2
extra	chuỗi	Không	Chuỗi tham số được hỗ trợ như --ar 16:9 --s 750; các trường có cấu trúc được ưu tiên
metadata	đối tượng	Không	Metadata nghiệp vụ tùy chỉnh
repeat	số nguyên	Không	2–40 để tạo nhiều tác vụ

Niji 7 không hỗ trợ quality, tile=true hoặc hd=true. Cả hai mô hình đều từ chối draft=true, cref, cw, stop và các trường yêu cầu version và niji. style=raw được chuẩn hóa thành raw=true. Không sử dụng --v hoặc --niji trong prompt hoặc extra để ghi đè phiên bản mô hình.

Phản hồi chứa ID lô và các ID tác vụ:

{
  "id": "imagine_batch_xxxxxxxx",
  "request_id": "req_xxxxxxxx",
  "model": "midjourney-v8.2",
  "status": "queued",
  "data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}

Kiểm tra trạng thái tác vụ

curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Phản hồi hoàn tất bao gồm URL ảnh trong data; tasks chứa từng tác vụ con:

{
  "id": "imagine_batch_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "data": [{"url": "https://example.com/generated.png"}],
  "tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}

Thăm dò trong khi trạng thái là queued hoặc processing. Khi thất bại, hãy đọc tasks[].error và không gửi lại cùng yêu cầu. Tải xuống các URL được trả về ngay vì chúng có thể hết hạn.

Nếu việc gửi trả về 502 với header X-Task-ID, hoặc truy vấn trả về pending_timeout, hãy lưu ID và tiếp tục kiểm tra trạng thái của nó thay vì tự động gửi lại. Một lô có thể chứa cả tác vụ thành công và thất bại; hãy kiểm tra từng tasks[] riêng lẻ. Nên thăm dò 15 giây một lần.

Lỗi và giá

model và prompt không rỗng là bắt buộc. Các phiên bản không được hỗ trợ, tỷ lệ không hợp lệ, tham chiếu không thể truy cập và tham số không được hỗ trợ trả về 400. 401 nghĩa là key không hợp lệ, 402 nghĩa là số dư không đủ, và 429 nghĩa là bị giới hạn tốc độ. Xem thẻ Midjourney v8.2 và thẻ Niji 7 để biết giá và tuyến hiện tại.