Recraft: Recraft V4.1 Vector
Recraft V4.1 Vector tạo logo SVG, chữ và minh họa có thể chỉnh sửa từ văn bản, với đầu vào ảnh và phong cách tùy chọn. Đây là phiên bản vector tiêu chuẩn của V4.1 cho đồ họa cần hình học co giãn và điều chỉnh thiết kế về sau.
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 Vector là mô hình SVG tiêu chuẩn trong dòng V4.1 của Recraft. Vai trò của mô hình là tạo minh họa, logo và chữ có thể chỉnh hình, đổi màu và dùng làm tài sản vector. Mô hình nhận bản mô tả văn bản và có thể làm việc với đầu vào ảnh qua các quy trình phong cách hoặc ảnh-sang-ảnh được nhà sản xuất mô tả. SVG kết quả là sản phẩm khác với ảnh raster WebP hay PNG của V4.1; nên nhận diện phiên bản này bằng định dạng vector thay vì nhãn độ phân giải raster.
Biến thể chính xác là recraftv4_1_vector, riêng với recraftv4_1_pro_vector và các mô hình Utility Vector. Hướng dẫn kích thước nêu mọi biến thể vector nhận mười bốn tỷ lệ khung hình dưới dạng tỷ lệ rộng:cao và tạo SVG không có kích thước pixel cố định. Dùng tỷ lệ đó để xác lập bố cục mong muốn, chẳng hạn biểu tượng vuông hay logo ngang. Sau đó có thể chọn kích thước hiển thị trong quy trình thiết kế thay vì bị cố định bởi đầu ra raster 1K.
Nhà sản xuất định vị V4.1 Vector cho kiểu chữ biểu cảm và minh họa rõ gọn. Bản yêu cầu hữu ích nêu vật thể hoặc từ, đặc điểm hình học, độ dày nét, cách tô và hệ màu. Với biểu tượng tiệm bánh, yêu cầu đồ họa nhỏ có một nhánh bông lúa cong, đường bao đậm và vùng tô hai màu ấm. Nêu rõ quan hệ không gian quan trọng thay vì dựa vào cụm chung như logo hiện đại. Với một họ biểu tượng, giữ quy tắc cấu trúc ổn định và thay vật thể được nêu.
Phong cách tùy chỉnh tùy chọn có thể dẫn dắt cùng cách thể hiện qua phong cách đã lưu tương thích hoặc ảnh tham chiếu. V4.1 hỗ trợ màu ưu tiên, màu nền mong muốn, seed ngẫu nhiên và prompt tối đa 10,000 ký tự; quy trình tạo có thể trả từ một đến sáu đầu ra. Phong cách tham chiếu là tùy chọn cho mô hình dòng chính này và phải tương thích với mô hình dùng để tạo ra nó. Dùng tham chiếu rõ ràng từ cùng thế giới thị giác; không bảo đảm màu đầu ra khớp chính xác với tham chiếu. 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.
Thao tác ảnh-sang-ảnh riêng có thể trả SVG khi chọn mô hình vector V4.1. Cung cấp ảnh có sẵn và mô tả thay đổi mong muốn, với strength từ 0 đến 1 chỉ kết quả có thể khác nguồn bao xa. Thao tác hỗ trợ đầu vào PNG, JPG, WebP hoặc SVG dưới 20 MB, tối đa 16 MP, các cạnh từ 256 đến 4096 pixel. Các thiết lập đối chiếu phong cách V4.1 không được hỗ trợ trong thao tác biến đổi đó; tham chiếu phong cách để tạo ảnh và ảnh cần biến đổi có vai trò khác nhau.
Tài liệu V4.1 hiện tại loại trừ tên phong cách tuyển chọn, negative_prompt, text_layout, artistic_level và no_text. Mô tả bố cục và chữ mong muốn theo hướng khẳng định thay vì chuyển thiết lập từ V3. Kiểm tra logo hoặc minh họa được tạo dưới dạng SVG: chữ, đường bao, vùng màu và chi tiết nhỏ cần phù hợp với bố cục thực tế. Lợi thế thực tế là một điểm khởi đầu vector có thể chỉnh sửa theo bản yêu cầu thiết kế cụ thể, không phải giả định rằng mọi đồ họa trả về đều không cần hoàn thiện.
Qua Ailoot, chọn đúng ID mô hình này trong /v1/images/generations và cung cấp prompt sáng tạo. Cấu hình ảnh tham chiếu được liệt kê của Ailoot nhận mảng input_references tùy chọn chứa tối đa một mục image_url. 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-vector
recraft/recraft-v4.1-vectorBắt đầu
Recraft V4.1 Vector tạo logo SVG, chữ và minh họa có thể chỉnh sửa từ văn bản, với đầu vào ảnh và phong cách tùy chọn. Đây là phiên bản vector tiêu chuẩn của V4.1 cho đồ họa cần hình học co giãn và điều chỉnh thiết kế về sau.
- Đầ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-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.16 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.16 ướ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-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-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 Vector
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·recraft/recraft-v4.1-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-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-vector:n.minimum:1;n.maximum:6