Recraft: Recraft V4.1

Recraft V4.1 tạo ảnh raster 1K với tính chân thực tự nhiên, minh hoạ giàu biểu cảm và bố cục có chủ ý. Mô hình có thể phát triển định hướng sáng tạo ngắn hoặc theo bản yêu cầu chi tiết, với đầu vào ảnh và phong cách tuỳ chỉnh tuỳ chọn.

Ailoot Ultra · Ảnh POST /v1/images/generations recraft/recraft-v4.1

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 là mô hình raster chính trong dòng V4.1 của Recraft. Mô hình được xây dựng để tạo ảnh giàu biểu cảm, gồm ảnh chụp tự nhiên, minh hoạ và ý tưởng thị giác có chiều sâu. Nhà sản xuất giới thiệu mô hình có thể đưa quyết định thẩm mỹ từ câu lệnh ngắn, đồng thời đáp ứng định hướng sáng tạo chi tiết hơn. Dùng để khám phá, phát triển ý tưởng và tạo ảnh nơi tâm trạng, ánh sáng cùng bố cục là phần của kết quả, thay vì thu về góc sản phẩm chính diện đơn giản.

Mã nhà sản xuất cụ thể là recraftv4_1. Mô hình trả ảnh raster 1K ở WebP không mất dữ liệu hoặc PNG, với đầu ra vuông 1024 × 1024 pixel và 16:9 là 1344 × 768. Các tỷ lệ được hỗ trợ khác dùng kích thước riêng. V4.1 Pro là phiên bản raster 2K riêng, Vector trả SVG có thể chỉnh sửa, còn Utility thiên về ánh sáng và cảnh đơn giản hơn. Các nhánh phục vụ sản phẩm bàn giao khác nhau và không nên gộp thành một bộ thuộc tính đầu ra.

Nhà sản xuất nhấn mạnh cảnh nhiếp ảnh tự nhiên hơn, phông nền nhẹ nhàng hơn, chuyển sắc mượt hơn và phạm vi minh hoạ rộng. Ví dụ gồm chữ giàu biểu cảm, minh hoạ nhân vật phẳng và bảng tham chiếu nhân vật vẽ. Câu lệnh ngắn có thể chừa chỗ cho diễn giải của mô hình; bản yêu cầu chi tiết có thể cố định chủ thể, tư thế, chất liệu, nền và bố cục. Với hình ảnh có chiều sâu, chỉ định cách thể hiện bề mặt và ánh sáng, đồng thời nhớ kết quả là ảnh thay vì lưới hình học hoặc dự án 3D có thể chỉnh sửa.

Với ý tưởng không gian đọc, yêu cầu một bức ảnh mang cảm giác gần gũi về một góc đọc nhỏ, ánh sáng ban ngày ấm, sách và một vật gốm, với sắp xếp thư giãn thay vì kiểu phòng trưng bày. Bản yêu cầu minh hoạ có kiểm soát có thể thay vào đó nêu chủ thể đồ hoạ, quan hệ màu và cách thể hiện nét. Nêu tỷ lệ khung hình dự định cùng quyết định hình ảnh quan trọng nhất. Cách này giúp dễ xác định chi tiết bất ngờ là diễn giải sáng tạo hữu ích hay điều cần đổi trong bản yêu cầu tiếp theo.

Tài liệu tham chiếu tạo ảnh cho phép câu lệnh tối đa 10,000 ký tự, seed ngẫu nhiên, màu ưu tiên và màu nền mong muốn, với từ một đến sáu đầu ra. Ảnh tham chiếu hoặc phong cách đã lưu tương thích tuỳ chọn có thể xác lập ngôn ngữ thị giác với khớp linh hoạt hoặc chính xác. Chúng không bắt buộc cho phiên bản V4.1 chính. Chọn tham chiếu sạch, thống nhất với nhau và dùng câu lệnh cho nội dung mới; tái tạo màu tham chiếu không được bảo đảm. 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.

V4.1 còn hỗ trợ quy trình ảnh thành ảnh riêng với ảnh có sẵn, văn bản và strength từ 0 đến 1. Thao tác dùng strength để kiểm soát mức ảnh mới bám sát nguồn và không nhận tuỳ chọn phong cách tuỳ chỉnh V4.1. Tài liệu tham chiếu tạo ảnh hiện hành của mô hình loại trừ negative_prompt, phong cách tuyển chọn, text_layout, artistic_level và no_text. Mô tả trực tiếp cảnh dự định và kiểm tra tài nguyên kết quả trong bố cục đích, gồm chi tiết, vùng cắt cùng mọi chữ, trước khi quyết định giữ định hướng nào. Với ảnh thành ảnh, cung cấp PNG, JPG, WebP hoặc SVG dưới 20 MB, không quá 16 megapixel, hai cạnh từ 256 đến 4,096 pixel.

Ailoot Ultra · Ảnh POST /v1/images/generations recraft/recraft-v4.1

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

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.1	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, 4:3, 3:4, 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: 0 Số mục tối đa: 1	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í	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.07 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.07 ướ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.1', '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.1

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

/v1/images

ID gọi liên quan

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

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

Recraft: Recraft V4.1