Recraft: Recraft V4 Styles Pro Vector

Recraft V4 Styles Pro Vector là phiên bản SVG Pro của dòng tạo ảnh nhất quán phong cách từ Recraft. Mô hình tạo đồ họa vector có thể chỉnh sửa từ bản mô tả văn bản và phong cách tham chiếu bắt buộc cho minh họa thương hiệu chi tiết, chữ và các tài sản đồ họa đồng bộ.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector

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 Vector là mô hình vector Pro trong dòng V4 Styles chuyên biệt. Mục đích là tạo tác phẩm SVG mới có cách thể hiện trực quan theo phong cách tham chiếu được cung cấp. Mô hình kết hợp mô tả văn bản về nội dung cần vẽ với tham chiếu xác lập diện mạo. Ứng dụng thực tế gồm minh họa thương hiệu, ý tưởng chữ và tài sản đồ họa đồng bộ khi kết cấu, cách thể hiện, logic màu sắc và bố cục cần cùng định hướng.

Mã mô hình chính xác của nhà sản xuất là recraftv4_styles_pro_vector, riêng biệt với cả mô hình Styles Vector tiêu chuẩn và mô hình raster Styles Pro. Mô hình trả SVG có thể chỉnh sửa. Tài liệu kích thước nêu rõ đầu ra vector không có kích thước pixel cố định và chỉ nhận tỷ lệ khung hình, nên kích thước raster 2K của Styles Pro không phải cam kết độ phân giải pixel cho phiên bản Pro Vector này. Nhãn Pro thuộc đúng biến thể vector được nêu; hãy chuẩn bị tác phẩm theo hình học và cách sử dụng dự kiến thay vì coi đó là bitmap phóng lớn.

Mỗi lần tạo bằng Styles đều cần phong cách. Có thể dùng một phong cách đã lưu tương thích hoặc từ một đến mười ảnh tham chiếu PNG, JPG hay WebP; hai kiểu đầu vào này thay thế cho nhau. Theo quy trình trong tài liệu, mỗi ảnh tham chiếu phải dưới 20 MB và tổng dung lượng không quá 64 MB. Ưu tiên một minh họa rõ ràng khi hướng thể hiện đã xác định. Nếu cần nhiều tham chiếu, chọn tài sản nhất quán về hình dạng, bảng màu và cách thể hiện để mô hình khái quát ngôn ngữ thị giác đó thay vì ghép các mô-típ cạnh tranh. Mỗi tham chiếu phải có cạnh ngắn nhất ít nhất 256 pixel, cạnh dài nhất không quá 4,096 pixel và tổng độ phân giải không quá 16 megapixel.

Chọn đối chiếu chính xác khi cách thể hiện tham chiếu cần dẫn dắt đầu ra sát, hoặc đối chiếu linh hoạt mặc định khi cách diễn giải tự do hơn có ích. Prompt vẫn điều khiển chủ thể mới, cách sắp xếp, tư thế và cảnh. Với tác phẩm vector biên tập chi tiết, yêu cầu biểu trưng thực vật ở giữa với ba lá lớn, đường bao gọn và hệ hai màu tiết chế. Nêu rõ thứ bậc và quan hệ hình dạng; chỉ tham chiếu phong cách không mô tả các quyết định nội dung mới đó.

Nhà sản xuất hỗ trợ thiết lập màu ưu tiên và màu nền, seed ngẫu nhiên, prompt tối đa 10,000 ký tự và từ một đến sáu đầu ra mỗi lần tạo. Kết quả vector vẫn là SVG bất kể thiết lập image_format raster. Dòng Styles chuyên biệt không hỗ trợ ảnh-sang-ảnh hay chỉnh vùng ảnh, cũng không nhận các cơ chế cũ gồm phong cách tuyển chọn, negative_prompt hoặc text_layout. Vì vậy, đối chiếu tham chiếu và sửa bản vẽ có sẵn là những thao tác khác nhau, không phải các ý nghĩa thay thế cho nhau của đầu vào ảnh.

Dùng ảnh tham chiếu rõ, độ phân giải cao; không bảo đảm tái hiện màu chính xác. Giữ mục đích sử dụng rõ trong yêu cầu: logo cần hình dạng dễ đọc ở kích thước nhỏ, còn minh họa biên tập có thể cho phép nhiều chi tiết hơn. Kiểm tra chữ, khoảng cách, đường bao và vùng màu của SVG trong bố cục đích, rồi tinh chỉnh bản mô tả văn bản khi cần đổi chủ thể hoặc bố cục. Dùng lại cùng phong cách tương thích cho tài sản sau thay vì thêm ảnh tham chiếu không liên quan để ép biến thể.

