Kling 4.0 API

เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Kling 4.0 ของ Kuaishou

รุ่นของโมเดล {#}

API นี้รองรับโมเดลห้ารุ่น:

ตารางเปรียบเทียบโดยสรุป

อัตราส่วนภาพที่รองรับ

Text-to-Video, Image-to-Video, Reference-to-Video และ Video Edit รองรับ:

16:9, 9:16, 1:1, 21:9

ค่าเริ่มต้นคือ 16:9 ส่วน Video Extend ไม่รองรับพารามิเตอร์ aspect_ratio โดยผลลัพธ์จะใช้อัตราส่วนภาพตามวิดีโอต้นฉบับ

ตัวเลือกความละเอียด

ทั้งห้าโมเดลต้องระบุ resolution และ duration โดยต้องส่ง resolution อย่างชัดเจนแม้ค่าเริ่มต้นจะเป็น 720p ก็ตาม ส่วน duration ไม่มีค่าเริ่มต้น

Kling 4.0 Text to Video

จุดปลายทาง

POST /api/v1/video/task

พารามิเตอร์คำขอ

จำเป็น

ไม่บังคับ

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

javascriptคัดลอก
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Kling 4.0 Image to Video

พารามิเตอร์คำขอ

จำเป็น

ไม่บังคับ

เมื่อระบุทั้ง image_url และ image_end_url แล้ว key_frames จะมีภาพได้สูงสุด 8 ภาพ เฟรมระหว่างกลางจะถูกใช้ตามลำดับในอาร์เรย์ โดยโมเดลเป็นตัวกำหนดเวลาของแต่ละเฟรม

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

javascriptคัดลอก
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

พารามิเตอร์คำขอ

จำเป็น

ไม่บังคับ

ภาพ วิดีโอ และเสียงอ้างอิงเป็นตัวเลือกทั้งหมด คุณสามารถระบุสื่อเพียงประเภทเดียว ใช้หลายประเภทร่วมกัน หรือไม่ระบุทั้งสามประเภทก็ได้

ค่า duration ของผลลัพธ์ตั้งค่าแยกต่างหากเป็น 3-30 วินาที และไม่นับรวมในขีดจำกัดความยาวรวมของวิดีโออ้างอิง

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

javascriptคัดลอก
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

พารามิเตอร์คำขอ

จำเป็น

ไม่บังคับ

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

javascriptคัดลอก
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

พารามิเตอร์คำขอ

จำเป็น

ไม่บังคับ

อย่าส่ง aspect_ratio เพราะผลลัพธ์จะใช้อัตราส่วนภาพของวิดีโอต้นฉบับ ผลลัพธ์ประกอบด้วยวิดีโอทั้งหมด ทั้งต้นฉบับและช่วงที่ต่อเพิ่ม โดยความยาวรวมเท่ากับความยาววิดีโอต้นฉบับบวก duration

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

javascriptคัดลอก
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

หลักเกณฑ์การคิดค่าบริการ

Text-to-Video และ Image-to-Video คิดค่าบริการตามความละเอียดผลลัพธ์และความยาววิดีโอที่สร้าง ส่วน Video Extend คิดค่าบริการตามความละเอียดและความยาวของช่วงที่ต่อเพิ่ม ไม่ใช่ความยาวทั้งหมดของวิดีโอที่ส่งกลับ

คำขอ Reference-to-Video ที่มีวิดีโออ้างอิงและคำขอ Video Edit จะนำความยาวทั้งวิดีโอขาเข้าและขาออกมาคิดค่าบริการตามความละเอียดที่เลือก ความยาววิดีโอขาเข้าที่ใช้คิดค่าบริการมีขั้นต่ำ 3 วินาทีและสูงสุด 30 วินาที หากมีวิดีโออ้างอิงหลายรายการ ขอบเขตนี้จะใช้กับความยาวรวม ไม่ใช่แยกใช้กับแต่ละวิดีโอ ขอบเขตความยาวที่ใช้คิดค่าบริการไม่ได้เป็นตัวกำหนดข้อจำกัดในการอัปโหลด

เมื่อไม่มีวิดีโออ้างอิง Reference-to-Video จะใช้หลักเกณฑ์การคิดค่าบริการเดียวกับ Text-to-Video ไม่ว่าจะระบุภาพหรือเสียงอ้างอิงหรือไม่ก็ตาม สำหรับคำขอที่มีวิดีโอขาเข้า ภาพอ้างอิง เสียงอ้างอิง และ keep_original_sound ที่รองรับจะไม่มีค่าบริการแยกเพิ่มเติม

รูปแบบการตอบกลับ

การตอบกลับเริ่มต้น

ทุกโมเดลส่งค่า task_id กลับมาสำหรับการสอบถามสถานะซ้ำเป็นระยะ:

jsonคัดลอก
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

สอบถามซ้ำเป็นระยะด้วย GET /api/v1/video/{task_id} เพื่อตรวจสอบสถานะและรับวิดีโอที่สร้าง

ค่าสถานะ

• submitted: รับงานแล้วและกำลังรอประมวลผล
• processing: กำลังสร้างวิดีโอ
• succeed: สร้างวิดีโอเสร็จสมบูรณ์
• failed: สร้างวิดีโอไม่สำเร็จ

แนวทางปฏิบัติที่แนะนำ

1. พารามิเตอร์ที่จำเป็น: ระบุ resolution และ duration เสมอ รวมถึงเมื่อใช้ความละเอียดเริ่มต้น 720p
2. จำนวนเฟรม: ให้เฟรมแรก เฟรมสุดท้าย และเฟรมระหว่างกลางรวมกันไม่เกิน 10 ภาพ
3. สื่ออ้างอิง: ให้จำนวนและความยาวของสื่ออ้างอิงอยู่ภายในขอบเขตที่ระบุในเอกสาร
4. เสียงต้นฉบับ: ใช้ keep_original_sound เฉพาะกับ Reference-to-Video หรือ Video Edit
5. การต่อความยาววิดีโอ: ตั้งค่า duration เป็นความยาวที่ต้องการเพิ่มและละ aspect_ratio ไว้