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