Recraft: Recraft V4.1 Utility Pro
Recraft V4.1 Utility Pro tạo ảnh raster 2K với trọng tâm cảnh đơn giản, dễ dự đoán, ánh sáng phẳng và bố cục chính diện. Mô hình phù hợp ảnh sản phẩm chi tiết và mockup cần trình bày rõ ràng hơn là định hướng mỹ thuật giàu biểu cảm.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Recraft V4.1 Utility Pro là biến thể raster độ phân giải cao hơn của nhánh Utility trong Recraft V4.1. Nhà sản xuất phân biệt cách trình bày trực tiếp của Utility với lựa chọn góc nhìn, ánh sáng và bố cục giàu biểu cảm hơn của mô hình V4.1 chính. Utility thiên về cảnh đơn giản, ánh sáng phẳng và chủ thể chính diện. Vì vậy, mô hình phù hợp hình ảnh trang sản phẩm, mockup và công việc khác nơi vật thể cần dễ nhìn và bố cục yên tĩnh phục vụ tác vụ.
Mã mô hình cụ thể là recraftv4_1_utility_pro. Tài liệu tham chiếu của nhà sản xuất liệt kê đầu ra raster 2K có chi tiết tinh hơn, ở WebP không mất dữ liệu hoặc PNG. Bảng kích thước nêu 2048 × 2048 pixel cho ảnh vuông và 2432 × 1792 cho 4:3, với tỷ lệ được hỗ trợ khác dùng kích thước riêng. Điều này tách Utility Pro khỏi đầu ra 1K của Utility tiêu chuẩn. Nó không biến ảnh thành tệp vector có thể chỉnh sửa; phiên bản Vector cung cấp SVG cho mục đích đó.
Bắt đầu bằng bản yêu cầu nêu vật thể, chất liệu, góc nhìn, nền và vài chi tiết phải nhìn rõ. Với trang sản phẩm, yêu cầu hũ đựng gốm nhìn chính diện trên bề mặt trung tính sáng, ánh sáng đều, nắp đóng và khoảng trống rõ quanh hình dáng. Nếu cảnh phải giữ đơn giản, nói rõ thay vì dựa vào tên Utility để mã hoá mọi lựa chọn trình bày. Với chuỗi ảnh trang sản phẩm, giữ yêu cầu khung hình và nền nhất quán khi đổi mô tả sản phẩm.
Tài liệu tham chiếu tạo ảnh V4.1 hỗ trợ câu lệnh tối đa 10,000 ký tự, tuỳ chọn màu ưu tiên và màu nền, seed ngẫu nhiên và từ một đến sáu đầu ra. Phong cách đã lưu tương thích hoặc ảnh tham chiếu tuỳ chọn có thể định hướng diện mạo; dòng V4 Styles chuyên biệt là dòng riêng nơi phong cách luôn bắt buộc. Với tham chiếu tuỳ chọn, dùng tài nguyên rõ có định hướng thị giác thống nhất. Không bảo đảm tái tạo màu chính xác từ tham chiếu, nên yêu cầu màu thương hiệu vẫn cần bản yêu cầu rõ và kiểm tra đầu ra. Với tạo ảnh theo phong cách tham chiếu, dùng từ một đến mười ảnh PNG, JPG hoặc WebP, tổng không quá 64 MB và mỗi ảnh dưới 20 MB. Mỗi tham chiếu cần cạnh ngắn ít nhất 256 pixel, cạnh dài không quá 4,096 pixel và độ phân giải không quá 16 megapixel. Dùng những tham chiếu này hoặc phong cách đã lưu tương thích, thay vì cả hai. Với tạo ảnh theo phong cách tham chiếu, chế độ khớp linh hoạt cho phép diễn giải thoáng hơn, còn khớp chính xác bám sát cách kết xuất, bảng màu, bố cục và ánh sáng hơn.
Recraft còn công bố ảnh thành ảnh cho dòng V4.1, kết hợp ảnh có sẵn với câu lệnh và strength từ 0 đến 1. Strength thấp bám nguồn hơn và giá trị cao cho phép thay đổi lớn hơn. Điều này hữu ích khi bố cục hoặc chủ thể khởi đầu cần định hướng phiên bản mới. Quy trình không nhận tuỳ chọn phong cách tuỳ chỉnh V4.1 trong cùng thao tác biến đổi. Giới hạn ảnh đầu vào của nhà sản xuất là dưới 20 MB, tối đa 16 MP và các cạnh từ 256 đến 4096 pixel.
Utility Pro có cùng hạn chế V4.1 về các tuỳ chọn negative_prompt, tên phong cách tuyển chọn, text_layout, artistic_level và no_text. Đưa mô tả khẳng định cảnh dự định và dành việc làm chữ hoặc bố cục chính xác cho bước hoàn thiện phù hợp khi cần. Kiểm tra hình ảnh sản phẩm theo chất liệu, hình dạng và chi tiết cần thiết được cung cấp trước khi coi là tài nguyên trang sản phẩm trung thực. Kết quả hữu ích là bố cục raster lớn hơn được chuẩn bị cho bản yêu cầu sản phẩm hoặc mockup rõ ràng, còn dữ kiện sản phẩm chính xác vẫn là những gì tác vụ cung cấp.
Ailoot Ultra · Ảnh POST /v1/images/generations recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-pro
recraft/recraft-v4.1-utility-proBắt đầu
Recraft V4.1 Utility Pro tạo ảnh raster 2K với trọng tâm cảnh đơn giản, dễ dự đoán, ánh sáng phẳng và bố cục chính diện. Mô hình phù hợp ảnh sản phẩm chi tiết và mockup cần trình bày rõ ràng hơn là định hướng mỹ thuật giàu biểu cảm.
- Đầu vào được chấp nhận
- Văn bản · Ảnh
- Kết quả
- Ảnh
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Ảnh POST /v1/images/generations
- Đầu vào
text,image- Đầu ra
image
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn recraft/recraft-v4.1-utility-pro | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 4:3, 3:4, 16:9, 9:16, auto | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 6 | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 1 | Mặc định— |
Trườngprovider | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốmaterial_types | Hợp đồngtext, image |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Cách tính phí cuối cùng
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí ước tính để so sánh
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Số lượng dự báo | Đơn vị tính phí | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Đơn vị tính phí— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhảnh đầu ra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh đầu ra | Phí Đầu ra · ảnh đầu ra · Ước tính chỉ để so sánh $0.42 mỗi ảnh đầu ra |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Đơn vị tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.42 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Ảnh
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1-utility-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Nhận và lưu kết quả
Ailoot Ultra · Ảnh
Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Lưu tất cả kết quả đã hoàn tất
Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.
Nếu cần kiểm tra phản hồi gốc
Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngcreated | Loại |
Trườngdata[].url | Loại |
Trườngdata[].b64_json | Loại |
Trườngusage | Loại |
Bí danh
Bí danh mô hình
Ailoot Ultra recraft/recraft-v4.1-utility-pro
Bí danh đường dẫn phương thức
/v1/images
ID gọi liên quan
FAQ · Recraft: Recraft V4.1 Utility Pro
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:text,image→image- Yêu cầu sử dụng những trường nào?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:model,prompt,aspect_ratio,n,input_references,provider- Áp dụng những giới hạn nào?
POST /v1/images/generations·recraft/recraft-v4.1-utility-pro:n.minimum:1;n.maximum:6