สร้างรูปภาพ
สร้างภาพด้วย ShareAI Images API โดยใช้โมเดลที่รองรับ คำสั่งข้อความ และตัวเลือกการสร้างภาพที่ผ่านการตรวจสอบแล้ว.
ในหน้านี้
https://api.shareai.now/api/v1/images/generationsสร้างภาพจากคำสั่งข้อความ.
- Base URL → URL พื้นฐาน
https://api.shareai.now- การตรวจสอบสิทธิ์
- Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
ใช้โมเดลภาพที่เปิดใช้งานใน ShareAI และได้รับอนุญาตจากข้อมูลรับรองของคุณ โมเดลจะกำหนดขนาด ระดับคุณภาพ และตัวเลือกผลลัพธ์ที่รองรับ.
ส่งคำขอ#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/images/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
ฟิลด์คำขอ#
| ฟิลด์ | ค่า |
|---|---|
model | รหัสโมเดลการสร้างภาพที่เปิดใช้งาน. |
prompt | คำอธิบายข้อความที่ไม่ว่างเปล่า. |
n | จำนวนภาพ ตั้งแต่ 1 ถึง 10 ขึ้นอยู่กับการรองรับของโมเดล. |
size / quality | ค่าขนาดและคุณภาพที่รองรับโดยโมเดล (ตัวเลือก). |
response_format / output_format | การตั้งค่าการตอบกลับและรูปแบบไฟล์ที่รองรับโดยโมเดล (ตัวเลือก). |
background | การตั้งค่าพื้นหลังที่รองรับโดยโมเดล (ตัวเลือก). |
อ่านภาพ#
ตรวจสอบ data รายการที่ส่งคืน ขึ้นอยู่กับโมเดลและรูปแบบที่ร้องขอ รายการอาจมี URL ภาพ HTTPS หรือข้อมูลภาพ base64 ใช้รูปแบบที่ส่งคืนจริง อย่าคาดเดาว่าผู้ให้บริการทุกคนจะส่งคืน URL API ไม่ดาวน์โหลด URL ภาพที่ส่งคืนให้คุณ.
ขนาดและข้อจำกัดด้านเวลา#
คำขอเป็นแบบ synchronous ข้อความรวมจำกัดที่ 256 KiB การเรียกผู้ให้บริการจำกัดที่ 120 วินาที และการตอบกลับจำกัดที่ 2 MiB ภาพ base64 ขนาดใหญ่อาจเกินขีดจำกัดการตอบกลับนั้น เลือกขนาดผลลัพธ์ที่เหมาะสมหรือโมเดลที่รองรับการส่งออก URL.
ลองใหม่อย่างระมัดระวัง#
การสร้างภาพอาจมีค่าใช้จ่าย หลังจากหมดเวลา หรือเกิดความล้มเหลวของเครือข่ายที่ไม่ชัดเจน ให้ตรวจสอบกิจกรรมก่อนลองใหม่ การส่งคำขอซ้ำอาจสร้างและเรียกเก็บเงินสำหรับภาพใหม่ API ไม่ลองคำขอภาพใหม่โดยอัตโนมัติหลังจากส่งไปยังผู้ให้บริการ.
การดำเนินการที่รองรับ#
เส้นทางนี้สร้างภาพจากข้อความ การแก้ไขภาพ การเปลี่ยนแปลง การอัปโหลดแบบหลายส่วน และการสร้างภาพแบบสตรีมไม่รองรับ การเรียกเก็บเงินปัจจุบันต้องการสัญญาการใช้งาน token-usage ที่เข้ากันได้กับโมเดล/ผู้ให้บริการ ผู้ให้บริการที่เรียกเก็บเงินต่อภาพเท่านั้นอาจไม่สามารถใช้งานได้.
ใช้การอนุญาตของลูกค้า#
สำหรับ OAuth flow ที่ได้รับการอนุมัติ ให้ส่ง access token เป็น Bearer การสร้างภาพที่ได้รับการสนับสนุนจากบัญชีต้องการ surcharge และแผนการใช้งานที่ได้รับการยอมรับ ข้อจำกัดทั้งหมดของโมเดล ผู้ให้บริการ และบัญชียังคงมีผล.
อัปเดตล่าสุด กันยายน 15, 2026