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-turbo | text_to_video | 5–10, अंतराल 5 | 720p, 1080p | 16:9, 9:16, 1:1 | on | कोई नहीं |
kling-v3-motion-control | reference_to_video | 3–10 सेकंड के रेफ़रेंस वीडियो के अनुसार | 720p, 1080p | न भेजें | off, on | reference_image, reference_video |
kling-v3-omni | text_to_video | 3–15, अंतराल 1 | 720p, 1080p, 4k | 16:9, 9:16, 1:1 | off, on | कोई नहीं |
kling-v3 | image_to_video | 3–15, अंतराल 1 | std, pro, 4k | न भेजें | off, on | first_frame, last_frame |
kling-v3 | text_to_video | 3–15, अंतराल 1 | std, pro, 4k | 16:9, 9:16, 1:1 | off, 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.mode | string | नहीं | on | on |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | off, on | off |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 3 |
output.aspect_ratio | string | नहीं | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | off, on | off |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
prompt | string | नहीं | स्ट्रिंग | कोई नहीं |
provider_options.kling.camera_axis | string | नहीं | horizontal, vertical, pan, tilt, roll, zoom | कोई नहीं |
provider_options.kling.camera_type | string | नहीं | simple, down_back, forward_up, right_turn_forward, left_turn_forward | कोई नहीं |
provider_options.kling.camera_value | integer | नहीं | -10–10, अंतराल 1, 0 नहीं हो सकता | कोई नहीं |
provider_options.kling.mode | string | नहीं | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | नहीं | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | off, on | off |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 3–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.format | string | नहीं | mp4 | mp4 |
prompt | string | नहीं | स्ट्रिंग | कोई नहीं |
provider_options.kling.camera_axis | string | नहीं | horizontal, vertical, pan, tilt, roll, zoom | कोई नहीं |
provider_options.kling.camera_type | string | नहीं | simple, down_back, forward_up, right_turn_forward, left_turn_forward | कोई नहीं |
provider_options.kling.camera_value | integer | नहीं | -10–10, अंतराल 1, 0 नहीं हो सकता | कोई नहीं |
provider_options.kling.mode | string | नहीं | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | नहीं | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, वैकल्पिक, अधिकतम 1 | jpg, jpeg, png | अधिकतम आकार 10 MB; चौड़ाई 300–100000 px; ऊंचाई 300–100000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpg, 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.mode | string | नहीं | off, on | off |
duration.mode | string | नहीं | auto | auto |
duration.seconds | integer | नहीं | न भेजें; अवधि 3–10 सेकंड के रेफ़रेंस वीडियो के अनुसार | कोई नहीं |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, 1 (ज़रूरी) | jpg, jpeg, png | अधिकतम आकार 10 MB; चौड़ाई 300–16384 px; ऊंचाई 300–16384 px |
reference_video | video, 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 कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।

