ShareAI Platform Docs

สร้างภาพ

การตอบกลับแบบ synchronous JSON มีผลลัพธ์ภาพอยู่ใน data.

ดูในรูปแบบ Markdown
ในหน้านี้
POST https://api.shareai.now/api/v1/images

สร้างภาพ

Base URL → URL พื้นฐาน
https://api.shareai.now
การตรวจสอบสิทธิ์
Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
ขอบเขตที่จำเป็น
inference or monetization_gateway

การตอบกลับ JSON แบบซิงโครนัสประกอบด้วยผลลัพธ์ของภาพใน data. ชื่อแทน /api/v1/images/generations ก็รองรับเช่นกัน ตัวเลือกต่างๆ เช่น ขนาด ความละเอียด อัตราส่วนภาพ คุณภาพ และรูปแบบผลลัพธ์ขึ้นอยู่กับโมเดลที่เลือก การตอบกลับถูกจำกัดไว้ที่ 2 MiB; ลดจำนวนหรือขนาดภาพเมื่อจำเป็น ภาพที่ส่งกลับถูกจำกัดไว้ที่ 8192 พิกเซลต่อด้าน.

ก่อนเริ่มต้น#

ตั้งค่า SHAREAI_API_KEY บนเซิร์ฟเวอร์ของคุณและแทนที่ placeholder ของโมเดลด้วยโมเดลที่เปิดใช้งานในปัจจุบัน ห้ามเปิดเผย API key ในโค้ดเบราว์เซอร์ โมเดล บัญชี ข้อมูลรับรอง และผู้ให้บริการต้องอนุญาตการดำเนินการนี้ การตั้งค่าเพิ่มเติมด้านล่างต้องการการสนับสนุนจากโมเดล ขอบเขตความปลอดภัยของ API ไม่ใช่คำสัญญาว่าโมเดลทุกตัวจะรองรับค่าทุกค่า.

ส่งคำขอ#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

ฟิลด์คำขอ#

ฟิลด์ประเภทความหมายและข้อจำกัด
model จำเป็นสตริงตัวระบุโมเดลสาธารณะที่เปิดใช้งานอย่างแม่นยำ ต้องประกาศการดำเนินการนี้และได้รับอนุญาตจากข้อมูลรับรองของคุณ.
prompt จำเป็นสตริงคำสั่งการสร้างที่ไม่ว่างเปล่า ขนาดสูงสุด 256 KiB ของข้อความ UTF-8.
nจำนวนเต็มจำนวนภาพที่เลือกได้ 1–10; ค่าเริ่มต้นคือ 1 โมเดลของคุณอาจอนุญาตให้น้อยกว่านี้.
sizeสตริงขนาดผลลัพธ์ที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร เช่น 1024×1024 ไม่ใช่ทุกโมเดลที่รองรับตัวเลือกนี้.
resolutionสตริงตัวเลือกความละเอียดที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร; ต้องตรงกับตัวเลือกอัตราค่าบริการที่เผยแพร่.
aspect_ratioสตริงตัวเลือกอัตราส่วนภาพที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร.
qualityสตริงตัวเลือกคุณภาพที่รองรับโดยโมเดล สูงสุด 100 ตัวอักษร; อาจเลือกอัตราที่แตกต่างกัน.
response_formatสตริงรูปแบบการตอบกลับที่รองรับโดยโมเดล สูงสุด 100 ตัวอักษร การดำเนินการจะกำหนดว่าผลลัพธ์เป็น JSON หรือไบนารี.
output_formatสตริงตัวเลือกการเข้ารหัสผลลัพธ์ที่รองรับโดยโมเดล สูงสุด 100 ตัวอักษร.
backgroundสตริงการตั้งค่าพื้นหลังภาพแบบเลือกได้เมื่อโมเดลรองรับ.
seedจำนวนเต็มตัวเลือก seed ที่รองรับโดยโมเดล (ตัวเลือก) วิดีโอต้องการจำนวนเต็มที่ไม่เป็นลบ; การทำซ้ำขึ้นอยู่กับผู้ดำเนินการ.
input_referencesarray → อาร์เรย์ส่วน image_url ที่พิมพ์ได้สูงสุด 16 ส่วน โดย image_url.url ต้องตั้งค่าเป็น HTTPS URL หรือ URL ข้อมูลภาพที่รองรับ การรองรับโดยโมเดลเป็นสิ่งจำเป็น.
providerออบเจ็กต์การตั้งค่าการกำหนดเส้นทางผู้ให้บริการที่เลือกได้ ใช้ provider.only สำหรับแท็กผู้ให้บริการที่ยอมรับ ไม่ใช่คำนำหน้าใน ID โมเดล ข้อจำกัดบัญชีและข้อมูลรับรองยังคงมีผล.

