Recraft: Recraft V4 Pro
Recraft V4 Pro tạo ảnh raster 2K cho bố cục chi tiết, hình ảnh chân thực, minh hoạ và công việc sáng tạo hướng đến in ấn. Đây là phiên bản V4 độ phân giải cao hơn, với bản yêu cầu văn bản, đầu vào phong cách tuỳ chọn và quy trình ảnh thành ảnh riêng.
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 Pro là mô hình raster độ phân giải cao hơn trong dòng V4 của Recraft. V4 tập trung vào phán đoán thị giác, bố cục cân bằng, màu thống nhất và diễn giải cẩn thận định hướng sáng tạo. Nhà sản xuất định vị Pro cho chi tiết tinh hơn, cảnh phức tạp chân thực hơn và hình ảnh sản xuất quy mô lớn. Dùng cho minh hoạ chi tiết, ảnh biên tập, ý tưởng áp phích hoặc tài nguyên khác hưởng lợi từ kết quả raster lớn hơn. Mô hình vẫn tách biệt với V4.1 về sau và đầu ra SVG của V4 Pro Vector.
Mã nhà sản xuất cụ thể là recraftv4_pro. Đầu ra được công bố là raster 2K ở WebP không mất dữ liệu hoặc PNG: 2048 × 2048 pixel cho ảnh vuông, 2688 × 1536 cho 16:9 và 1664 × 2560 cho 2:3. Tỷ lệ được hỗ trợ khác có kích thước riêng. Chọn tỷ lệ khung hình cho bố cục dự định hoặc kích thước chính xác được phép; kích thước pixel tuỳ ý không nằm trong hợp đồng tạo ảnh được công bố. V4 tiêu chuẩn có đầu ra raster 1K nhỏ hơn, còn mô hình vector không có độ phân giải pixel cố định.
V4 có thể diễn giải câu lệnh ngắn để khám phá hoặc câu lệnh có cấu trúc để có kết quả kiểm soát. Với định hướng mỹ thuật cụ thể, hướng dẫn nhà sản xuất đi từ chủ thể và môi trường đến khung hình, thuộc tính, quan hệ không gian, ánh sáng, chiều sâu và tâm trạng. Với ảnh sản phẩm biên tập, yêu cầu ảnh dọc ấn tượng của ghế có dáng điêu khắc, bề mặt kim loại xước, ánh sáng bên, nền tối yên và khoảng trống phía trên vật thể cho tiêu đề. Gọi tên các quan hệ đó làm bố cục dự định rõ hơn yêu cầu chung về ảnh cao cấp.
Phạm vi sáng tạo của dòng gồm minh hoạ kể chuyện, cảnh chân thực và hình ảnh có chiều sâu với chỉ dẫn chất liệu cùng ánh sáng. Kết quả trông 3D vẫn là ảnh, không phải cảnh 3D có thể chỉnh sửa. Với áp phích đồ hoạ, chỉ định các lớp thị giác và tương tác: nền, minh hoạ hoặc ảnh chụp, thứ bậc tiêu đề và chữ bổ trợ. V4 được định vị cho cụm từ ngắn và dài vừa dễ đọc, nhưng cần kiểm tra chính tả cùng thứ bậc hoàn chỉnh thay vì suy ra từ tên mô hình.
Tài liệu tham chiếu tạo ảnh hiện hành cho phép câu lệnh tối đa 10,000 ký tự, từ một đến sáu đầu ra, seed ngẫu nhiên và tuỳ chọn màu ưu tiên cùng màu nền. Phong cách tuỳ chỉnh hoặc ảnh tham chiếu tương thích tuỳ chọn có thể định hướng diện mạo với khớp linh hoạt hoặc chính xác. Mô hình không nhận tuỳ chọn V3 cũ negative_prompt, phong cách tuyển chọn, text_layout, artistic_level hoặc no_text. Mô tả ảnh cuối dự định trong câu lệnh khẳng định và giữ yêu cầu chủ thể, bố cục cùng màu rõ ràng. 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.
Recraft công bố thao tác ảnh thành ảnh riêng cho V4. Thao tác kết hợp ảnh có sẵn và câu lệnh với strength từ 0 đến 1 để kiểm soát mức thay đổi, và không nhận tuỳ chọn phong cách tuỳ chỉnh V4 trong thao tác đó. Chuẩn bị nguồn trong giới hạn đầu vào ảnh của nhà sản xuất và nêu thuộc tính cần mang sang kết quả mới. Với tài nguyên cuối lớn hơn, kiểm tra chi tiết nhỏ, vùng cắt và chữ ở kích thước dự định. Chi tiết raster bổ sung của Pro hỗ trợ việc kiểm tra đó, trong khi ảnh vẫn là diễn giải được tạo từ bản yêu cầu sáng tạo cung cấp. 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-pro
recraft/recraft-v4-proBắt đầu
Recraft V4 Pro tạo ảnh raster 2K cho bố cục chi tiết, hình ảnh chân thực, minh hoạ và công việc sáng tạo hướng đến in ấn. Đây là phiên bản V4 độ phân giải cao hơn, với bản yêu cầu văn bản, đầu vào phong cách tuỳ chọn và quy trình ảnh thành ảnh riêng.
- Đầ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- Định dạng đầu ra
- Tệp ảnh
| 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-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ườ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ườ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ườ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— |
Tổ hợp tư liệu đầu vào
Văn bản thành ảnh · Bắt buộc: prompt
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 |
Tham sốoptional_controls | Hợp đồngaspect_ratio, n, input_references |
Tham sốexact_supported_parameters | Hợp đồng{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Tham sốreference_material_rule | Hợp đồngChỉ dùng tham chiếu ảnh thực tế của khách hàng; các điều kiện của điểm cuối nhà cung cấp chi phối việc sử dụng chúng. |
Bí danh phương thức: /v1/images
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}
Dùng mô hình chính xác và các trường đầu vào theo tài liệu.
Giữ lại toàn bộ phản hồi, mọi đầu ra thực tế và các ID gốc được trả về.
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ìnhUltra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh đầu ra | Phí Đầu ra · Đầu ra hình ảnh · Ước tính chỉ để so sánh $0.5 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.5 ướ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 →
Chi tiết giá cước tham chiếu
Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn.
Các cấu hình giá ảnh
Giá theo cấu hình
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhẢnh đầu ra | Điều kiện tính phíKhông khai báo biến thể giá. | Phí Đầu ra · Ảnh đầu ra $0.5 mỗi ảnh Các mục niêm yết tương đương mô tả cùng một khoản phí; không cộng thêm phí thứ hai. |
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-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
from openai import OpenAI
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")
request={'model': 'recraft/recraft-v4-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "recraft/recraft-v4-pro", "prompt": "a red panda astronaut floating in space, studio lighting"};
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
if(!encoded && uri.startsWith("data:image/")) {
const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
encoded=uri.slice(comma+1);
}
if(encoded) {
if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
raw=Buffer.from(encoded,"base64");
} else if(uri) {
const u=new URL(uri,"https://api.ailoot.ai");
if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
if(!response.ok) throw new Error("Image content download failed: "+response.status);
raw=Buffer.from(await response.arrayBuffer());
} else throw new Error("Image has neither bytes nor URL");
if(!raw.length) throw new Error("Empty image result");
const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";
writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
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ư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 mọi mục dữ liệu và toàn bộ mức sử dụng; tiếp nhận quyền sở hữu và lưu tất cả ảnh thực tế được trả về. Không tự tạo URL hoặc ID.
Nếu cần kiểm tra phản hồi gốc
Nếu kết quả tạo hoặc chỉnh sửa ảnh cần được kiểm tra, giữ lại operation_id/X-Client-Request-ID gốc và thông tin kết quả đã trả về. Khôi phục các kết quả hiện có thuộc quyền sở hữu của bạn qua thư viện nội dung đa phương tiện bằng các giá trị task_id hoặc asset_id thực tế. Không gửi lại yêu cầu tạo/chỉnh sửa ảnh hoặc tạo URL truy vấn trạng thái từ operation_id.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngcreated | Loạiinteger |
Trườngdata[].url | Loạistring |
Trườngdata[].b64_json | Loạibase64 string |
Trườngusage | Loạiobject |
Bí danh
Bí danh mô hình
Ailoot Ultra recraft/recraft-v4-pro
Bí danh đường dẫn phương thức
/v1/images
ID gọi liên quan
FAQ · Recraft: Recraft V4 Pro
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·recraft/recraft-v4-pro:text,image→image- Yêu cầu sử dụng những trường nào?
POST /v1/images/generations·recraft/recraft-v4-pro:model,prompt,n,aspect_ratio,input_references- Áp dụng những giới hạn nào?
POST /v1/images/generations·recraft/recraft-v4-pro:n.minimum:1;n.maximum:6