Kling 3.0 Pro Image to Video
یکپارچهسازی
kling-video/v3/pro/image-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling-video/v3/pro/image-to-video?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://vit.doitong.com/api/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/kling-video/v3/pro/image-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://vit.doitong.com/api/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": False,
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/kling-video/v3/pro/image-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/fa/developers/docs/mcp)
claude mcp add --transport http doitong-models https://vit.doitong.com/api/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "kling-video/v3/pro/image-to-video",
"input": {
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}
}
مدل Kling 3.0 Pro Image to Video (kling-video/v3/pro/image-to-video) را از طریق Doitong API فراخوانی کنید. مستندات عاملها: https://doitong.com/fa/developers/models/kling-video/v3/pro/image-to-video.md
POST https://vit.doitong.com/api/v1/run/kling-video/v3/pro/image-to-video?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}
اگر وضعیت پاسخ "queued" یا "running" است، GET https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20 را تا زمانی که وضعیت "succeeded" شود بهطور دورهای فراخوانی کنید؛ فایلها در outputs[].url قرار دارند. ارسال POST https://vit.doitong.com/api/v1/quote/kling-video/v3/pro/image-to-video با همان بدنه، قیمت دقیق را پیش از اجرا برمیگرداند.
این درخواست: $۰٫۵۶ ۵۶۰ اعتبار API اجرای آن در این صفحه
کلید API جدید شما. این کلید فقط همین حالا نمایش داده میشود و از قبل در کد و فیلد کلید API زیر قرار گرفته است. آن را محرمانه نگه دارید: هرگز آن را در کدی که در مرورگر اجرا میشود قرار ندهید.
نمونهها
ساخت درخواست
کنترلها از شِمای مدل تولید میشوند. با تغییر آنها، کد و قیمت بهروزرسانی میشوند.
/run/kling-video/v3/pro/image-to-video?wait=20
قیمت → $۰٫۵۶
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling-video/v3/pro/image-to-video?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://vit.doitong.com/api/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/kling-video/v3/pro/image-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://vit.doitong.com/api/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": False,
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/kling-video/v3/pro/image-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "kling-video/v3/pro/image-to-video",
"input": {
"prompt": "The paper boat drifts forward with the current, raindrops ripple around it, neon reflections shimmer on the wet street, the camera follows at water level.",
"image": "https://content.doitong.com/dev-api/2026/10/21/req_rrqclmu39lveihzpwxufalbn/0-oGMt1xgBCGjIy2tBNDIKy_MSH2rhkY.png",
"duration": 5,
"generate_audio": false
},
"wait_seconds": 20
}
}
}
اجرای این درخواست
کلید شما در این مرورگر باقی میماند: فقط به Doitong API ارسال میشود و فقط در صورت فعالکردن گزینه «یادآوری»، در localStorage ذخیره میشود. دریافت کلید API
درباره Kling 3.0 Pro Image to Video
مدل پرچمدار تبدیل تصویر به ویدیوی Kling، سوژهٔ تصویر آغازین را ثابت نگه میدارد و حرکت طبیعی، حرکت دوربین و بهطور پیشفرض صدای هماهنگ و گفتار اضافه میکند. برای کنترل پایان نما، تصویر پایانی بدهید؛ یک تولید را با promptهای جداگانه به چند نما تقسیم کنید یا شخصیتها و اشیای تکرارشونده را با عناصر مرجع ثابت نگه دارید. شکل فریم از تصویر آغازین پیروی میکند.
پارامترها
نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نامهای استاندارد
promptاختیاری
multi_promptاختیاری
multi_prompt[].promptالزامی
multi_prompt[].durationاختیاری
start_image_urlالزامی
image
durationاختیاری
generate_audioاختیاری
end_image_urlاختیاری
end_image
elementsاختیاری
elements[].frontal_image_urlاختیاری
elements[].reference_image_urlsاختیاری
elements[].video_urlاختیاری
elements[].voice_idاختیاری
shot_typeاختیاری
negative_promptاختیاری
cfg_scaleاختیاری
پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاریشده را میپذیرند. فایلها
خروجی
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "kling-video/v3/pro/image-to-video",
"status": "succeeded",
"created_at": "2026-10-20T12:00:00Z",
"started_at": "2026-10-20T12:00:02Z",
"completed_at": "2026-10-20T12:00:09Z",
"queue_position": null,
"cost": {
"credits": 560,
"usd": "0.56",
"charged": 560,
"refunded": 0
},
"input": {
"prompt": "The banana manager turns to the camera, smiles and waves while coworkers keep typing, gentle handheld camera",
"image": "https://content.doitong.com/images/gp/image_20260610003801_541d9719_316882.png",
"duration": 5
},
"output": {
"video": {
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
"content_type": "video/mp4",
"file_name": "0-output.mp4",
"file_size": 1843200
}
},
"outputs": [
{
"type": "video",
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
"content_type": "video/mp4",
"file_size": 1843200,
"width": 1280,
"height": 720,
"duration": 5,
"stored": true
}
],
"error": null,
"metrics": {
"inference_seconds": 6.8
},
"urls": {
"self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}
فیلدهای خروجی
- video
- object {url, content_type, file_name, file_size}ویدیوی تولیدشده توسط مدل.
گونههای دیگر Kling v3
مدلهای بیشتر: تصویر به ویدیو
برای عاملهای هوش مصنوعی: این صفحه بهصورت Markdown در دسترس است https://doitong.com/fa/developers/models/kling-video/v3/pro/image-to-video.md. همه مدلها و راهنماها: https://doitong.com/developers/llms.txt