Recraft: Recraft V4.1 Utility Pro

Recraft V4.1 Utility Pro สร้างภาพราสเตอร์ 2K โดยเน้นฉากเรียบง่ายคาดการณ์ได้ แสงเรียบสม่ำเสมอ และองค์ประกอบที่หันด้านหน้าเข้าหากล้อง เหมาะกับภาพผลิตภัณฑ์ละเอียดและม็อกอัปที่ต้องการการนำเสนอชัดเจนมากกว่าทิศทางศิลป์ที่แสดงอารมณ์จัด

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

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

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

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

รหัสโมเดลที่แน่นอนคือ recraftv4_1_utility_pro เอกสารอ้างอิงผู้ผลิตระบุผลราสเตอร์ 2K ที่ละเอียดขึ้นใน WebP แบบไม่สูญเสียข้อมูลหรือ PNG ตารางขนาดระบุ 2048 × 2048 พิกเซลสำหรับภาพจัตุรัส และ 2432 × 1792 สำหรับ 4:3 ส่วนอัตราส่วนอื่นที่รองรับมีขนาดของตนเอง ต่างจากผล 1K ของ Utility มาตรฐาน และไม่ได้ทำให้ภาพกลายเป็นไฟล์เวกเตอร์ที่แก้ไขได้ รุ่น Vector ให้ SVG เพื่อจุดประสงค์นั้น

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

เอกสารสร้างภาพ V4.1 รองรับพรอมป์ต์สูงสุด 10,000 อักขระ ตัวควบคุมสีที่ต้องการและสีพื้นหลัง seed สุ่ม และผลหนึ่งถึงหกภาพ สไตล์ที่บันทึกไว้ซึ่งเข้ากันได้หรือภาพอ้างอิงตามต้องการชี้นำรูปลักษณ์ได้ ส่วนตระกูล V4 Styles เฉพาะเป็นสายแยกที่ต้องมีสไตล์เสมอ สำหรับภาพอ้างอิงที่เลือกใช้ ให้ใช้ชิ้นงานชัดเจนที่มีทิศทางภาพสอดคล้องกัน ไม่รับประกันการทำสีจากภาพอ้างอิงซ้ำให้ตรงเป๊ะ ข้อกำหนดสีแบรนด์จึงยังต้องมีบรีฟชัดและตรวจผล สำหรับการสร้างแบบอ้างอิงสไตล์ ใช้ภาพ PNG, JPG หรือ WebP หนึ่งถึงสิบภาพ รวมไม่เกิน 64 MB และแต่ละภาพต่ำกว่า 20 MB แต่ละภาพต้องมีด้านสั้นอย่างน้อย 256 พิกเซล ด้านยาวไม่เกิน 4,096 พิกเซล และความละเอียดไม่เกิน 16 เมกะพิกเซล ใช้ภาพอ้างอิงเหล่านี้หรือสไตล์ที่บันทึกซึ่งเข้ากันได้อย่างใดอย่างหนึ่ง แทนใช้ทั้งสอง สำหรับการสร้างแบบอ้างอิงสไตล์ การจับคู่ flexible ยอมให้ตีความหลวมกว่า ส่วน precise ตามการเรนเดอร์ ชุดสี องค์ประกอบ และแสงใกล้กว่า

Recraft ยังระบุ image-to-image สำหรับสาย V4.1 โดยรวมภาพเดิมกับพรอมป์ต์และ strength ตั้งแต่ 0 ถึง 1 ค่าต่ำอยู่ใกล้ต้นฉบับและค่าสูงอนุญาตการเปลี่ยนมากขึ้น มีประโยชน์เมื่อต้องให้ตัวแบบหรือองค์ประกอบเริ่มต้นชี้นำเวอร์ชันใหม่ การแปลงแบบเดียวกันนี้ไม่รับตัวควบคุมสไตล์กำหนดเอง V4.1 ขีดจำกัดภาพเข้าของผู้ผลิตคือไฟล์ต่ำกว่า 20 MB สูงสุด 16 MP และด้านตั้งแต่ 256 ถึง 4096 พิกเซล

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

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

recraft/recraft-v4.1-utility-pro

Recraft /recraft/recraft-v4.1-utility-pro

เริ่มต้น

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

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

Ailoot Ultra · รูปภาพ POST /v1/images/generations

ขาเข้า: text, image
ขาออก: image

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด recraft/recraft-v4.1-utility-pro	ค่าเริ่มต้น—
ฟิลด์`prompt`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1	ค่าเริ่มต้น—
ฟิลด์`aspect_ratio`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 1:1, 4:3, 3:4, 16:9, 9:16, auto	ค่าเริ่มต้น—
ฟิลด์`n`	ประเภท`integer`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด ขั้นต่ำ: 1 สูงสุด: 6	ค่าเริ่มต้น—
ฟิลด์`input_references`	ประเภท`array`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด จำนวนรายการขั้นต่ำ: 0 จำนวนรายการสูงสุด: 1	ค่าเริ่มต้น—
ฟิลด์`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.42 ต่อภาพเอาต์พุต
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	หน่วยคิดค่าบริการ—	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.42 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

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.1-utility-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.1-utility-pro

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

/v1/images

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

recraft/recraft-v4.1-utility-pro

FAQ · Recraft: Recraft V4.1 Utility Pro

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: text, image → image
คำขอใช้ฟิลด์ใดบ้าง?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: model, prompt, aspect_ratio, n, input_references, provider
มีข้อจำกัดใดบ้าง?: POST /v1/images/generations · recraft/recraft-v4.1-utility-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1 Utility Pro