Kling v3.0 Pro Text-to-Video API by Kuaishou
kwaivgi/kling-v3.0-pro/text-to-video
Text-to-video
Kling v3.0 Professional Text-to-Video model by Kuaishou. Premium quality video generation from text prompts with advanced features.
Entrada
Cargando configuración de parámetros...
Salida
InactivoLos videos generados se mostrarán aquí
Configura los parámetros y haz clic en ejecutar para comenzar a generar
Cada ejecución costará $0.095. Con $10 puedes ejecutar aproximadamente 105 veces.
Puedes continuar con:
Ejemplo de código
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-v3.0-pro/text-to-video",
"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()Instalar
Instala el paquete necesario para tu lenguaje de programación.
bash
pip install requestsAutenticación
Todas las solicitudes de API requieren autenticación mediante una clave de API. Puedes obtener tu clave de API desde el panel de Atlas Cloud.
bash
export ATLASCLOUD_API_KEY="your-api-key-here"Encabezados HTTP
python
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}Mantén tu clave de API segura
Nunca expongas tu clave de API en código del lado del cliente ni en repositorios públicos. Usa variables de entorno o un proxy de backend en su lugar.
Enviar una solicitud
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())Enviar una solicitud
Envía una solicitud de generación asíncrona. La API devuelve un ID de predicción que puedes usar para verificar el estado y obtener el resultado.
POST
/api/v1/model/generateVideoCuerpo de la solicitud
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-v3.0-pro/text-to-video",
"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']}")Respuesta
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}Verificar estado
Consulta el endpoint de predicción para verificar el estado actual de tu solicitud.
GET
/api/v1/model/prediction/{prediction_id}Ejemplo de polling
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)Valores de estado
processingLa solicitud aún se está procesando.completedLa generación está completa. Las salidas están disponibles.succeededLa generación fue exitosa. Las salidas están disponibles.failedLa generación falló. Verifica el campo de error.Respuesta completada
{
"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"
}
}Subir archivos
Sube archivos al almacenamiento de Atlas Cloud y obtén una URL que puedes usar en tus solicitudes de API. Usa multipart/form-data para subir.
POST
/api/v1/model/uploadMediaEjemplo de carga
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}")Respuesta
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Schema de entrada
Los siguientes parámetros se aceptan en el cuerpo de la solicitud.
Total: 0Obligatorio: 0Opcional: 0
No hay parámetros disponibles.
Ejemplo de cuerpo de solicitud
json
{
"model": "kwaivgi/kling-v3.0-pro/text-to-video"
}Schema de salida
La API devuelve una respuesta de predicción con las URL de salida generadas.
idstringrequired
Unique identifier for the prediction.
statusstringrequired
Current status of the prediction.
processingcompletedsucceededfailed
modelstringrequired
The model used for generation.
outputsarray[string]
Array of output URLs. Available when status is "completed".
errorstring
Error message if status is "failed".
metricsobject
Performance metrics.
predict_timenumber
Time taken for video generation in seconds.
created_atstringrequired
ISO 8601 timestamp when the prediction was created.
completed_atstring
ISO 8601 timestamp when the prediction was completed.
Ejemplo de respuesta
json
{
"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 integra más de 300 modelos de IA directamente en tu asistente de codificación con IA. Un solo comando para instalar y luego usa lenguaje natural para generar imágenes, videos y chatear con LLM.
Clientes compatibles
Claude Code
OpenAI Codex
Gemini CLI
Cursor
Windsurf
VS Code
Trae
GitHub Copilot
Cline
Roo Code
Amp
Goose
Replit
40+ clientes compatibles
Instalar
bash
npx skills add AtlasCloudAI/atlas-cloud-skillsConfigurar clave de API
Obtén tu clave de API desde el panel de Atlas Cloud y configúrala como variable de entorno.
bash
export ATLASCLOUD_API_KEY="your-api-key-here"Funcionalidades
Una vez instalado, puedes usar lenguaje natural en tu asistente de IA para acceder a todos los modelos de Atlas Cloud.
Generación de imágenesGenera imágenes con modelos como Nano Banana 2, Z-Image y más.
Creación de videosCrea videos a partir de texto o imágenes con Kling, Vidu, Veo, etc.
Chat con LLMChatea con Qwen, DeepSeek y otros modelos de lenguaje de gran escala.
Carga de mediosSube archivos locales para flujos de trabajo de edición de imágenes e imagen a video.
Más información
MCP Server
Atlas Cloud MCP Server conecta tu IDE con más de 300 modelos de IA a través del Model Context Protocol. Funciona con cualquier cliente compatible con MCP.
Clientes compatibles
Cursor
VS Code
Windsurf
Claude Code
OpenAI Codex
Gemini CLI
Cline
Roo Code
100+ clientes compatibles
Instalar
bash
npx -y atlascloud-mcpConfiguración
Agrega la siguiente configuración al archivo de configuración de MCP de tu IDE.
json
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}Herramientas disponibles
atlas_generate_imageGenera imágenes a partir de indicaciones de texto.
atlas_generate_videoCrea videos a partir de texto o imágenes.
atlas_chatChatea con modelos de lenguaje de gran escala.
atlas_list_modelsExplora más de 300 modelos de IA disponibles.
atlas_quick_generateCreación de contenido en un solo paso con selección automática de modelo.
atlas_upload_mediaSube archivos locales para flujos de trabajo de API.
Más información
API Schema
Schema no disponibleSin ejemplos disponibles
Por favor inicia sesión para ver el historial de solicitudes
Necesitas iniciar sesión para acceder al historial de solicitudes del modelo.
Iniciar SesiónKling V3.0 Pro Text-to-Video
Kling V3.0 Pro is Kuaishou's highest-quality text-to-video model, delivering superior visual fidelity and motion realism over the Standard tier. With synchronized sound generation, voice support, and precise creative controls, it produces cinematic-grade video from text descriptions.
Why Choose This?
- Pro-tier quality Superior visual detail, motion smoothness, and cinematic rendering compared to Standard.
- Sound generation Optional synchronized sound effects generated alongside the video.
- Voice list support Add up to 2 custom voice entries for character dialogue.
- Negative prompt support Exclude unwanted elements for precise control over the output.
- CFG scale control Fine-tune the balance between prompt adherence and creative freedom.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the video scene and motion |
| negative_prompt | No | Elements to exclude from generation |
| duration | No | Video length: 5 or 10 seconds (default: 5) |
| aspect_ratio | No | Output ratio: 16:9 (default), 9:16, 1:1 |
| cfg_scale | No | Prompt adherence strength (default: 0.5) |
| sound | No | Generate synchronized sound (default: disabled) |
| voice_list | No | Custom voice entries, up to 2 (click "+ Add Item") |
How to Use
- Write your prompt — describe the scene, characters, motion, and style in detail.
- Add negative prompt (optional) — specify what you want to avoid.
- Set duration — 5 seconds or 10 seconds.
- Select aspect ratio — match your target platform.
- Adjust cfg_scale (optional) — higher for stricter prompt following, lower for more freedom.
- Enable sound (optional) — generate synchronized audio with the video.
- Add voices (optional) — add up to 2 voice entries for character dialogue.
- Run — submit and download your video.
Best Use Cases
- High-End Production — Cinematic scenes requiring maximum visual quality.
- Professional Marketing — Premium promotional videos with sound design.
- Short Films — Create film-quality scenes with dialogue and sound.
- Brand Content — Polished visual storytelling for brand campaigns.
- Creative Direction — Explore high-fidelity concepts for pre-production.
Pro Tips
- Use the Prompt Enhancer to refine your descriptions automatically.
- Include cinematography terms (handheld, rim light, backlight, depth of field) for more cinematic results.
- Enable sound for a complete video experience with synchronized audio.
- Use negative prompts to avoid common issues (e.g., "blurry, low quality, distorted").
- Match aspect ratio to your platform: 16:9 for YouTube, 9:16 for TikTok/Reels, 1:1 for Instagram.
- Use Standard tier for drafts and testing, Pro for final production.
Notes
- Only prompt is required; other parameters have defaults.
- Duration options are 5 or 10 seconds only.
- Voice list supports a maximum of 2 entries.
Related Models
- Kling V3.0 Pro Image-to-Video — Pro quality image-to-video generation.
- Kling V3.0 Standard Text-to-Video — Standard tier text-to-video at lower cost.
- Kling V3.0 Standard Image-to-Video — Standard tier image-to-video.
