Recraft: Recraft V4.1 Pro Vector
Recraft V4.1 Pro Vector สร้างงาน SVG ที่แก้ไขได้สำหรับโลโก้ ตัวอักษร และภาพประกอบที่มีรายละเอียด เป็นรุ่นเวกเตอร์ Pro ของตระกูล V4.1 ที่รวมพรอมป์ต์ข้อความกับอินพุตภาพและสไตล์ที่เลือกใช้ได้ โดยคงชิ้นงานเป็นเวกเตอร์
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Recraft V4.1 Pro Vector เป็นรุ่น SVG แบบ Pro ในตระกูลสร้างภาพ V4.1 ของ Recraft ออกแบบสำหรับงานที่ผลลัพธ์ควรคงเป็นเวกเตอร์ที่แก้ไขได้ เช่น โลโก้ แนวคิดตัวพิมพ์ ไอคอน หรือภาพประกอบ การนำเสนอ V4.1 ของผู้ผลิตเน้นองค์ประกอบภาพและภาพประกอบที่ออกแบบอย่างตั้งใจ ส่วนเอกสารอ้างอิงโมเดลที่ตรงระบุรุ่นนี้แยกจาก Vector มาตรฐาน แรสเตอร์ Pro และรุ่น Utility ภาพสุดท้ายเป็น SVG แทนการส่งออกแรสเตอร์ความละเอียดสูง
รหัสโมเดลของผู้ผลิตคือ recraftv4_1_pro_vector เอาต์พุตเวกเตอร์ไม่มีขนาดพิกเซลตายตัว เอกสารอ้างอิงขนาดรับอัตราส่วนความกว้างต่อความสูงสิบสี่แบบสำหรับโมเดลเวกเตอร์ และไม่รับขนาดพิกเซลที่แน่นอน ดังนั้นการตั้งค่าแรสเตอร์ 2K ของ Pro จึงไม่กำหนดความละเอียด SVG ของรุ่นนี้ ระบุสัดส่วนที่ต้องการและวิธีใช้ชิ้นงาน สำหรับโลโก้ ชิ้นงานสำคัญคือรูปเงาที่อ่านได้และพื้นที่สีที่แก้ไขปรับในเวิร์กโฟลว์ออกแบบได้
โมเดลรองรับการสร้างภาพจากข้อความและภาพอ้างอิงสไตล์กำหนดเองที่เลือกใช้ได้ ขอบเขตพรอมป์ต์ตามเอกสารคือ 10,000 อักขระ สีที่ต้องการ สีพื้นหลังที่ต้องการ และ seed แบบสุ่มช่วยนำการสร้างได้ และเวิร์กโฟลว์อนุญาตผลลัพธ์หนึ่งถึงหกชิ้น สไตล์ที่บันทึกไว้ซึ่งเข้ากันได้หรือภาพอ้างอิงสามารถกำหนดภาษาภาพ สไตล์ต้องตรงกับโมเดลที่ใช้สร้างสไตล์นั้น สายหลัก V4.1 ไม่จำเป็นต้องมีสไตล์อ้างอิงในทุกคำขอ ต่างจากตระกูล V4 Styles โดยเฉพาะ สำหรับการสร้างโดยอ้างอิงสไตล์ ให้ใช้ภาพ PNG, JPG หรือ WebP หนึ่งถึงสิบภาพ ขนาดรวมไม่เกิน 64 MB และแต่ละภาพต่ำกว่า 20 MB ภาพอ้างอิงแต่ละภาพต้องมีด้านสั้นอย่างน้อย 256 พิกเซล ด้านยาวไม่เกิน 4,096 พิกเซล และความละเอียดไม่เกิน 16 เมกะพิกเซล ใช้ภาพอ้างอิงเหล่านี้หรือสไตล์ที่บันทึกไว้ซึ่งเข้ากันได้อย่างใดอย่างหนึ่ง ไม่ใช้ทั้งสองพร้อมกัน สำหรับการสร้างโดยอ้างอิงสไตล์ การจับคู่ flexible อนุญาตการตีความที่หลวมกว่า ส่วน precise ทำตามการเรนเดอร์ ชุดสี องค์ประกอบภาพ และแสงใกล้ชิดกว่า
บรีฟเวกเตอร์ที่มีประโยชน์กำหนดประเภทกราฟิก หลักการรูปทรง ชุดสี แนวทางเส้น และการจัดวางก่อนเพิ่มรายละเอียดตกแต่ง สำหรับตราร้านสวน ให้ขอรูปเงาต้นอ่อนหนึ่งต้น เรขาคณิตโค้งมน สีแบนสองสี และการจัดองค์ประกอบรวมตรงกลาง สำหรับตัวอักษร ให้ใส่คำตามตัวอักษรจริงและอธิบายลำดับชั้นกับรูปทรง แล้วตรวจ SVG ที่ได้รับด้านช่องว่างภายในตัวอักษร ระยะห่าง และความชัดเจนขนาดเล็ก ตัวอย่างเวกเตอร์ของผู้ผลิตรองรับตัวพิมพ์ที่สื่ออารมณ์และภาพประกอบ แต่ไม่ได้รับประกันว่าตัวอักษรหรือเส้นพาธทุกเส้นที่สร้างเป็นงานสำเร็จแล้ว
Recraft ระบุเวิร์กโฟลว์ image-to-image แยกต่างหากสำหรับโมเดลแรสเตอร์และเวกเตอร์ V4.1 โดยรวมภาพที่มีอยู่กับพรอมป์ต์ และใช้ strength ตั้งแต่ 0 ถึง 1 ควบคุมว่าผลลัพธ์ใหม่เปลี่ยนจากต้นฉบับมากเพียงใด strength ต่ำคงความใกล้เคียง ส่วนค่าสูงอนุญาตการเปลี่ยนแปลงมากขึ้น การดำเนินการนั้นไม่รับตัวควบคุมสไตล์กำหนดเองของ V4/V4.1 จึงควรเตรียมการแปลงภาพต้นทางและการสร้างโดยอ้างอิงสไตล์เป็นเวิร์กโฟลว์แยกกัน อินพุตภาพอาจเป็น PNG, JPG, WebP หรือ SVG ภายในขีดจำกัดภาพตามเอกสาร สำหรับ image-to-image ให้ส่ง PNG, JPG, WebP หรือ SVG ต่ำกว่า 20 MB ไม่เกิน 16 เมกะพิกเซล โดยทั้งสองด้านอยู่ระหว่าง 256 และ 4,096 พิกเซล
V4.1 ไม่รองรับชื่อสไตล์คัดสรรหรือตัวควบคุม negative_prompt, text_layout, artistic_level และ no_text ระบุการจัดวางและตัวอักษรที่ต้องการในบรีฟเชิงบวก แทนการพึ่งกลไกเก่าของ V3 สำหรับชิ้นงานแบรนด์ที่มีรายละเอียด ให้ใช้ SVG เป็นไฟล์ทำงาน ตรวจเรขาคณิต และปรับสีหรือรูปทรงตามจำเป็นก่อนวางในเลย์เอาต์สุดท้าย รุ่น Pro Vector นี้คงตัวตนของตนเอง ไม่สามารถใช้แทนรุ่นแรสเตอร์มาตรฐานหรือ Utility ได้เพียงเพราะใช้ชื่อ V4.1 ร่วมกัน
ผ่าน Ailoot ให้เลือก ID โมเดลนี้ให้ตรงใน /v1/images/generations และส่งพรอมป์ต์สร้างสรรค์ เก็บทุกรายการ data ที่ได้รับ ไม่ว่าคำตอบจะมี URL หรือเนื้อหาภาพที่เข้ารหัส และบันทึกไบต์จริงพร้อมชนิดเนื้อหาที่ได้รับ เก็บ usage และ media task_id ที่มีไว้กับชิ้นงาน แล้วตรวจรูปทรง ตัวอักษร และพื้นที่สีในงานออกแบบที่ตั้งใจ
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vector
recraft/recraft-v4.1-pro-vectorเริ่มต้น
Recraft V4.1 Pro Vector สร้างงาน SVG ที่แก้ไขได้สำหรับโลโก้ ตัวอักษร และภาพประกอบที่มีรายละเอียด เป็นรุ่นเวกเตอร์ Pro ของตระกูล V4.1 ที่รวมพรอมป์ต์ข้อความกับอินพุตภาพและสไตล์ที่เลือกใช้ได้ โดยคงชิ้นงานเป็นเวกเตอร์
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- รูปภาพ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · Images POST /v1/images/generations
- ขาเข้า
text,image- ขาออก
image- รูปแบบเอาต์พุต
- ไฟล์ภาพ
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด recraft/recraft-v4.1-pro-vector เงื่อนไข: ใช้ตัวเลือกระบุเส้นทางของ Ailoot นี้ตามที่ระบุไว้ทุกตัวอักษร | ค่าเริ่มต้น— |
ฟิลด์prompt | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์n | ประเภทinteger | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขั้นต่ำ: 1 สูงสุด: 6 เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์aspect_ratio | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 1:1, 4:3, 3:4, 16:9, 9:16, auto เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์output_format | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด svg เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์input_references | ประเภทarray | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด เงื่อนไข: | ค่าเริ่มต้น— |
ฟิลด์quality | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด auto, low, medium, high, xhigh, max เงื่อนไข: | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
สร้างภาพจากข้อความ
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์content_type | ข้อกำหนดapplication/json |
พารามิเตอร์required | ข้อกำหนดmodel, prompt |
พารามิเตอร์optional | ข้อกำหนดn, aspect_ratio, output_format, input_references, 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.6 ต่อภาพเอาต์พุต |
| การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | หน่วยคิดค่าบริการ— | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.6 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
ตัวอย่างคำขอ
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.
รับและบันทึกผลลัพธ์
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.1-pro-vector
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Recraft: Recraft V4.1 Pro Vector
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:text,image→image- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- มีข้อจำกัดใดบ้าง?
POST /v1/images/generations·recraft/recraft-v4.1-pro-vector:n.minimum:1;n.maximum:6