Recraft: Recraft V4 Styles Pro Vector
Recraft V4 Styles Pro Vector เป็นรุ่น SVG แบบ Pro ในตระกูลภาพที่รักษาสไตล์สม่ำเสมอของ Recraft สร้างกราฟิกเวกเตอร์ที่แก้ไขได้จากบรีฟข้อความและสไตล์อ้างอิงที่จำเป็น สำหรับภาพประกอบแบรนด์ ตัวอักษร และชุดชิ้นงานกราฟิกที่มีรายละเอียดและใช้แนวทางร่วมกัน
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Recraft V4 Styles Pro Vector เป็นโมเดลเวกเตอร์ Pro ในตระกูล V4 Styles โดยเฉพาะ มีวัตถุประสงค์เพื่อสร้างงาน SVG ใหม่ที่ใช้แนวทางภาพตามสไตล์อ้างอิงที่ให้มา โมเดลรวมคำอธิบายข้อความว่าจะวาดอะไรกับภาพอ้างอิงที่กำหนดว่าควรมีลักษณะอย่างไร งานใช้งานจริงรวมถึงภาพประกอบแบรนด์ แนวคิดตัวอักษร และชุดชิ้นงานกราฟิกที่ต้องใช้ทิศทางร่วมกันด้านพื้นผิว วิธีเรนเดอร์ หลักการใช้สี และองค์ประกอบภาพ
รหัสโมเดลของผู้ผลิตที่ตรงคือ recraftv4_styles_pro_vector ซึ่งแยกจากทั้งโมเดล Styles Vector มาตรฐานและโมเดลแรสเตอร์ Styles Pro ผลลัพธ์เป็น SVG ที่แก้ไขได้ เอกสารอ้างอิงขนาดของผู้ผลิตระบุชัดว่าเอาต์พุตเวกเตอร์ไม่มีขนาดพิกเซลตายตัวและรับเฉพาะอัตราส่วนภาพ ดังนั้นขนาดแรสเตอร์ 2K ของ Styles Pro จึงไม่ใช่คำรับรองความละเอียดพิกเซลของรุ่น Pro Vector นี้ ป้าย Pro เป็นของเวกเตอร์รุ่นตามชื่อนี้ เตรียมชิ้นงานตามเรขาคณิตและการใช้งานที่ต้องการ แทนการมองว่าเป็นบิตแมปขยายใหญ่
การสร้างด้วย Styles ทุกครั้งต้องมีสไตล์ สามารถใช้สไตล์ที่บันทึกไว้ซึ่งเข้ากันได้ หรือภาพอ้างอิง PNG, JPG หรือ WebP หนึ่งถึงสิบภาพ โดยสองอินพุตนี้เป็นทางเลือกแทนกัน ตามเวิร์กโฟลว์ที่ระบุในเอกสาร ภาพอ้างอิงแต่ละภาพต้องต่ำกว่า 20 MB และรวมกันไม่เกิน 64 MB เลือกภาพประกอบสะอาดเพียงภาพเดียวเมื่อทิศทางชัดเจนอยู่แล้ว หากต้องใช้หลายภาพ ให้เลือกชิ้นงานที่รูปทรง ชุดสี และวิธีเรนเดอร์สอดคล้องกัน เพื่อให้โมเดลสรุปภาษาภาพนั้นแทนการนำลวดลายที่ขัดกันมาประกอบ ภาพอ้างอิงแต่ละภาพต้องมีด้านสั้นอย่างน้อย 256 พิกเซล ด้านยาวไม่เกิน 4,096 พิกเซล และความละเอียดรวมไม่เกิน 16 เมกะพิกเซล
เลือกการจับคู่แบบ precise เมื่อต้องการให้แนวทางภาพอ้างอิงนำผลลัพธ์อย่างใกล้ชิด หรือใช้ค่าเริ่มต้น flexible เมื่อการตีความที่หลวมกว่ามีประโยชน์ พรอมป์ต์ยังคงควบคุมตัวแบบใหม่ การจัดวาง ท่าทาง และฉาก สำหรับงานเวกเตอร์เชิงบรรณาธิการที่มีรายละเอียด ให้ขอตราพฤกษศาสตร์ตรงกลางที่มีใบใหญ่สามใบ รูปเงากะทัดรัด และระบบสองสีที่จำกัด ระบุลำดับชั้นและความสัมพันธ์ของรูปทรงอย่างชัดเจน ภาพอ้างอิงสไตล์เพียงอย่างเดียวไม่ได้อธิบายการตัดสินใจด้านเนื้อหาใหม่เหล่านั้น
ผู้ผลิตรองรับตัวควบคุมสีที่ต้องการและสีพื้นหลัง seed แบบสุ่ม พรอมป์ต์ยาวไม่เกิน 10,000 อักขระ และผลลัพธ์หนึ่งถึงหกชิ้นต่อการสร้าง ผลลัพธ์เวกเตอร์ยังเป็น SVG ไม่ว่าจะตั้งค่า image_format สำหรับแรสเตอร์อย่างไร สาย Styles โดยเฉพาะไม่รองรับ image-to-image หรือ inpainting และไม่รับกลไกเก่าอย่าง curated-style, negative_prompt หรือ text_layout ดังนั้นการจับคู่ภาพอ้างอิงกับการแก้ภาพวาดที่มีอยู่จึงเป็นคนละการดำเนินการ ไม่ใช่ความหมายของอินพุตภาพที่ใช้แทนกันได้
ใช้ภาพอ้างอิงที่ชัดเจนและมีความละเอียดสูง ไม่มีการรับประกันการทำสีให้ตรงทุกประการ ระบุการใช้งานที่ตั้งใจไว้ในบรีฟ โลโก้ต้องมีรูปทรงที่อ่านได้เมื่อขนาดเล็ก ส่วนภาพประกอบเชิงบรรณาธิการอาจมีรายละเอียดมากกว่าได้ ตรวจตัวอักษร ระยะห่าง รูปเงา และพื้นที่สีของ SVG ในองค์ประกอบภาพเป้าหมาย แล้วปรับบรีฟข้อความเมื่อตัวแบบหรือเลย์เอาต์ต้องเปลี่ยน ใช้สไตล์เดิมที่เข้ากันได้ซ้ำสำหรับชิ้นงานถัดไป แทนการเพิ่มภาพอ้างอิงที่ไม่เกี่ยวข้องเพื่อบังคับให้เกิดความหลากหลาย
ผ่าน Ailoot ให้เลือก ID โมเดลนี้ให้ตรงใน /v1/images/generations และส่งพรอมป์ต์สร้างสรรค์ เก็บทุกรายการ data ที่ได้รับ ไม่ว่าคำตอบจะมี URL หรือเนื้อหาภาพที่เข้ารหัส และบันทึกไบต์จริงพร้อมชนิดเนื้อหาที่ได้รับ เก็บ usage และ media task_id ที่มีไว้กับชิ้นงาน แล้วตรวจรูปทรง ตัวอักษร และพื้นที่สีในงานออกแบบที่ตั้งใจ
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-pro-vector
recraft/recraft-v4-styles-pro-vector
recraft/recraft-v4-styles-pro-vectorเริ่มต้น
Recraft V4 Styles Pro Vector เป็นรุ่น SVG แบบ Pro ในตระกูลภาพที่รักษาสไตล์สม่ำเสมอของ Recraft สร้างกราฟิกเวกเตอร์ที่แก้ไขได้จากบรีฟข้อความและสไตล์อ้างอิงที่จำเป็น สำหรับภาพประกอบแบรนด์ ตัวอักษร และชุดชิ้นงานกราฟิกที่มีรายละเอียดและใช้แนวทางร่วมกัน
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- รูปภาพ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · Images POST /v1/images/generations
- ขาเข้า
text,image- ขาออก
image- รูปแบบเอาต์พุต
- ไฟล์ภาพ
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด recraft/recraft-v4-styles-pro-vector เงื่อนไข: ใช้ตัวเลือกระบุเส้นทางของ Ailoot นี้ตามที่ระบุไว้ทุกตัวอักษร | ค่าเริ่มต้น— |
ฟิลด์prompt | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์n | ประเภทinteger | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขั้นต่ำ: 1 สูงสุด: 6 เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์aspect_ratio | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์output_format | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด svg เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์input_references | ประเภทarray | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์quality | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด auto, low, medium, high, xhigh, max เงื่อนไข: | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
reference_guided_image
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์content_type | ข้อกำหนดapplication/json |
พารามิเตอร์required | ข้อกำหนดmodel, prompt, input_references |
พารามิเตอร์optional | ข้อกำหนดn, aspect_ratio, output_format, quality |
พารามิเตอร์material_types | ข้อกำหนดtext, image |
พารามิเตอร์conditions | ข้อกำหนดใช้ตัวเลือกระบุเส้นทางของ Ailoot นี้ตามที่ระบุไว้ทุกตัวอักษร, quality เป็นตัวควบคุมทั่วไปที่ระบุไว้ในเอกสาร ผู้ให้บริการที่ไม่มีการตั้งค่าคุณภาพจะละเลยค่านี้ ไม่มีการรับประกันว่าคุณภาพจะดีขึ้นในแต่ละโมเดล |
วงจรการทำงาน: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id ที่ส่งกลับมาจริง หรือรายการในคลังที่เลือก ส่วน operation_id เป็นตัวระบุอีกตัวหนึ่ง
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
ราคา
วิธีคำนวณค่าบริการสุดท้าย
อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ
ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก
- โหมดรวดเร็ว
- ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
- โหมดยืดหยุ่น
- ไม่ได้ระบุ เมื่อเลือกโหมด flex
- ระดับการใช้เหตุผลสูงสุด
- ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด
อัตราประมาณการเพื่อเปรียบเทียบ
ราคาตามการตั้งค่า
เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน
| การตั้งค่า | ตารางอัตราค่าบริการ | ปริมาณคาดการณ์ | หน่วยคิดค่าบริการ | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|---|---|---|
| การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน | ตารางอัตราค่าบริการอัตราพื้นฐาน | ปริมาณคาดการณ์— | หน่วยคิดค่าบริการ— | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น |
| การตั้งค่าข้อมูลอ้างอิงขาเข้า | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | หน่วยคิดค่าบริการต่อคำขอ | เงื่อนไขคิดค่าบริการการสร้างสไตล์เมื่อสร้างด้วยข้อมูลอ้างอิงสไตล์ คิดครั้งเดียวต่อคำขอ เพิ่มจากราคาภาพขาออก | ค่าบริการ ขาเข้า · ข้อมูลอ้างอิงขาเข้า · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.01 ต่อคำขอ เป็นเพียงค่าประมาณเพื่ออ้างอิง ค่าบริการสุดท้ายอ้างอิงใบแจ้งหนี้ต้นฉบับที่บันทึกไว้ |
| การตั้งค่าภาพขาออก | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | หน่วยคิดค่าบริการต่อภาพเอาต์พุต | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · ภาพขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.24 ต่อภาพเอาต์พุต |
| การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | หน่วยคิดค่าบริการ— | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.24 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
ตัวอย่างคำขอ
Ailoot Ultra · Images
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.
รับและบันทึกผลลัพธ์
Ailoot Ultra · Images
ดาวน์โหลดภาพที่ส่งกลับมาทุกภาพ หรือบันทึกเนื้อหา Base64 ของภาพนั้น
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด
บันทึกภาพที่สร้างเสร็จทุกภาพ โดยดึงภาพจากทุก URL ที่ส่งกลับมา หรือถอดรหัสเนื้อหา Base64
เก็บการตอบกลับและส่วนหัวทั้งหมด ตัวระบุเดิม ผลลัพธ์จริงทุกรายการ และฟิลด์การใช้งาน/การคิดบัญชีทั้งหมด บันทึกแอสเซ็ตที่เป็นของคุณแต่ละชิ้นโดยไม่ซ้ำ และเก็บทุกบทบาทที่ชี้ไปยังแอสเซ็ตนั้น
เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ
เก็บ X-Client-Request-ID คำตอบ และส่วนหัวต้นฉบับไว้ ผลลัพธ์ที่ไม่ทราบหรือ result_pending_check ไม่ได้อนุญาตให้สร้างครั้งที่สอง
ฟิลด์การตอบกลับ
| ฟิลด์ | ประเภท |
|---|---|
ฟิลด์data[].url | ประเภทstring |
ฟิลด์data[].b64_json | ประเภทstring |
ฟิลด์usage | ประเภทobject |
ข้อผิดพลาดและขั้นตอนถัดไป
| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
|---|---|---|
การตอบกลับ400 · invalid_request_error | เงื่อนไขฟิลด์ที่จำเป็น ตัวเลือกโมเดล ชนิดข้อมูล หรือรูปแบบการแทนข้อมูลขาเข้าไม่ถูกต้อง | ขั้นตอนถัดไปตรวจสอบรายละเอียดการตรวจสอบความถูกต้องที่ส่งกลับมาก่อนเตรียมคำขอแยกต่างหาก |
การตอบกลับ | เงื่อนไขไม่ทราบคำขอหรือผลลัพธ์ต้นฉบับ หรือจำเป็นต้องตรวจสอบ | ขั้นตอนถัดไปเก็บตัวระบุและส่วนหัวเดิมไว้ อ่านเฉพาะข้อมูลสถานะหรือรายการในคลังที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot Ultra recraft/recraft-v4-styles-pro-vector
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Recraft: Recraft V4 Styles Pro Vector
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:text,image→image- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- มีข้อจำกัดใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-pro-vector:n.minimum:1;n.maximum:6