Recraft: Recraft V4 Styles Vector

Recraft V4 Styles Vector tạo đồ họa SVG có thể chỉnh sửa từ bản mô tả văn bản và phong cách thị giác bắt buộc. Mô hình phù hợp với biểu tượng, logo và minh họa đồng bộ có cách xử lý nét, bảng màu và cách thể hiện theo cùng hướng tham chiếu.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-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 Vector là mô hình tạo SVG trong dòng tạo ảnh nhất quán phong cách chuyên biệt của Recraft. Mô hình biến bản mô tả văn bản thành tác phẩm vector mới, đồng thời dùng phong cách tham chiếu được cung cấp để dẫn dắt cách thể hiện, logic màu sắc và diện mạo tổng thể. Mô hình hữu ích cho bộ biểu tượng đồng bộ, minh họa thương hiệu và hệ đồ họa có chủ thể thay đổi nhưng cách thể hiện vẫn cần dễ nhận ra. Phiên bản Vector trả đồ họa có thể chỉnh sửa thay vì ảnh chụp raster.

Nhà sản xuất xác định phiên bản này là recraftv4_styles_vector. Đầu ra luôn là SVG; thiết lập image_format raster không chuyển nó thành WebP hay PNG. Mỗi biến thể vector nhận mười bốn tỷ lệ khung hình trong tài liệu dưới dạng tỷ lệ rộng:cao thay vì kích thước pixel chính xác. SVG không có độ phân giải pixel cố định, nên đầu ra 1K của mô hình raster tiêu chuẩn không phải kích thước kiến trúc cho phiên bản này. Chọn hình dạng tài sản mong muốn và cách hiển thị nhỏ hay lớn dự kiến khi chuẩn bị bản mô tả.

Mỗi lần tạo đều bắt buộc có phong cách. Dùng từ một đến mười ảnh tham chiếu PNG, JPG hay WebP, hoặc một phong cách đã lưu tương thích thay cho tham chiếu mới. Nhà sản xuất từ chối yêu cầu kết hợp mã phong cách đã lưu với ảnh tham chiếu phong cách. Dung lượng tham chiếu trong tài liệu là tổng cộng 64 MB và dưới 20 MB mỗi tệp. Một biểu tượng hay minh họa rõ có thể xác lập cách thể hiện; nhiều tham chiếu hữu ích khi độ dày nét, góc, logic tô và bảng màu của chúng đã thuộc cùng hệ thị giác. 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.

Đối chiếu linh hoạt là mặc định và diễn giải tham chiếu tự do hơn, còn đối chiếu chính xác bám cách thể hiện, màu sắc, bố cục và ánh sáng sát hơn. Với hệ vector, dùng prompt để xác định loại đồ họa, đường bao, số vật thể và bố cục. Với bộ biểu tượng điều hướng, dùng nét viền đậm bo tròn, một vật thể giữa mỗi ảnh và bảng hai màu. Giữ cùng phong cách tham chiếu và thay vật thể được nêu trong từng bản mô tả, thay vì trộn tham chiếu không liên quan để có sự đa dạng.

Tài liệu tạo ảnh cho phép prompt tối đa 10,000 ký tự, từ một đến sáu đầu ra, seed ngẫu nhiên, màu ưu tiên và màu nền mong muốn. Câu lệnh phủ định, tên phong cách tuyển chọn và thiết lập text_layout cũ không được hỗ trợ. Phiên bản Styles này cũng không cung cấp ảnh-sang-ảnh hay chỉnh vùng ảnh: ảnh tham chiếu cung cấp ngôn ngữ thị giác, không phải vùng cần xóa hoặc đồ họa có sẵn cần giữ nguyên. Chỉ dẫn cấu trúc trong bản mô tả khẳng định cần mô tả tài sản hoàn chỉnh dự kiến.

Kiểm tra SVG ở kích thước sẽ sử dụng, nhất là khi thiết kế có chữ, khe hẹp hoặc chi tiết nhỏ. Không bảo đảm màu khớp tham chiếu và các tham chiếu không liên quan có thể cạnh tranh nhau. Với bộ biểu tượng trở nên lặp lại, đổi vật thể, tư thế hoặc cách sắp xếp trong prompt, đồng thời giữ phong cách nhất quán. Sản phẩm hữu ích là tài sản vector đồng bộ có thể chỉnh hình và đổi màu trong quy trình thiết kế, với hình học và độ dễ đọc được đánh giá theo bản yêu cầu.

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-vector

recraft/recraft-v4-styles-vector

Khác /recraft/recraft-v4-styles-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-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.1 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.1 ướ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-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-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-vector

FAQ · Recraft: Recraft V4 Styles Vector

Có những đầu vào và kết quả nào?: POST /v1/images/generations · recraft/recraft-v4-styles-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-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-vector: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Vector