ShareAI Platform Docs

สร้างวิดีโอ

การส่งข้อมูลจะคืนค่า HTTP 202 พร้อม ShareAI job ID และ polling URL.

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

สร้างวิดีโอ

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

การส่งคืน HTTP 202 พร้อม ShareAI job ID และ polling URL ส่ง Idempotency-Key header ที่เสถียรสำหรับการลองใหม่ของคำขอเดียวกัน การใช้คีย์นั้นซ้ำกับอินพุตที่แตกต่างกันจะถูกปฏิเสธ ตรวจสอบสถานะ GET /api/v1/videos/{id} ด้วยข้อมูลรับรองต้นทางเดียวกัน สถานะรวมถึง queued, pending, in_progress, finalizing, completed, failed และ requires_review ผลลัพธ์ที่เป็น requires_review ต้องการการตรวจสอบจากทีม; การตรวจสอบสถานะจะไม่เริ่มการสร้างใหม่.

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

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

ส่งคำขอ#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

ฟิลด์คำขอ#

ฟิลด์ประเภทความหมายและข้อจำกัด
model จำเป็นสตริงตัวระบุโมเดลสาธารณะที่เปิดใช้งานอย่างแม่นยำ ต้องประกาศการดำเนินการนี้และได้รับอนุญาตจากข้อมูลรับรองของคุณ.
prompt จำเป็นสตริงคำสั่งการสร้างที่ไม่ว่างเปล่า ขนาดสูงสุด 256 KiB ของข้อความ UTF-8.
durationจำนวนเต็มระยะเวลาวิดีโอที่ร้องขอเป็นวินาที (ตัวเลือก) 1–600 ซึ่งถูกจำกัดเพิ่มเติมโดยโมเดลที่เลือก ระยะเวลาที่ส่งคืนจริงจะกำหนดการเรียกเก็บเงินตามระยะเวลา.
resolutionสตริงตัวเลือกความละเอียดที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร; ต้องตรงกับตัวเลือกอัตราค่าบริการที่เผยแพร่.
aspect_ratioสตริงตัวเลือกอัตราส่วนภาพที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร.
sizeสตริงขนาดผลลัพธ์ที่รองรับโดยโมเดล ขนาดสูงสุด 100 ตัวอักษร เช่น 1024×1024 ไม่ใช่ทุกโมเดลที่รองรับตัวเลือกนี้.
generate_audioboolean → บูลีนตัวเลือกเสียงประกอบวิดีโอ (ตัวเลือก) การรองรับโดยโมเดลและตัวเลือกอัตราค่าบริการที่ตรงกันเป็นสิ่งจำเป็น.
seedจำนวนเต็มตัวเลือก seed ที่รองรับโดยโมเดล (ตัวเลือก) วิดีโอต้องการจำนวนเต็มที่ไม่เป็นลบ; การทำซ้ำขึ้นอยู่กับผู้ดำเนินการ.
frame_imagesarray → อาร์เรย์ส่วน image_url ได้สูงสุดสองส่วน โดยแต่ละส่วนมี frame_type เป็น first_frame หรือ last_frame โดยไม่มีการซ้ำกัน ห้ามรวม frame_images และ input_references.
input_referencesarray → อาร์เรย์ส่วน image_url ที่พิมพ์ได้สูงสุด 16 ส่วน โดย image_url.url ต้องตั้งค่าเป็น HTTPS URL หรือ URL ข้อมูลภาพที่รองรับ การรองรับโดยโมเดลเป็นสิ่งจำเป็น.
providerออบเจ็กต์การตั้งค่าการกำหนดเส้นทางผู้ให้บริการที่เลือกได้ ใช้ provider.only สำหรับแท็กผู้ให้บริการที่ยอมรับ ไม่ใช่คำนำหน้าใน ID โมเดล ข้อจำกัดบัญชีและข้อมูลรับรองยังคงมีผล.
allow_temporary_retentionboolean → บูลีนเฉพาะวิดีโอเท่านั้น การตั้งค่า true อย่างชัดเจนอนุญาตให้เก็บผลลัพธ์ชั่วคราวต้นทางในเส้นทางที่ต้องการ หากละเว้น/ตั้งค่า false เส้นทางเหล่านั้นจะไม่สามารถใช้งานได้ ขัดแย้งกับ provider.zdr:true; การดำเนินการอื่นๆ จะเก็บรักษา ZDR ที่จำเป็น.

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

