Documentos para desarrolladores UlazAI
Kling 3.0 API documentos para generar, cargar y fijar precios
Referencia de Kling 3.0
Kling 3.0 API documentos para generar, cargar y fijar precios
Para usar el Kling 3.0 API, empieza aquí:
utilizar POST /kling30/api/generate/ para crear empleos,
GET /kling30/api/status/{task_id}/ para sondear el estado de salida, y
POST /kling30/api/upload/ para fotogramas de origen. Soportes UlazAI
texto a vídeo y imagen a video con audio opcional,
disparos múltiples, control de inicio y final del fotograma y precios por segundo para los modos de calidad estándar, profesional y 4K.
Puntos finales principales
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Soporte actual
Renders de 3 a 15 segundos
Calidad estándar, profesional o 4K
Audio, multidisparos y control de fotogramas
El precio es por segundo. La duración admite segundos completos desde 3 a
15. Puede habilitar la opción de inscripción en Prompt Directory para aplicar una notificación inmediata.
-10 créditos descuento.
/kling30/api/generate/
Cree una tarea de generación Kling 3.0.
Autenticación
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonCuerpo de la solicitud
{
"prompt": "A cinematic tracking shot following a cyclist through a rainy neon city street.",
"generationMode": "text_to_video",
"durationSeconds": 8,
"qualityMode": "4K",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}Ejemplo de imagen a vídeo
{
"prompt": "The portrait slowly smiles while camera pushes in.",
"generationMode": "image_to_video",
"imageUrls": ["https://example.com/source.jpg"],
"durationSeconds": 5,
"qualityMode": "std",
"sound": false,
"startFrameUrl": "https://example.com/start.jpg",
"endFrameUrl": "https://example.com/end.jpg"
}Referencia de campo
prompt (cadena, requerida, máximo 2500)
modogeneración (obligatorio): text_to_video o image_to_video
URL de imagen (matriz): requerido para imagen a video a menos que se proporcionen URL de fotograma
duraciónSegundos (obligatorio): entero 3..15
modo calidad (obligatorio): std, pro, o 4K
sonido (opcional, booleano)
multidisparos (opcional, booleano)
relación de aspecto (opcional): 16:9, 9:16, 1:1 (no permitido cuando se establecen las URL del marco inicial/final)
inicioFrameUrl, URL del marco final (URL http(s) opcionales)
prompt_directory_optin (opcional, booleano): aplica descuento inmediato y comparte automáticamente en caso de éxito
Respuesta exitosa
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"provider_task_id": "281e5b0...f39b9",
"status": "processing",
"credits_used": 310,
"directory_discount_applied": 10,
"estimated_time": "varies by queue"
}/kling30/api/status/{task_id}/
Obtenga el estado de la tarea y la URL de salida cuando se complete.
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"status": "completed",
"video_url": "https://cdn.example.com/path/output.mp4",
"credits_charged": 310,
"prompt_submission_id": "70f4f6a9-2d17-4f31-81ac-8d57eecb9e21"
}
Valores de estado: pending, processing, completed, failed.
En caso de fracaso, los créditos se reembolsan automáticamente.
/kling30/api/upload/
Cargue imágenes de cuadro de origen/inicio/final (JPEG/PNG/WebP, máximo 10 MB) y reciba una URL pública para solicitudes de generación.
Matriz de precios (créditos por segundo)
Estándar
Sin audio: 20 /s
Con audio: 30 /s
Pro
Sin audio: 27 /s
Con audio: 40 /s
4K
67 /s
ejemplo de rizo
curl -X POST https://ulazai.com/kling30/api/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A heroic wide shot of a spaceship entering orbit above Earth.",
"generationMode": "text_to_video",
"durationSeconds": 10,
"qualityMode": "pro",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}'Códigos de error
- 400 carga útil no válida
- 401 autenticación no válida
- 402 créditos insuficientes
- 429 tasa limitada
- 500 aguas arriba/proveedor o falla interna