FLUX 3 Image Klein

Ví dụ nhanh

Gửi yêu cầu một ảnh, lưu id trả về rồi truy vấn đến khi tác vụ là completed hoặc failed. API dùng tác vụ bất đồng bộ và đầu ra URL.

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

Endpoint và header

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

Giữ khóa trên máy chủ. HTTP thành công xác nhận tác vụ, không có nghĩa ảnh đã sẵn sàng.

Tham số

Nhận 11 trường. Chỉ model và prompt bắt buộc. Bỏ qua trường tùy chọn để dùng mặc định; không nhận null.

Tỷ lệ: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

Playground cố định mô hình và có mười điều khiển nhập, gồm n cố định ở 1. Giá trị an toàn trên 2 chỉ dùng qua API, trừ quản trị viên.

Chế độ và ràng buộc

Không có tham chiếu là tạo từ văn bản. Một ảnh để chỉnh sửa; nhiều ảnh để kết hợp bố cục. Với auto, chỉnh sửa theo tỷ lệ ảnh đầu. Chỉ có văn bản thì dùng prompt để chọn tỷ lệ, dự phòng 1:1 nếu không xác định được. Độ phân giải mặc định là 1k trong mọi chế độ.

Các mức là quy mô gần đúng: 768sq khoảng 768 × 768; 1K khoảng 1 MP; 1.5K khoảng 2 MP; 2K khoảng 4 MP; 4K khoảng 16 MP. Xem kích thước thực trong tệp trả về.

Endpoint không nhận width, height, kích thước pixel trong size, negative_prompt, guidance, grounding, prompt_upsampling, mask hay mask_url. Trường không biết trả HTTP 400 trước tính phí. Không có đầu ra WebP, đầu vào base64, streaming hoặc callback.

Ảnh tham chiếu và sửa theo vùng

Tải tham chiếu lên URL công khai trước khi gửi. Nội dung yêu cầu chứa URL, không chứa byte tệp hay data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Thay URL minh họa bằng ảnh của bạn có thể truy cập. Tham chiếu có thứ tự: ref_image_0 là ảnh đầu. Chỉ dẫn hộp bao nằm trong chuỗi prompt, không phải trường riêng. Tọa độ dùng [y1, x1, y2, x2] chuẩn hóa về 0–1000. Đối tượng bố cục có thể chứa id, bbox, desc; chỉnh sửa dùng được id, from, src_bbox, tgt_bbox, desc. Mã hóa toàn bộ yêu cầu thành JSON để escape đúng dấu ngoặc kép trong prompt.

Tính phí

Một yêu cầu thành công là một ảnh. Chỉ độ phân giải quyết định giá; số bước, seed, tỷ lệ, số tham chiếu và định dạng không thêm phí. Tạo văn bản và chỉnh sửa cùng giá. Yêu cầu thất bại không bị tính phí. Xem giá hiện tại.

Phản hồi tác vụ và truy vấn

Gửi yêu cầu:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

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

Tác vụ hoàn tất (URL minh họa):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Đọc output.data[0].url. Dự trù tối đa mười phút để tạo, nhất là 4K. Truy vấn chỉ đọc; timeout máy khách không cho phép gửi thêm yêu cầu trả phí. Phản hồi công khai không gồm phí hay số dư tài khoản.

Lỗi

Lỗi HTTP dùng {"error": {"code": integer, "message": string}}. Xem danh mục lỗi chung. Tác vụ thất bại nêu lỗi cạnh status: "failed". Sửa tham số sai trước khi gửi lại; giữ ID để kiểm tra yêu cầu đã gửi.

Mẹo và hướng dẫn liên quan

Mô tả khẳng định và nêu vùng hoặc chi tiết cần giữ. Giảm bước có thể đổi chất lượng nhưng không giảm giá. So sánh từng thay đổi một.

• FLUX 3 Image Klein Playground
• Hướng dẫn tải xuống, trọng số và ComfyUI
• Vòng đời tác vụ