Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro tạo ảnh raster 2K theo phong cách thị giác được tham chiếu xác định. Mô hình dành cho tài nguyên chiến dịch chi tiết và bộ ảnh cần giữ kết cấu, cách kết xuất, bảng màu và diện mạo tổng thể nhất quán khi chủ thể thay đổi.

Ailoot Ultra · Ảnh POST /v1/images/generations recraft/recraft-v4-styles-pro

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 Styles Pro là mô hình raster độ phân giải cao hơn trong dòng V4 Styles chuyên biệt của Recraft. Mô hình tạo ảnh mới từ bản yêu cầu văn bản và phong cách thị giác cung cấp qua ảnh tham chiếu hoặc phong cách đã lưu. Mô hình dành cho chiến dịch, minh hoạ thương hiệu và các bộ ảnh cần nối tiếp cách kết xuất, kết cấu cùng cá tính bố cục giữa tài nguyên. Mô hình tách biệt với Recraft V4 Pro và V4.1 Pro, nơi đầu vào phong cách là tuỳ chọn thay vì yêu cầu xác định mô hình.

Styles Pro tạo đầu ra raster 2K, định dạng WebP không mất dữ liệu hoặc PNG. Đầu ra vuông trong bảng kích thước của nhà sản xuất là 2048 × 2048 pixel, còn đầu ra 16:9 là 2688 × 1536; tỷ lệ được hỗ trợ khác có kích thước riêng. Đầu ra lớn hơn của Pro có thể hữu ích cho hình ảnh chiến dịch chi tiết và bố cục lớn. Các biến thể vector tạo SVG và không có kích thước pixel cố định, nên không chọn phiên bản raster Pro này khi sản phẩm bàn giao dự định là tệp vector có thể chỉnh sửa.

Mỗi lần tạo trong dòng Styles đều cần phong cách. Cung cấp từ một đến mười ảnh tham chiếu PNG, JPG hoặc WebP, hoặc dùng lại phong cách đã lưu tương thích; mã định danh phong cách và tham chiếu mới là đầu vào thay thế, thay vì một cặp để kết hợp. Quy trình nhà sản xuất cho phép tổng tham chiếu tối đa 64 MB, mỗi tệp dưới 20 MB. Tạo phong cách không yêu cầu bước huấn luyện do người dùng chạy. Một tham chiếu rõ có thể xác lập định hướng thống nhất, và nhiều tham chiếu hữu ích khi đã chung ngôn ngữ thị giác thay vì có diện mạo cạnh tranh. Mỗi tham chiếu phải có cạnh ngắn ít nhất 256 pixel, cạnh dài không quá 4,096 pixel và tổng độ phân giải không quá 16 megapixel.

Khớp phong cách linh hoạt là mặc định và cho phép diễn giải tham chiếu thoáng hơ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. Tham chiếu xác định ngôn ngữ thị giác; bản yêu cầu văn bản vẫn cần mô tả chủ thể, hành động, cảnh và khung hình mới. Với chiến dịch sản phẩm chi tiết, nêu chai thuỷ tinh trên bề mặt đá nhạt, góc ba phần tư, ánh sáng bên dịu và khoảng trống rõ cho tiêu đề, trong khi tham chiếu cung cấp cách thể hiện nhiếp ảnh.

Mô hình nhận câu lệnh tối đa 10,000 ký tự, hỗ trợ màu ưu tiên và màu nền mong muốn, đồng thời có thể dùng seed ngẫu nhiên. Quy trình tạo ảnh được công bố có thể trả từ một đến sáu ảnh. Các tuỳ chọn hữu ích khác phiên bản Recraft cũ: tên phong cách tuyển chọn, negative_prompt và text_layout không được hỗ trợ, và dòng Styles không cung cấp ảnh thành ảnh hoặc vẽ bù vùng ảnh. Tham chiếu là nguồn phong cách, không phải mặt nạ hay chỉ dẫn giữ nguyên từng pixel của ảnh chụp có sẵn.

Chuẩn bị tài nguyên tham chiếu sạch, đủ chi tiết và dùng lại cùng phong cách khi phát triển bộ ảnh. Nếu đầu ra lặp lại quá nhiều, đổi chủ thể, tư thế, góc máy hoặc cảnh trong bản yêu cầu văn bản thay vì thêm tham chiếu không liên quan. Không bảo đảm màu khớp chính xác từ tham chiếu sang đầu ra; tuỳ chọn màu ưu tiên thể hiện định hướng thay vì kết quả kiểm chứng màu. Với tài nguyên chiến dịch cuối cùng, đánh giá ảnh ở kích thước hiển thị hoặc in dự định và kiểm tra chủ thể, khoảng trống hữu ích cùng cách thể hiện có khớp bản yêu cầu hay không.

Ailoot Ultra · Ảnh POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Bắt đầu

Đầ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ường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn recraft/recraft-v4-styles-pro	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Độ dài tối thiểu: 1	Mặc định—
Trường`aspect_ratio`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	Mặc định—
Trường`n`	Loại`integer`	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ường`input_references`	Loại`array`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 10	Mặc định—
Trường`provider`	Loại`object`	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í	Điều kiện 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í—	Điều kiện 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ìnhTham chiếu đầu vào	Biểu mức phí—	Số lượng dự báo—	Đơn vị tính phímỗi yêu cầu	Điều kiện tính phíTạo phong cách khi tạo ảnh bằng tham chiếu phong cách; tính một lần cho mỗi yêu cầu, ngoài giá ảnh đầu ra.	Phí Đầu vào · Tham chiếu đầu vào · Ước tính chỉ để so sánh $0.01 mỗi yêu cầu
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	Điều kiện tính phí—	Phí Đầu ra · ảnh đầu ra · Ước tính chỉ để so sánh $0.2 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í—	Điều kiện tính phí—	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.2 ướ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

curl

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-styles-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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lượt đọc nội dung khác

Đọc tài nguyên hiện có thuộc về bạn

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ường`created`	Loại
Trường`data[].url`	Loại
Trường`data[].b64_json`	Loại
Trường`usage`	Loại

Bí danh

Bí danh mô hình

Ailoot Ultra recraft/recraft-v4-styles-pro

Bí danh đường dẫn phương thức

/v1/images

ID gọi liên quan

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Có những đầu vào và kết quả nào?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · recraft/recraft-v4-styles-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-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro