Kling · API de medios

Kling 3.0 API

Kling 3.0 es la ruta de vídeo de Kling en OmniaKey: texto a vídeo y primer fotograma con último opcional, en dos niveles estándar y alta calidad, con duraciones fijas de 5, 10 o 15 segundos.

Obtén tu clave API Leer la documentación

ID del modelo: kling-3.0
Proveedor: Kling
Modalidad: AI Vídeo
Por llamada correcta: $0,80–$3,00
Última verificación: 2026-09-16

Para qué sirve

Elige Kling 3.0 cuando la duración se conoce de antemano: std cuesta $0.80/$1.60/$2.40 y pro $1.00/$2.00/$3.00 por generación para 5/10/15 segundos. mode es obligatorio y, en imagen a vídeo, el formato lo marca el primer fotograma.

Qué hace

Texto a vídeo

kling-3.0

Genera un vídeo corto a partir de un texto.

Imagen a vídeo

kling-3.0

Anima una imagen fija en un vídeo corto.

Cómo llamarlo

Los modelos de medios funcionan de forma asíncrona: crea una tarea, consúltala hasta que termine y descarga la URL firmada del recurso.

Crear, consultar, descargar

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-3.0-001" \
  -d '{
    "model": "kling-3.0",
    "type": "video",
    "operation": "text_to_video",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"duration": 6, "resolution": "720p"}
  }'

# 2. The same model id and the same poll loop serve the other operations:
#      image_to_video         media[] type "first_frame"
#    Reference media travel alongside the prompt:
#    {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
#    A public HTTPS URL or a base64 data URI both work.

# 3. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 4. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"

Precio

Los trabajos de vídeo se cobran por segundo de salida generado, no por token. Los trabajos fallidos o cancelados se reembolsan automáticamente.

Por llamada correcta

$0,80–$3,00por llamada

mode | duration

std|5: $0,80por llamada
std|10: $1,60por llamada
std|15: $2,40por llamada
pro|5: $1,00por llamada
pro|10: $2,00por llamada
pro|15: $3,00por llamada

Más modelos de Kling

Kling 3.0 Turbo

kling-3-turbo

Preguntas frecuentes

¿Cómo llamo a Kling 3.0 en OmniaKey?

Envía un POST a /v1/media/tasks con el id del modelo, type "video" y operation "text_to_video"; o "image_to_video" con un primer fotograma en input.media[] (type "first_frame"). Reutiliza la misma Idempotency-Key en los reintentos para que un timeout nunca inicie un segundo trabajo de pago.

¿Cuánto cuesta Kling 3.0?

Kling 3.0 se cobra a $0,80–$3,00 por llamada de vídeo generado. La creación pre-cobra la duración solicitada de tu saldo prepago y los trabajos fallidos o cancelados se reembolsan automáticamente.

¿Por qué la API devuelve un id de tarea en lugar del vídeo?

El renderizado de vídeo tarda entre un minuto y varios minutos, así que OmniaKey ejecuta todas las rutas de vídeo con el mismo ciclo asíncrono. Consulta GET /v1/media/tasks/{id} hasta que el estado sea succeeded y luego lee la URL firmada del recurso.