Recraft: Recraft V4.1 Pro Vector
Recraft V4.1 Pro Vector tạo tác phẩm SVG có thể chỉnh sửa cho logo, chữ và minh họa chi tiết. Đây là phiên bản vector Pro của dòng V4.1, kết hợp prompt văn bản với đầu vào ảnh và phong cách tùy chọn, đồng thời giữ sản phẩm ở dạng 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.1 Pro Vector là phiên bản SVG Pro của dòng tạo ảnh V4.1 từ Recraft. Mô hình dành cho công việc cần giữ kết quả ở dạng tác phẩm vector có thể chỉnh sửa: logo, ý tưởng kiểu chữ, biểu tượng hoặc minh họa. Phần giới thiệu V4.1 của nhà sản xuất nhấn mạnh bố cục có chủ đích và minh họa, còn tài liệu đúng mô hình xác định biến thể này riêng với các phiên bản Vector tiêu chuẩn, raster Pro và Utility. Ảnh cuối là SVG thay vì bản xuất raster độ phân giải cao.
Mã mô hình của nhà sản xuất là recraftv4_1_pro_vector. Đầu ra vector không có kích thước pixel cố định; tài liệu kích thước nhận mười bốn tỷ lệ rộng:cao cho mô hình vector và không nhận kích thước pixel chính xác. Vì vậy, thiết lập raster 2K của Pro không xác định độ phân giải SVG của phiên bản này. Nêu tỷ lệ dự kiến và cách tác phẩm sẽ được sử dụng. Với logo, sản phẩm quan trọng là đường bao dễ nhận biết cùng vùng màu có thể chỉnh sửa trong quy trình thiết kế.
Mô hình hỗ trợ tạo ảnh từ văn bản và tham chiếu phong cách tùy chỉnh tùy chọn. Dung lượng prompt trong tài liệu là 10,000 ký tự. Màu ưu tiên, màu nền mong muốn và seed ngẫu nhiên có thể dẫn dắt việc tạo; quy trình cho phép từ một đến sáu đầu ra. Phong cách đã lưu tương thích hoặc ảnh tham chiếu có thể xác lập ngôn ngữ thị giác; phong cách phải tương thích với mô hình mà phong cách đó được tạo để sử dụng. Dòng V4.1 chính không bắt buộc phong cách tham chiếu trong mọi yêu cầu, khác dòng V4 Styles chuyên biệt. 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 dung lượng không quá 64 MB và mỗi ảnh dưới 20 MB. Mỗi ảnh tham chiếu cần 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à độ phân giải không quá 16 megapixel. Dùng các ảnh tham chiếu này hoặc một phong cách đã lưu tương thích, không dùng cả hai. Với tạo ảnh theo phong cách tham chiếu, đối chiếu linh hoạt cho phép diễn giải tự do hơn, còn đối chiếu chính xác bám sát cách thể hiện, bảng màu, bố cục và ánh sáng hơn.
Bản mô tả vector hữu ích xác định loại đồ họa, logic hình dạng, bảng màu, cách xử lý nét và cách sắp xếp trước khi thêm chi tiết trang trí. Với biểu trưng cửa hàng làm vườn, yêu cầu một đường bao mầm cây, hình học bo tròn, hai màu phẳng và cụm biểu trưng ở giữa. Với chữ, đính kèm đúng từ và mô tả thứ bậc, hình dạng, rồi kiểm tra khoảng rỗng trong chữ, khoảng cách và độ rõ ở kích thước nhỏ trong SVG trả về. Ví dụ vector của nhà sản xuất hỗ trợ kiểu chữ biểu cảm và minh họa; chúng không bảo đảm mọi chữ hay đường vector được tạo đã là tác phẩm hoàn thiện.
Recraft mô tả quy trình ảnh-sang-ảnh riêng cho mô hình raster và vector V4.1. Quy trình kết hợp ảnh có sẵn với prompt, dùng strength từ 0 đến 1 để điều khiển kết quả mới khác bản gốc bao xa. strength thấp giữ gần nguồn hơn và strength cao cho phép đổi nhiều hơn. Thao tác đó không nhận thiết lập phong cách tùy chỉnh V4/V4.1, vì vậy cần chuẩn bị biến đổi ảnh nguồn và tạo ảnh theo phong cách tham chiếu thành các quy trình riêng. Ảnh đầu vào có thể là PNG, JPG, WebP hoặc SVG trong giới hạn ảnh theo tài liệu. Với ảnh-sang-ảnh, cung cấp PNG, JPG, WebP hoặc SVG dưới 20 MB, không quá 16 megapixel, cả hai cạnh từ 256 đến 4,096 pixel.
V4.1 không hỗ trợ tên phong cách tuyển chọn, negative_prompt, text_layout, artistic_level hay no_text. Nêu cách sắp xếp và chữ dự kiến trong bản mô tả khẳng định thay vì dựa vào cơ chế V3 cũ. Với tài sản thương hiệu chi tiết, dùng SVG làm tệp làm việc, kiểm tra hình học và điều chỉnh màu hoặc hình khi cần trước khi đặt vào bố cục cuối. Phiên bản Pro Vector này giữ danh tính riêng; nó không thể thay thế cho biến thể raster tiêu chuẩn hay Utility chỉ vì cùng tên V4.1.
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.1-pro-vector
recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vectorBắt đầu
Recraft V4.1 Pro Vector tạo tác phẩm SVG có thể chỉnh sửa cho logo, chữ và minh họa chi tiết. Đây là phiên bản vector Pro của dòng V4.1, kết hợp prompt văn bản với đầu vào ảnh và phong cách tùy chọn, đồng thời giữ sản phẩm ở dạng vector.
- Đầ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ườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn recraft/recraft-v4.1-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ườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: | 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 Điều kiện: | 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 Điều kiện: | Mặc định— |
Trườngoutput_format | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn svg Điều kiện: | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: | Mặc định— |
Trườngquality | Loạistring | 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
Văn bản thành ả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ốoptional | Hợp đồngn, aspect_ratio, output_format, input_references, 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í | 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.6 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.6 ướ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
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=json.loads('{"model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
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/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 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ườngdata[].url | Loạistring |
Trườngdata[].b64_json | Loạistring |
Trườngusage | 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.1-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
FAQ · Recraft: Recraft V4.1 Pro Vector
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·recraft/recraft-v4.1-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.1-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.1-pro-vector:n.minimum:1;n.maximum:6