อ่านผลลัพธ์#

การตอบกลับ HTTP 200 สำเร็จพร้อม JSON การตอบกลับ JSON แบบซิงโครนัสประกอบด้วยผลลัพธ์ของภาพใน data. ชื่อแทน /api/v1/images/generations ก็รองรับเช่นกัน ตัวเลือกต่างๆ เช่น ขนาด ความละเอียด อัตราส่วนภาพ คุณภาพ และรูปแบบผลลัพธ์ขึ้นอยู่กับโมเดลที่เลือก การตอบกลับถูกจำกัดไว้ที่ 2 MiB; ลดจำนวนหรือขนาดภาพเมื่อจำเป็น ภาพที่ส่งกลับถูกจำกัดไว้ที่ 8192 พิกเซลต่อด้าน.

หน่วยการเรียกเก็บเงิน#

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

เลือกตัวระบุโมเดลที่เปิดใช้งานจาก Console ความสามารถในการดำเนินการและอินพุต/เอาต์พุตที่ประกาศไว้ต้องตรงกับ endpoint นี้ โมเดลแชทข้อความไม่สามารถแทนที่การดำเนินการอื่นได้ ข้อจำกัดข้อมูลรับรอง ผู้ให้บริการ และบัญชีของคุณยังคงมีผล.

การกำหนดราคาและการใช้งาน#

อัตราค่าบริการถูกเผยแพร่ในเครดิต AI สกุลเงิน EUR สำหรับโมเดล ผู้ให้บริการ หน่วย และตัวแปรที่เลือก เฉพาะมิติในอัตราภาษีที่ใช้งานอยู่เท่านั้นที่ถูกเรียกเก็บเงิน การประมาณการจะสำรองเครดิตก่อนการดำเนินการ ค่าใช้จ่ายสุดท้ายใช้การใช้งานที่วัดได้ ราคาอาจขึ้นอยู่กับความละเอียด รูปแบบเอาต์พุต หรือช่วงการใช้งาน ตรวจสอบ Console Usage สำหรับการหักเครดิต ShareAI สุดท้าย ฟิลด์ต้นทุนต้นน้ำและไบต์สื่อจะไม่ถูกแปลงเป็นจำนวน token ที่ถูกสร้างขึ้น.

การเข้าถึงและข้อผิดพลาด#

การใช้งาน inference สำหรับการอนุมานต้นทุนเครือข่ายที่ได้รับการอนุมัติหรือ monetization_gateway สำหรับการเพิ่มราคาของ Builder ที่ได้รับการอนุมัติและเงื่อนไขการเรียกเก็บเงินที่ยอมรับ การเข้าถึงเฉพาะตัวตนไม่อนุญาตให้ใช้จ่าย การตรวจสอบ การอนุญาตโมเดล เครดิตไม่เพียงพอ ขีดจำกัดอัตรา และความล้มเหลวในการดำเนินการจะส่งคืน error. หลังจากหมดเวลาหรือการส่งที่ไม่แน่นอน ให้ตรวจสอบ Usage หรือวิดีโอ job ก่อนสร้างคำขอที่อาจมีค่าใช้จ่ายอีกครั้ง.

อัปเดตล่าสุด พฤศจิกายน 3, 2026

เอกสารแพลตฟอร์ม ShareAI
เอกสารทั้งหมด

ค้นหาตามชื่อหรือเนื้อหา.

สอบถามเกี่ยวกับหน้านี้

เลือกผู้ช่วยเพื่อสำรวจหน้านี้ คุณยังสามารถคัดลอกหน้าและวางลงในบทสนทนาของคุณได้.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI