models

Recraft: Recraft V4 Styles Pro

Markdown · JSON

Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro สร้างภาพราสเตอร์ 2K ในสไตล์ภาพที่กำหนดด้วยภาพอ้างอิง ออกแบบสำหรับชิ้นงานแคมเปญละเอียดและชุดภาพที่พื้นผิว การเรนเดอร์ ชุดสี และภาพรวมควรคงสอดคล้องแม้เปลี่ยนตัวแบบ

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

Recraft V4 Styles Pro เป็นโมเดลราสเตอร์ความละเอียดสูงในตระกูล V4 Styles เฉพาะของ Recraft สร้างภาพใหม่จากบรีฟข้อความกับสไตล์ภาพที่ให้ผ่านภาพอ้างอิงหรือสไตล์บันทึก มีไว้สำหรับแคมเปญ ภาพประกอบแบรนด์ และชุดภาพที่การเรนเดอร์ พื้นผิว และลักษณะองค์ประกอบต้องส่งต่อจากชิ้นงานหนึ่งสู่อีกชิ้น แยกจาก Recraft V4 Pro และ V4.1 Pro ซึ่งข้อมูลเข้าสไตล์เป็นทางเลือกแทนข้อกำหนดหลักของโมเดล

Styles Pro สร้างผลราสเตอร์ 2K เป็น WebP แบบไม่สูญเสียข้อมูลหรือ PNG ตารางขนาดผู้ผลิตระบุจัตุรัส 2048 × 2048 พิกเซล ส่วน 16:9 คือ 2688 × 1536 อัตราส่วนอื่นที่รองรับมีขนาดของตน ผลใหญ่ของ Pro มีประโยชน์สำหรับภาพแคมเปญละเอียดและเลย์เอาต์ใหญ่ รุ่นเวกเตอร์สร้าง SVG และไม่มีขนาดพิกเซลตายตัว จึงไม่ควรเลือกราสเตอร์ Pro นี้เมื่อต้องส่งไฟล์เวกเตอร์แก้ไขได้

ทุกการสร้างในตระกูล Styles ต้องมีสไตล์ ส่งภาพอ้างอิง PNG, JPG หรือ WebP หนึ่งถึงสิบภาพ หรือใช้สไตล์บันทึกที่เข้ากันได้ รหัสสไตล์กับภาพอ้างอิงใหม่เป็นอินพุตที่ต้องเลือกใช้อย่างใดอย่างหนึ่ง ไม่ใช่ใช้ร่วมกัน เวิร์กโฟลว์ผู้ผลิตอนุญาตภาพอ้างอิงรวมสูงสุด 64 MB โดยแต่ละไฟล์ต่ำกว่า 20 MB การสร้างสไตล์ไม่ต้องมีขั้นฝึกที่ผู้ใช้รันเอง ภาพอ้างอิงชัดหนึ่งภาพกำหนดทิศทางสอดคล้องได้ หลายภาพช่วยเมื่อมีภาษาภาพเดียวกันอยู่แล้วแทนการใช้รูปแบบที่ขัดแย้งกัน แต่ละภาพต้องมีด้านสั้นอย่างน้อย 256 พิกเซล ด้านยาวไม่เกิน 4,096 พิกเซล และความละเอียดรวมไม่เกิน 16 เมกะพิกเซล

การจับคู่สไตล์ flexible เป็นค่าเริ่มต้นและอนุญาตตีความหลวมกว่า ส่วน precise ตามการเรนเดอร์ ชุดสี องค์ประกอบ และแสงใกล้กว่า ภาพอ้างอิงกำหนดภาษาภาพ แต่บรีฟข้อความยังต้องอธิบายตัวแบบใหม่ การกระทำ ฉาก และกรอบภาพ สำหรับแคมเปญผลิตภัณฑ์ละเอียด ระบุขวดแก้วบนพื้นหินสีอ่อน มุมสามส่วนสี่ แสงข้างนุ่ม และที่โล่งสำหรับพาดหัว ขณะที่ภาพอ้างอิงให้แนวทางภาพถ่าย

