> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Texto a video
> Genera videos a partir de indicaciones de texto con la API de Krea usando Veo 3.1, Kling 2.5, Hailuo y otros modelos para clips cinematográficos, animación y narración.
export const ModelOverviewCard = ({name, description, icon, href}) => {
const resolvedIcon = (() => {
if (typeof icon !== "string" || !icon.startsWith("/") || icon.startsWith("//")) return icon;
if (typeof window === "undefined") return icon;
const base = "/docs";
const under = window.location.pathname === base || window.location.pathname.startsWith(base + "/");
return under && !icon.startsWith(base + "/") ? base + icon : icon;
})();
return
{}
***
La generación de video suele tardar más que la de imagen. Prepárate para tiempos de procesamiento más largos según la duración y la calidad configuradas.
## Paso 1: Generar un video
Realiza una solicitud POST a `/generate/video/kling/kling-2.5` con tu prompt y los parámetros de video. La API devuelve un ID de trabajo de inmediato.
```javascript Node.js theme={null}
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";
const krea = new Krea({ apiKey: process.env.KREA_API_KEY });
const job = await krea.video("kling/kling-2.5", {
prompt: "a majestic eagle soaring over snow-capped mountains at sunrise",
duration: 5,
aspect_ratio: "16:9"
});
console.log(`Job ID: ${job.job_id}`);
```
```bash cURL theme={null}
curl -X POST https://api.krea.ai/generate/video/kling/kling-2.5 \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a majestic eagle soaring over snow-capped mountains at sunrise",
"duration": 5,
"aspect_ratio": "16:9"
}'
```
```python Python theme={null}
import requests
API_BASE = "https://api.krea.ai"
API_TOKEN = "YOUR_API_TOKEN"
response = requests.post(
f"{API_BASE}/generate/video/kling/kling-2.5",
headers={
"Authorization": f"Bearer {API_TOKEN}",
"Content-Type": "application/json"
},
json={
"prompt": "a majestic eagle soaring over snow-capped mountains at sunrise",
"duration": 5,
"aspect_ratio": "16:9"
}
)
job = response.json()
print(f"Job ID: {job['job_id']}")
```
```go Go theme={null}
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
apiBase := "https://api.krea.ai"
apiToken := "YOUR_API_TOKEN"
payload := map[string]interface{}{
"prompt": "a majestic eagle soaring over snow-capped mountains at sunrise",
"duration": 5,
"aspect_ratio": "16:9",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", apiBase+"/generate/video/kling/kling-2.5", bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer "+apiToken)
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var job map[string]interface{}
json.NewDecoder(resp.Body).Decode(&job)
fmt.Printf("Job ID: %s\n", job["job_id"])
}
```
**Reemplaza con tu token de API**
Para reemplazar el marcador YOUR\_API\_TOKEN de los ejemplos anteriores, necesitarás generar un token de API en [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens). Sigue las instrucciones de la página [API Keys & Billing](/developers/api-keys-and-billing) si necesitas ayuda.
**Ejemplo de respuesta**
```json theme={null}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
```
***
## Paso 2: Consultar los resultados
La generación de video tarda más que la de imagen. Consulta `/jobs/{job_id}` cada 5 segundos para verificar el progreso.
**¡Webhooks disponibles!**
Configura webhooks para recibir notificaciones cuando los trabajos se completen. Consulta la [guía de Webhooks](/developers/webhooks) para comenzar.
```javascript Node.js theme={null}
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";
const krea = new Krea({ apiKey: process.env.KREA_API_KEY });
async function waitForVideo(jobId) {
const completed = await krea.jobs.wait(jobId, { intervalMs: 5000 });
return completed.result.urls[0];
}
const videoUrl = await waitForVideo(job.job_id);
console.log(`Video ready: ${videoUrl}`);
```
```bash cURL theme={null}
curl -X GET https://api.krea.ai/jobs/YOUR_JOB_ID \
-H "Authorization: Bearer YOUR_API_TOKEN"
```
```python Python theme={null}
import time
def wait_for_video(job_id):
while True:
response = requests.get(
f"{API_BASE}/jobs/{job_id}",
headers={"Authorization": f"Bearer {API_TOKEN}"}
)
job = response.json()
if job["status"] == "completed":
return job["result"]["urls"][0]
if job["status"] in ("failed", "cancelled"):
raise Exception(f"Job failed: {job['status']}")
# Show progress if available
if "progress" in job:
print(f"Progress: {job['progress']}%")
else:
print(f"Status: {job['status']}")
time.sleep(5)
video_url = wait_for_video(job["job_id"])
print(f"Video ready: {video_url}")
```
```go Go theme={null}
func waitForVideo(jobID string) (string, error) {
for {
req, _ := http.NewRequest("GET", apiBase+"/jobs/"+jobID, nil)
req.Header.Set("Authorization", "Bearer "+apiToken)
resp, _ := client.Do(req)
var job map[string]interface{}
json.NewDecoder(resp.Body).Decode(&job)
resp.Body.Close()
switch job["status"] {
case "completed":
result := job["result"].(map[string]interface{})
urls := result["urls"].([]interface{})
return urls[0].(string), nil
case "failed", "cancelled":
return "", fmt.Errorf("job failed: %s", job["status"])
}
// Show progress if available
if progress, ok := job["progress"]; ok {
fmt.Printf("Progress: %.0f%%\n", progress)
} else {
fmt.Printf("Status: %s\n", job["status"])
}
time.Sleep(5 * time.Second)
}
}
```
**Ejemplo de respuesta completada**
```json theme={null}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"created_at": "2025-01-15T10:30:00.000Z",
"completed_at": "2025-01-15T10:31:45.000Z",
"result": {
"urls": ["https://gen.krea.ai/videos/your-video.mp4"]
}
}
```
**¡Webhooks disponibles!**
Configura webhooks para recibir notificaciones cuando los trabajos se completen. Consulta la [guía de Webhooks](/developers/webhooks) para comenzar.
***
## Parámetros comunes
Para ver la lista detallada de parámetros de todos los modelos, consulta la página de [Model APIs](/api-reference/introduction).
| Parámetro | Tipo | Descripción |
| -------------- | ------ | -------------------------------------------------------------------------- |
| `prompt` | string | Descripción detallada del contenido del video |
| `duration` | number | Duración del video en segundos. Los valores admitidos dependen del modelo. |
| `aspect_ratio` | string | Proporción del video, por ejemplo `16:9`, `9:16` o `1:1` |
| `start_image` | string | URL opcional de la imagen fuente para modelos de imagen a video |
| `end_image` | string | URL opcional del fotograma final para los modelos que lo admiten |
| `mode` | string | Modo de calidad opcional para los modelos que lo exponen |
| `model` | string | Modelo de generación de video a usar |
**Consejos de prompt para mejores videos:**
* Sé específico sobre el movimiento y el movimiento de cámara
* Describe la escena, la iluminación y la atmósfera
* Menciona la temporización (por ejemplo, “panorámica lenta”, “zoom rápido”)
* Incluye referencias de estilo (por ejemplo, “cinematográfico”, “estilo documental”)
La generación de video cuesta más que la de imagen. Consulta [API Keys & Billing](/developers/api-keys-and-billing) para ver los precios por modelo y cómo recargar el saldo de tu API.
}