Qua Ailoot, chọn đúng ID mô hình này trong /v1/images/generations và cung cấp prompt sáng tạo. Giữ mọi phần tử data trả về, dù phản hồi chứa URL hay nội dung ảnh mã hóa, và lưu byte thực tế cùng kiểu nội dung trả về tương ứng. Giữ usage và mọi task_id của tác vụ đa phương tiện cùng tài sản, rồi kiểm tra hình dạng, chữ và vùng màu trong thiết kế dự kiến.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector

recraft/recraft-v4-styles-pro-vector

Khác /recraft/recraft-v4-styles-pro-vector

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 · Images 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ường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn recraft/recraft-v4-styles-pro-vector Điều kiện: Dùng chính xác bộ chọn định tuyến Ailoot này.	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện:	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 Điều kiện:	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 Điều kiện:	Mặc định—
Trường`output_format`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn svg Điều kiện:	Mặc định—
Trường`input_references`	Loại`array`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện:	Mặc định—
Trường`quality`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn auto, low, medium, high, xhigh, max Điều kiện:	Mặc định—

Tổ hợp tư liệu đầu vào

reference_guided_image

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, input_references
Tham số`optional`	Hợp đồngn, aspect_ratio, output_format, quality
Tham số`material_types`	Hợp đồngtext, image
Tham số`conditions`	Hợp đồngDùng chính xác bộ chọn định tuyến Ailoot này., quality là tham số điều khiển phổ biến được mô tả trong tài liệu; nhà cung cấp không có thiết lập chất lượng sẽ bỏ qua tham số này. Không có cam kết cải thiện chất lượng cho từng mô hình.

Vòng đời: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id thực tế được trả về hoặc bản ghi đã chọn trong thư viện; operation_id là mã định danh riêng

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 Chỉ là ước tính tham khảo; phí cuối cùng tính theo hóa đơn gốc đã ghi nhận.
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.24 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.24 ướ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 · Images

curl · chỉ tạo một lần và giữ lại kết quả đầy đủ

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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
# Submit once. Retain the complete result, original identifiers and every response header.

Nhận và lưu kết quả

Ailoot Ultra · Images

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
GET /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 toàn bộ phản hồi và tiêu đề, các mã định danh gốc, mọi đầu ra thực tế và tất cả trường mức sử dụng/hạch toán. Lưu từng tài sản duy nhất thuộc quyền sở hữu và giữ lại mọi vai trò tham chiếu đến tài sản đó.

Nếu cần kiểm tra phản hồi gốc

Giữ nguyên X-Client-Request-ID gốc, phản hồi và các trường tiêu đề. Kết quả không xác định hoặc result_pending_check không cho phép tạo lần thứ hai.

Trường phản hồi

Trường	Loại
Trường`data[].url`	Loạistring
Trường`data[].b64_json`	Loạistring
Trường`usage`	Loạiobject

Lỗi và bước tiếp theo

Phản hồi	Điều kiện	Bước tiếp theo
Phản hồi400 · `invalid_request_error`	Điều kiệnTrường bắt buộc, bộ chọn mô hình, kiểu dữ liệu hoặc cách biểu diễn đầu vào không hợp lệ.	Bước tiếp theoXem chi tiết kết quả kiểm tra tính hợp lệ được trả về trước khi chuẩn bị một yêu cầu riêng.
Phản hồi	Điều kiệnYêu cầu hoặc kết quả gốc chưa xác định hoặc cần kiểm tra.	Bước tiếp theoGiữ nguyên các mã định danh và trường tiêu đề gốc; chỉ đọc các bản ghi trạng thái/thư viện được hỗ trợ. Không gửi lại yêu cầu tạo.

Bí danh

Bí danh mô hình

Ailoot Ultra recraft/recraft-v4-styles-pro-vector

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

Dùng các đường dẫn phương thức hiển thị ở trên.

ID gọi liên quan

recraft/recraft-v4-styles-pro-vector

FAQ · Recraft: Recraft V4 Styles Pro Vector

Có những đầu vào và kết quả nào?: POST /v1/images/generations · recraft/recraft-v4-styles-pro-vector: 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-vector: model, prompt, n, aspect_ratio, output_format, input_references, quality
Áp dụng những giới hạn nào?: POST /v1/images/generations · recraft/recraft-v4-styles-pro-vector: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro Vector