โมเดลรับพรอมป์ต์สูงสุด 10,000 อักขระ รองรับสีที่ต้องการและสีพื้นหลังที่ต้องการ และใช้ seed สุ่มได้ เวิร์กโฟลว์สร้างตามเอกสารส่งคืนหนึ่งถึงหกภาพ ตัวควบคุมที่ใช้ได้ต่างจาก Recraft รุ่นเก่า ไม่รองรับชื่อสไตล์ที่คัดสรร negative_prompt และ text_layout และตระกูล Styles ไม่มี image-to-image หรือ inpainting ภาพอ้างอิงเป็นแหล่งสไตล์ ไม่ใช่มาสก์หรือคำสั่งคงภาพถ่ายเดิมทุกพิกเซล

เตรียมภาพอ้างอิงสะอาดละเอียดพอ และใช้สไตล์เดิมพัฒนาชุด หากผลซ้ำซาก ให้เปลี่ยนตัวแบบ ท่า มุมกล้อง หรือฉากในบรีฟข้อความแทนเพิ่มภาพอ้างอิงไม่เกี่ยวข้อง ไม่รับประกันสีจากภาพอ้างอิงสู่ผลตรงเป๊ะ ตัวควบคุมสีที่ต้องการใช้ระบุแนวทาง ไม่ใช่ผลลัพธ์ที่ผ่านการตรวจปรู๊ฟสี สำหรับชิ้นงานแคมเปญสุดท้าย ให้ประเมินที่ขนาดแสดงหรือพิมพ์ที่ตั้งใจและตรวจว่าตัวแบบ พื้นที่ว่างใช้ได้ และแนวทางภาพตรงบรีฟหรือไม่

Ailoot Ultra · รูปภาพ POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

เริ่มต้น

Recraft V4 Styles Pro สร้างภาพราสเตอร์ 2K ในสไตล์ภาพที่กำหนดด้วยภาพอ้างอิง ออกแบบสำหรับชิ้นงานแคมเปญละเอียดและชุดภาพที่พื้นผิว การเรนเดอร์ ชุดสี และภาพรวมควรคงสอดคล้องแม้เปลี่ยนตัวแบบ

อินพุตที่รองรับ
ข้อความ · รูปภาพ
ผลลัพธ์
รูปภาพ

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · รูปภาพ POST /v1/images/generations
ขาเข้า
text, image
ขาออก
image
ฟิลด์ประเภทข้อกำหนดค่าและข้อจำกัดค่าเริ่มต้น
ฟิลด์modelประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
recraft/recraft-v4-styles-pro
ค่าเริ่มต้น—
ฟิลด์promptประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
ความยาวขั้นต่ำ: 1
ค่าเริ่มต้น—
ฟิลด์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
ค่าเริ่มต้น—
ฟิลด์nประเภทintegerข้อกำหนดไม่บังคับค่าและข้อจำกัด
ขั้นต่ำ: 1
สูงสุด: 6
ค่าเริ่มต้น—
ฟิลด์input_referencesประเภทarrayข้อกำหนดไม่บังคับค่าและข้อจำกัด
จำนวนรายการขั้นต่ำ: 1
จำนวนรายการสูงสุด: 10
ค่าเริ่มต้น—
ฟิลด์providerประเภทobjectข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
พารามิเตอร์และวงจรการทำงานของเมธอด
พารามิเตอร์ข้อกำหนด
พารามิเตอร์content_typeข้อกำหนดapplication/json
พารามิเตอร์requiredข้อกำหนดmodel, prompt
พารามิเตอร์material_typesข้อกำหนดtext, image

วงจรการทำงาน: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ค่า task_id ที่ส่งกลับมาจริง หรือระเบียนในคลังสื่อ

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

ราคา

วิธีคำนวณค่าบริการสุดท้าย

อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว
ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น
ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด
ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่าตารางอัตราค่าบริการปริมาณคาดการณ์หน่วยคิดค่าบริการเงื่อนไขคิดค่าบริการค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐานตารางอัตราค่าบริการอัตราพื้นฐานปริมาณคาดการณ์—หน่วยคิดค่าบริการ—เงื่อนไขคิดค่าบริการ—ค่าบริการ
ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าข้อมูลอ้างอิงขาเข้าตารางอัตราค่าบริการ—ปริมาณคาดการณ์—หน่วยคิดค่าบริการต่อคำขอเงื่อนไขคิดค่าบริการการสร้างสไตล์เมื่อสร้างด้วยข้อมูลอ้างอิงสไตล์ คิดครั้งเดียวต่อคำขอ เพิ่มจากราคาภาพขาออกค่าบริการ
ขาเข้า · ข้อมูลอ้างอิงขาเข้า · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.01 ต่อคำขอ
การตั้งค่าภาพขาออกตารางอัตราค่าบริการ—ปริมาณคาดการณ์—หน่วยคิดค่าบริการต่อภาพเอาต์พุตเงื่อนไขคิดค่าบริการ—ค่าบริการ
ขาออก · ภาพขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.2 ต่อภาพเอาต์พุต
การตั้งค่าต้นทุนการสร้างโดยประมาณตารางอัตราค่าบริการ—ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้งหน่วยคิดค่าบริการ—เงื่อนไขคิดค่าบริการ—ค่าบริการ
ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.2 ประมาณการก่อนสร้าง

ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →

ตัวอย่างคำขอ

Ailoot Ultra · รูปภาพ

curl
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={'model': 'recraft/recraft-v4-styles-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

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
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

รับและบันทึกผลลัพธ์

Ailoot Ultra · รูปภาพ

ดาวน์โหลดภาพที่ส่งกลับมาทุกภาพ หรือบันทึกเนื้อหา Base64 ของภาพนั้น

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
การอ่านเนื้อหาแบบอื่น
อ่านไฟล์สื่อที่มีอยู่และเป็นของคุณ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

บันทึกภาพที่สร้างเสร็จทุกภาพ โดยดึงภาพจากทุก URL ที่ส่งกลับมา หรือถอดรหัสเนื้อหา Base64

เก็บการตอบกลับและส่วนหัวให้ครบถ้วน เก็บผลลัพธ์จริงทุกรายการ ตัวระบุที่ส่งกลับมาแต่เดิม และฟิลด์ข้อมูลการใช้งานทั้งหมด กู้คืนการดำเนินการเดิมโดยไม่ส่งคำขอสร้างซ้ำ

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

เก็บ X-Client-Request-ID ที่ส่งกลับมาไว้เพื่อกระทบยอด อ่านเฉพาะค่า task_id/asset_id ที่ส่งกลับมาจริง หรืออ่านจากคลังสื่อที่เป็นของตนเอง ห้ามสร้าง URL ของงานจาก ID การดำเนินการ และห้ามส่งคำขอสร้างซ้ำเด็ดขาด

ฟิลด์การตอบกลับ
ฟิลด์ประเภท
ฟิลด์createdประเภท
ฟิลด์data[].urlประเภท
ฟิลด์data[].b64_jsonประเภท
ฟิลด์usageประเภท

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra recraft/recraft-v4-styles-pro

ชื่อพาธเมธอดอื่น

/v1/images

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro
มีอินพุตและผลลัพธ์ใดบ้าง?

POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image

คำขอใช้ฟิลด์ใดบ้าง?

POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider

มีข้อจำกัดใดบ้าง?

POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

รายละเอียดเพิ่มเติม

เชื่อม Ailoot กับ Claude Code, OpenCode, Hermes หรือแอปของคุณ

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.

ซื้อโทเคนพร้อมส่วนลด

ส่วนลดสมาชิกสำหรับงานประจำ โค้ดโปรโมชั่นลดซื้อโทเคนสูงสุด 50%

สมาชิก
เลือกแพ็กเกจมีส่วนลดสำหรับคำขอประจำ
โค้ดลดสูงสุด 50%
ใส่โค้ดขณะซื้อ ราคาคำนวณใหม่ตามโปรโมชั่นที่ใช้
รายจ่ายในประวัติ
เก็บโมเดล โทเคน และยอดสำหรับทุกคำขอ

เลือกสมาชิก · ดูราคาโมเดล

เชื่อม API กับผลิตภัณฑ์ ที่คุณขาย

SaaS แอป และบอต ตามข้อเสนอและสัญญาอนุญาต Ailoot หากขายต่อให้ขอใบอนุญาตรีเซลเลอร์

แอปเชิงพาณิชย์
ใส่การสร้างข้อความ ภาพ วิดีโอ และเสียงในฟีเจอร์เสียเงินของบริการคุณ
ใบอนุญาตรีเซลเลอร์
ส่งคำอธิบายโครงการและรูปแบบการเข้าถึง ขอเงื่อนไขใช้และขายต่อเป็นลายลักษณ์อักษร
เอกสารบนเว็บไซต์
อ่านข้อเสนอ สัญญาอนุญาต และนโยบายประมวลผลข้อมูลก่อนเชื่อมได้

ขอใบอนุญาตขายต่อ · ข้อเสนอและสัญญาอนุญาต