
Kling Video O3 Pro Video-Edit API by Kuaishou
Kling Omni Video O3 Video-Edit enables conversational video editing through natural language commands. Professional quality with object removal/replacement, background changes, and effects.
输入
输出
空闲每次运行将花费 $0.143。$10 可运行约 69 次。
代码示例
import requests
import time
# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "kwaivgi/kling-video-o3-pro/video-edit",
"prompt": "A beautiful sunset over the ocean with gentle waves",
"width": 512,
"height": 512,
"duration": 3,
"fps": 24,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] in ["completed", "succeeded"]:
print("Generated video:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
video_url = check_status()安装
安装所需的依赖包。
pip install requests认证
所有 API 请求需要通过 API Key 进行认证。您可以在 Atlas Cloud 控制台获取 API Key。
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP 请求头
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。
提交请求
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())提交请求
提交一个异步生成请求。API 返回一个 prediction ID,您可以用它来检查状态和获取结果。
/api/v1/model/generateVideo请求体
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "kwaivgi/kling-video-o3-pro/video-edit",
"input": {
"prompt": "A beautiful sunset over the ocean with gentle waves"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")响应
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}检查状态
轮询 prediction 端点以检查请求的当前状态。
/api/v1/model/prediction/{prediction_id}轮询示例
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)状态值
processing请求仍在处理中。completed生成完成,输出可用。succeeded生成成功,输出可用。failed生成失败,请检查 error 字段。完成响应
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}上传文件
将文件上传到 Atlas Cloud 存储,获取可在 API 请求中使用的 URL。使用 multipart/form-data 上传。
/api/v1/model/uploadMedia上传示例
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")响应
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Input Schema
以下参数在请求体中被接受。
暂无可用参数。
请求体示例
{
"model": "kwaivgi/kling-video-o3-pro/video-edit"
}Output Schema
API 返回包含生成输出 URL 的 prediction 响应。
响应示例
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills 将 300+ AI 模型直接集成到您的 AI 编程助手中。一条命令安装,即可用自然语言生成图像、视频和与 LLM 对话。
支持的客户端
安装
npx skills add AtlasCloudAI/atlas-cloud-skills设置 API Key
从 Atlas Cloud 控制台获取 API Key,并将其设置为环境变量。
export ATLASCLOUD_API_KEY="your-api-key-here"功能
安装后,您可以在 AI 助手中使用自然语言访问所有 Atlas Cloud 模型。
MCP Server
Atlas Cloud MCP Server 通过 Model Context Protocol 将您的 IDE 与 300+ AI 模型连接。支持任何兼容 MCP 的客户端。
支持的客户端
安装
npx -y atlascloud-mcp配置
将以下配置添加到您的 IDE 的 MCP 设置文件中。
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}可用工具
API Schema
Schema 不可用暂无可用示例
Kling Video O3 Pro Video Edit
Kling Video O3 Pro Video Edit is Kuaishou's most advanced video editing model, enabling natural-language-driven edits on existing video footage. Upload a video, describe the change you want — swap objects, alter scenes, shift styles — and get high-quality edited results with preserved motion and structure. Supports up to 4 reference images for precise visual guidance and optional original audio retention.
Why Choose This?
Prompt-driven editing Describe your edits in plain language — no timeline, no masks, no manual keyframing required.
Reference image support Attach up to 4 reference images to guide the target element, scene, or style in the output.
Audio preservation Keep the original soundtrack intact with the keep_original_sound option.
Scene-level understanding The model recognizes objects, backgrounds, and context within the video to apply accurate, context-aware edits.
Motion-consistent output Edits blend naturally across frames with strong temporal coherence — minimal flicker or ghosting.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the desired edit |
| video | Yes | Input video to edit (URL or upload) |
| images | No | Up to 4 reference images for element, scene, or style guidance |
| keep_original_sound | No | Whether to keep the original sound from the video (default: enabled) |
How to Use
- Run — submit and download the edited video.
- Set audio preference — toggle keep_original_sound to preserve or remove original audio.
- Add reference images (optional) — attach up to 4 images to steer the look of elements or styles.
- Write your prompt — describe exactly what should change (e.g., "Change the beer to Cola.").
- Upload your video — drag-and-drop, file upload, or paste a public URL.
Best Use Cases
- Storytelling & Film — Adjust scene details, atmosphere, or objects to refine narrative visuals in post-production.
- Creative Exploration — Experiment with style changes, scene swaps, and visual concepts on existing footage.
- E-commerce — Edit product videos to showcase different variants, colors, or settings from a single source clip.
- Brand & Marketing — Replace or update branded elements across video assets without reshooting.
- Social Media Campaigns — Quickly swap products, backgrounds, or props in short-form videos.
Pro Tips
- Ensure video URLs are publicly accessible — a preview thumbnail in the interface confirms the link works.
- Test edits on shorter clips first, then apply to longer footage once satisfied.
- Keep keep_original_sound enabled when audio continuity matters for your project.
- Reference images work best when they clearly represent the target element or style.
- Use clear, specific prompts describing exactly what should change for best results.
Notes
- If using a URL, make sure it is publicly accessible.
- Billed duration is clamped between 3 and 10 seconds regardless of actual video length.
- Both prompt and video are required fields.
Related Models
- Kling Video O3 Pro Reference-to-Video — Create videos guided by reference images for consistent character and style control.
- Kling Video O3 Std Image-to-Video — Animate still images into video with the cost-efficient O3 Standard model.
- Kling Video O3 Pro Text-to-Video — Generate videos from text prompts with O3 Pro's highest quality output.