ความสำเร็จจะส่งคืน HTTP 202 พร้อม JSON การส่งคืน HTTP 202 พร้อม ShareAI job ID และ polling URL ส่ง Idempotency-Key header ที่เสถียรสำหรับการลองใหม่ของคำขอเดียวกัน การใช้คีย์นั้นซ้ำกับอินพุตที่แตกต่างกันจะถูกปฏิเสธ ตรวจสอบสถานะ GET /api/v1/videos/{id} ด้วยข้อมูลรับรองต้นทางเดียวกัน สถานะรวมถึง queued, pending, in_progress, finalizing, completed, failed และ requires_review ผลลัพธ์ที่เป็น requires_review ต้องการการตรวจสอบจากทีม; การตรวจสอบสถานะจะไม่เริ่มการสร้างใหม่.

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

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

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

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

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

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

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

การเก็บรักษาวิดีโอชั่วคราว#

เส้นทางวิดีโอบางเส้นทางต้องการการเก็บรักษาชั่วคราวต้นทางเพื่อให้สามารถดึงผลลัพธ์ที่สร้างขึ้นได้ พวกเขาต้องการ allow_temporary_retention:true การยอมรับอย่างชัดเจนในคำขอวิดีโอนั้น การละเว้นจะทำให้เส้นทางเหล่านั้นไม่สามารถใช้งานได้ ข้อยกเว้นนี้ใช้เฉพาะกับวิดีโอเท่านั้น และไม่อนุญาตให้ฝึกอบรมโมเดลหรือเก็บรักษาสำหรับการดำเนินการอื่นๆ นโยบาย ZDR ที่ชัดเจนไม่สามารถถูกลดทอนโดยไม่แจ้งให้ทราบ.

JSON

{"allow_temporary_retention": true}

ตรวจสอบสถานะงาน#

GET https://api.shareai.now/api/v1/videos/{id}

อ่านการสร้างวิดีโอด้วยข้อมูลรับรองต้นทาง

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

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

JSON ด้านบนแสดงฟิลด์งานที่เสถียร ไม่ใช่การสร้างจริง ตรวจสอบเส้นทาง ShareAI ด้วยคีย์เดียวกัน รอระหว่างการตรวจสอบ queued, pending, in_progress และ finalizing หมายถึงรอ; completed เปิดเผยข้อมูลด้วย ShareAI content URLs; failed และ requires_review หมายถึงหยุดและตรวจสอบ สถานะการลองใหม่อ่านหลังจากข้อผิดพลาดชั่วคราว แต่ห้ามส่งการสร้างใหม่โดยอัตโนมัติ ข้อมูลรับรองที่แตกต่างหรือถูกเพิกถอนจะไม่สามารถดึงงานได้.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

ดาวน์โหลดผลลัพธ์#

เมื่อเสร็จสิ้น แต่ละรายการข้อมูลจะมี ShareAI content URL ดึงข้อมูล GET /api/v1/videos/{id}/content?index=0 ใช้ข้อมูลรับรองต้นทางเดียวกัน Endpoint รองรับ HTTP byte range เดียวเท่านั้น URL ของ Provider, ตั๋วส่วนตัว และข้อมูลรับรองของ Provider จะไม่ถูกส่งกลับ การตรวจสอบสถานะและการดาวน์โหลดจะไม่สร้างคำขอการอนุมานครั้งที่สองหรือค่าธรรมเนียมการประมวลผล Monetization Gateway งานที่เสร็จสมบูรณ์หมายถึงการชำระเงินได้รับการยืนยันก่อนที่ไฟล์จะสามารถดาวน์โหลดได้.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

frame_images ที่เป็นตัวเลือกต้องมีส่วน image_url พร้อม first_frame หรือ last_frame ใช้ภาพเฟรมหรือภาพอ้างอิงในคำขอเดียว ไม่ใช่ทั้งสองอย่าง ระยะเวลา, ความละเอียด และอัตราส่วนภาพของโมเดลอาจมีข้อจำกัดมากกว่าขอบเขตความปลอดภัยของ API Webhooks และ URL การเรียกกลับแบบกำหนดเองไม่รองรับ.

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI