Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector สร้างกราฟิก SVG ที่แก้ไขได้จากบรีฟข้อความและสไตล์ภาพที่จำเป็น เหมาะกับชุดไอคอน โลโก้ และภาพประกอบที่ต้องใช้แนวทางเส้น ชุดสี และการเรนเดอร์ตามภาพอ้างอิงเดียวกัน
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Recraft V4 Styles Vector เป็นโมเดลที่สร้าง SVG ในสายการสร้างที่รักษาสไตล์สม่ำเสมอโดยเฉพาะของ Recraft เปลี่ยนบรีฟข้อความเป็นงานเวกเตอร์ใหม่ โดยใช้สไตล์อ้างอิงที่ให้มาเพื่อนำการเรนเดอร์ หลักการใช้สี และรูปลักษณ์โดยรวม เหมาะกับชุดไอคอน ภาพประกอบแบรนด์ และระบบกราฟิกที่เปลี่ยนตัวแบบแต่ต้องให้แนวทางภาพยังจดจำได้ รุ่น Vector ส่งกลับกราฟิกที่แก้ไขได้แทนภาพถ่ายแรสเตอร์
ผู้ผลิตระบุรุ่นนี้เป็น recraftv4_styles_vector เอาต์พุตเป็น SVG เสมอ การตั้งค่า image_format สำหรับแรสเตอร์ไม่แปลงผลลัพธ์เป็น WebP หรือ PNG เวกเตอร์ทุกรุ่นรับอัตราส่วนภาพสิบสี่แบบตามเอกสารในรูปความกว้างต่อความสูง แทนขนาดพิกเซลที่แน่นอน SVG ไม่มีความละเอียดพิกเซลตายตัว ดังนั้นเอาต์พุต 1K ของโมเดลแรสเตอร์มาตรฐานจึงไม่ใช่ขนาดเชิงสถาปัตยกรรมของรุ่นนี้ เลือกรูปร่างชิ้นงานและการแสดงผลขนาดเล็กหรือใหญ่ที่ตั้งใจเมื่อเตรียมบรีฟ
การสร้างแต่ละครั้งต้องมีสไตล์ ใช้ภาพอ้างอิง PNG, JPG หรือ WebP หนึ่งถึงสิบภาพ หรือใช้สไตล์ที่บันทึกไว้ซึ่งเข้ากันได้แทนภาพอ้างอิงใหม่ ผู้ผลิตปฏิเสธคำขอที่รวมตัวระบุสไตล์ที่บันทึกไว้กับภาพอ้างอิงสไตล์ ขอบเขตภาพอ้างอิงตามเอกสารคือรวมไม่เกิน 64 MB และแต่ละไฟล์ต่ำกว่า 20 MB ไอคอนหรือภาพประกอบที่ชัดเจนเพียงชิ้นเดียวสามารถกำหนดแนวทางภาพได้ หลายภาพมีประโยชน์เมื่อความหนาเส้น มุม หลักการลงสี และชุดสีอยู่ในระบบภาพเดียวกันอยู่แล้ว ภาพอ้างอิงแต่ละภาพต้องมีด้านสั้นอย่างน้อย 256 พิกเซล ด้านยาวไม่เกิน 4,096 พิกเซล และความละเอียดรวมไม่เกิน 16 เมกะพิกเซล
การจับคู่ flexible เป็นค่าเริ่มต้นและตีความภาพอ้างอิงหลวมกว่า ส่วน precise ทำตามการเรนเดอร์ สี องค์ประกอบภาพ และแสงใกล้ชิดกว่า สำหรับระบบเวกเตอร์ ใช้พรอมป์ต์กำหนดประเภทกราฟิก รูปเงา จำนวนวัตถุ และเลย์เอาต์ สำหรับชุดไอคอนนำทาง ให้ใช้เส้นขอบหนามน วัตถุหนึ่งชิ้นอยู่ตรงกลางต่อภาพ และชุดสีสองสี คงสไตล์อ้างอิงเดิมและเปลี่ยนวัตถุที่ระบุในแต่ละบรีฟ แทนการผสมภาพอ้างอิงที่ไม่เกี่ยวข้องเพื่อให้หลากหลาย
เอกสารอ้างอิงการสร้างอนุญาตพรอมป์ต์ยาวไม่เกิน 10,000 อักขระ ผลลัพธ์หนึ่งถึงหกชิ้น seed แบบสุ่ม สีที่ต้องการ และสีพื้นหลังที่ต้องการ ไม่รองรับพรอมป์ต์เชิงลบ ชื่อสไตล์คัดสรร และตัวควบคุม text_layout รุ่นเก่า รุ่น Styles นี้ยังไม่มี image-to-image หรือ inpainting โดยภาพอ้างอิงให้ภาษาภาพ ไม่ใช่บริเวณที่จะลบหรือกราฟิกเดิมที่ต้องคงไว้ไม่เปลี่ยน คำสั่งโครงสร้างในบรีฟเชิงบวกควรอธิบายชิ้นงานสำเร็จที่ต้องการ
ตรวจ SVG ที่ขนาดใช้งาน โดยเฉพาะเมื่องานมีตัวอักษร ช่องแคบ หรือรายละเอียดเล็ก ไม่รับประกันว่าสีจะตรงกับภาพอ้างอิง และภาพอ้างอิงที่ไม่เกี่ยวข้องอาจขัดกัน สำหรับชุดไอคอนที่เริ่มซ้ำ ให้เปลี่ยนวัตถุ ท่าทาง หรือการจัดวางในพรอมป์ต์โดยคงสไตล์ที่สอดคล้องกัน ชิ้นงานที่มีประโยชน์คือเวกเตอร์สม่ำเสมอที่ปรับรูปทรงและสีในเวิร์กโฟลว์ออกแบบได้ โดยประเมินเรขาคณิตและความอ่านง่ายตามบรีฟ
ผ่าน Ailoot ให้เลือก ID โมเดลนี้ให้ตรงใน /v1/images/generations และส่งพรอมป์ต์สร้างสรรค์ เก็บทุกรายการ data ที่ได้รับ ไม่ว่าคำตอบจะมี URL หรือเนื้อหาภาพที่เข้ารหัส และบันทึกไบต์จริงพร้อมชนิดเนื้อหาที่ได้รับ เก็บ usage และ media task_id ที่มีไว้กับชิ้นงาน แล้วตรวจรูปทรง ตัวอักษร และพื้นที่สีในงานออกแบบที่ตั้งใจ
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorเริ่มต้น
Recraft V4 Styles Vector สร้างกราฟิก SVG ที่แก้ไขได้จากบรีฟข้อความและสไตล์ภาพที่จำเป็น เหมาะกับชุดไอคอน โลโก้ และภาพประกอบที่ต้องใช้แนวทางเส้น ชุดสี และการเรนเดอร์ตามภาพอ้างอิงเดียวกัน
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- รูปภาพ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · Images POST /v1/images/generations
- ขาเข้า
text,image- ขาออก
image- รูปแบบเอาต์พุต
- ไฟล์ภาพ
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด recraft/recraft-v4-styles-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.1 ต่อภาพเอาต์พุต |
| การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | หน่วยคิดค่าบริการ— | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.1 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว |
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-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-vector
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Recraft: Recraft V4 Styles Vector
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- มีข้อจำกัดใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6