इसे छोड़कर कंटेंट पर जाएं
मुफ़्त साइन अप करें
Kling

Kling वीडियो API: टेक्स्ट, इमेज और मोशन कंट्रोल

BetterToken API Key से Kling कनेक्ट करें और Model ID व ऑपरेशन के अनुसार फ़ील्ड, मीडिया और जनरेशन का तरीका चुनें।

टेक्स्ट या इमेज से वीडियो बनाएं, या किसी व्यक्ति की रेफ़रेंस इमेज और मोशन वीडियो से गति नियंत्रित करें। kling-v3 आउटपुट स्तर के लिए provider_options.kling.mode इस्तेमाल करता है। Omni, Turbo और Motion Control अपने-अपने रिज़ॉल्यूशन फ़ील्ड इस्तेमाल करते हैं।

अपनी BetterToken API Key तैयार करें। Base URL https://bettertoken.ai/v1 है और प्रमाणीकरण के लिए Authorization: Bearer YOUR_API_KEY इस्तेमाल करें। Model ID को अक्षरों के केस सहित हूबहू कॉपी करें।

नीचे हर request.json एक ही प्रक्रिया अपनाता है: अनुमान लें, निर्माण की पुष्टि करें, स्थिति देखें और डाउनलोड करें। अनुमान लेने से जनरेशन शुरू नहीं होता; टास्क बनाने से भुगतान वाला अनुरोध भेजा जाता है। मौजूदा लागत model plaza में देखें।

मॉडल और ऑपरेशन

नीचे की तालिका में हर ऑपरेशन के लिए उपलब्ध मान हैं। फ़ील्ड के डिफ़ॉल्ट मान, मीडिया की संख्या और संयोजन की सीमाएं संबंधित उपखंड में देखें। मीडिया आकार के लिए 1 MB = 1048576 बाइट है।

Model IDऑपरेशनअवधि (सेकंड)आउटपुट स्तरअनुपातऑडियोमीडिया भूमिकाएं
kling-3.0-turbotext_to_video5–10, अंतराल 5720p, 1080p16:9, 9:16, 1:1onकोई नहीं
kling-v3-motion-controlreference_to_video3–10 सेकंड के रेफ़रेंस वीडियो के अनुसार720p, 1080pन भेजेंoff, onreference_image, reference_video
kling-v3-omnitext_to_video3–15, अंतराल 1720p, 1080p, 4k16:9, 9:16, 1:1off, onकोई नहीं
kling-v3image_to_video3–15, अंतराल 1std, pro, 4kन भेजेंoff, onfirst_frame, last_frame
kling-v3text_to_video3–15, अंतराल 1std, pro, 4k16:9, 9:16, 1:1off, onकोई नहीं

kling-v3, output.resolution स्वीकार नहीं करता; इमेज से वीडियो में output.aspect_ratio भी स्वीकार नहीं करता। kling-v3-motion-control, provider_options स्वीकार नहीं करता। Turbo केवल 5 या 10 सेकंड के वीडियो बनाता है और ऑडियो हमेशा on रहता है।

नमूना मीडिया

इमेज से वीडियो और इमेज रेफ़रेंस वाले उदाहरण सफ़ेद मेज़ पर नीले सिरेमिक मग का इस्तेमाल करते हैं। आज़माने के लिए नमूना इमेज रखें, या पहले इसे ऐसे सार्वजनिक HTTPS मीडिया से बदलें जिसे इस्तेमाल करने का अधिकार आपके पास हो और जो इस पेज की सीमाएं पूरी करता हो।

वीडियो जनरेशन रेफ़रेंस: सफ़ेद मेज़ पर नीला सिरेमिक मग

मोशन कंट्रोल का उदाहरण लड़के की रेफ़रेंस इमेज और उसी लड़के का मोशन वीडियो इस्तेमाल करता है। प्रॉम्प्ट इसी व्यक्ति के मीडिया से मेल खाता है। वीडियो लगभग 5.04 सेकंड, 1280 × 720 और 24 fps है।

टेक्स्ट से वीडियो

kling-3.0-turbo

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींonon
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 9:16, 1:116:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

मीडिया की ज़रूरतें

यह ऑपरेशन मीडिया स्वीकार नहीं करता।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "kling-3.0-turbo",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।

kling-v3-omni

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींoff, onoff
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए3
output.aspect_ratiostringनहीं16:9, 9:16, 1:116:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

मीडिया की ज़रूरतें

यह ऑपरेशन मीडिया स्वीकार नहीं करता।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • output.resolution="4k" चुनने पर audio.mode="off" सेट करना ज़रूरी है।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "kling-v3-omni",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।

kling-v3

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींoff, onoff
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 9:16, 1:116:9
output.formatstringनहींmp4mp4
promptstringनहींस्ट्रिंगकोई नहीं
provider_options.kling.camera_axisstringनहींhorizontal, vertical, pan, tilt, roll, zoomकोई नहीं
provider_options.kling.camera_typestringनहींsimple, down_back, forward_up, right_turn_forward, left_turn_forwardकोई नहीं
provider_options.kling.camera_valueintegerनहीं-10–10, अंतराल 1, 0 नहीं हो सकताकोई नहीं
provider_options.kling.modestringनहींstd, pro, 4kstd
provider_options.kling.negative_promptstringनहींस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

यह ऑपरेशन मीडिया स्वीकार नहीं करता।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "kling-v3",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"aspect_ratio": "16:9"
},
"provider_options": {
"kling": {
"mode": "std"
}
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।

इमेज से वीडियो

kling-v3

इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींoff, onoff
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.formatstringनहींmp4mp4
promptstringनहींस्ट्रिंगकोई नहीं
provider_options.kling.camera_axisstringनहींhorizontal, vertical, pan, tilt, roll, zoomकोई नहीं
provider_options.kling.camera_typestringनहींsimple, down_back, forward_up, right_turn_forward, left_turn_forwardकोई नहीं
provider_options.kling.camera_valueintegerनहीं-10–10, अंतराल 1, 0 नहीं हो सकताकोई नहीं
provider_options.kling.modestringनहींstd, pro, 4kstd
provider_options.kling.negative_promptstringनहींस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, वैकल्पिक, अधिकतम 1jpg, jpeg, pngअधिकतम आकार 10 MB; चौड़ाई 300–100000 px; ऊंचाई 300–100000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpg, jpeg, pngअधिकतम आकार 10 MB; चौड़ाई 300–100000 px; ऊंचाई 300–100000 px

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • इनमें से कम से कम एक भूमिका दें: first_frame, last_frame।
  • last_frame देते समय provider_options.kling.camera_type सेट न करें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "kling-v3",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"provider_options": {
"kling": {
"mode": "std"
}
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

रेफ़रेंस जनरेशन

kling-v3-motion-control

रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींoff, onoff
duration.modestringनहींautoauto
duration.secondsintegerनहींन भेजें; अवधि 3–10 सेकंड के रेफ़रेंस वीडियो के अनुसारकोई नहीं
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, 1 (ज़रूरी)jpg, jpeg, pngअधिकतम आकार 10 MB; चौड़ाई 300–16384 px; ऊंचाई 300–16384 px
reference_videovideo, 1 (ज़रूरी)mp4, movअधिकतम आकार 100 MB; अवधि 3–10 सेकंड; इस भूमिका का कुल अधिकतम 10 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • अवधि अपने-आप तय होने दें, ताकि आउटपुट अवधि रेफ़रेंस वीडियो के अनुसार हो। duration.seconds न भरें।

ठीक 1 reference_image और 1 reference_video देना ज़रूरी है। अनुपात या अतिरिक्त provider_options सेट न करें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "kling-v3-motion-control",
"operation": "reference_to_video",
"prompt": "Animate the boy in the reference image following the motion in the reference video. Preserve his appearance.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "person",
"type": "image",
"role": "reference_image",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0-poster.jpg"
},
{
"id": "motion",
"type": "video",
"role": "reference_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

आधिकारिक संसाधन

BetterToken कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।