Ir al contenido

Ltx 2.3 Quality · Reference Video to Video

Integrar

ID del modelo ltx-2.3-quality/reference-video-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Archivos como el ejemplo: 0,27 $ 270 créditos de API · ≈ 29,05 ₽ tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
Lightricks · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio

Prompt utilizado para dirigir la generación.

•obligatorio video_url
Suelta un archivo o

URL que apunta a un vídeo de referencia usado para guiar el movimiento y la estructura.

resolution predeterminado auto

Dimensiones del vídeo de salida, que también afectan a la duración estable: los tamaños menores permiten más fotogramas, mientras que los mayores reducen el máximo. La estimación de control integrada mantiene el tamaño cerca del flujo de trabajo de control oficial; el control directo mediante `skip_control_preprocess` y `control_video_url` respeta las dimensiones explícitas con alineación de 64px. En el modo de control directo, `auto` hereda las dimensiones y la relación de aspecto del origen dentro de los límites de LTX.

predeterminado 121

Número de fotogramas de salida, sujeto a un presupuesto de estabilidad de IC-LoRA basado en la resolución multiplicada por los fotogramas. Una respuesta 422 indica que se ha superado ese presupuesto: reduce la resolución o `num_frames`. El presupuesto permite aproximadamente 150 fotogramas con dimensiones de clase 720p y más con tamaños menores.

Avanzado negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
predeterminado color distortion, ove...

Prompt negativo que especifica lo que debe evitar la generación.

Suelta un archivo o

Vídeo de control precalculado opcional, usado en lugar de la estimación de control integrada cuando se proporciona junto con `skip_control_preprocess`. Se convierte en la señal de control directa después de remuestrearse para coincidir con las dimensiones de salida y el número de fotogramas. El vídeo puede contener, por ejemplo, una composición de profundidad, bordes o pose ya renderizada.

image_url
Suelta un archivo o

Estilo de anclaje de imagen o identidad de personaje opcional como fotograma clave del primer fotograma.

Suelta un archivo o

Apariencia opcional de anclaje de imagen cerca del punto medio del clip, que complementa el fotograma clave inicial `image_url`. Ayuda a que la apariencia siga el movimiento de la cámara en lugar de desviarse; requiere `image_url`.

end_image_url
Suelta un archivo o

Apariencia opcional de anclaje de imagen en el fotograma final del clip. Resulta útil cuando el movimiento de la cámara termina en una ubicación distinta de la imagen inicial; requiere `image_url`.

video_quality predeterminado high

Preajuste de calidad aplicado al vídeo de salida.

video_write_mode predeterminado balanced

Modo de escritura del vídeo resultante.

predeterminado 0.6

La libertad para modificar el movimiento y la estructura del vídeo de referencia se controla mediante esta intensidad de condicionamiento: los valores más pequeños permiten cambios mayores.

predeterminado 1

Control de eliminación de ruido para el muestreo de vídeo a vídeo de referencia, cuyo efecto depende de `preserve_original_video`. Cuando ese modo está desactivado, solo acorta la planificación de eliminación de ruido; cuando está activado, controla la transformación de los píxeles de origen: 1.0 lo regenera todo y los valores inferiores conservan más (por ejemplo, 0.5 conserva aproximadamente el 50 %).

predeterminado 24

Frecuencia de fotogramas del vídeo de salida, medida en fotogramas por segundo.

predeterminado 15

Establece cuántos pasos de inferencia ejecutar, hasta 30; si no se modifica, usa 15.

predeterminado 1

Ajusta la guía sin clasificador mediante esta escala; su ajuste predeterminado busca alta calidad y generación rápida.

Semilla que hace reproducible la generación. Establecerla en None selecciona una semilla aleatoriamente.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 presupuesto → 0,27 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Ltx 2.3 Quality · Reference Video to Video

Crea un vídeo nuevo a partir de un `prompt` obligatorio y un `video_url` de referencia que proporciona movimiento y estructura. `image_url`, `mid_image_url` y `end_image_url` opcionales fijan el aspecto al principio, en el centro y al final. `video_strength` y `strength` (ambos 0 to 1) controlan hasta qué punto sigue o conserva la fuente, y `control_video_url` puede proporcionar una señal de control precalculada. `resolution` ofrece ajustes automáticos o predefinidos fijos, como cuadrado y vertical u horizontal 16:9.

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Prompt utilizado para dirigir la generación.
video_urlobligatorio video
Tipourl · video
URL que apunta a un vídeo de referencia usado para guiar el movimiento y la estructura.
control_video_urlopcional
Tipourl · video
Vídeo de control precalculado opcional, usado en lugar de la estimación de control integrada cuando se proporciona junto con `skip_control_preprocess`. Se convierte en la señal de control directa después de remuestrearse para coincidir con las dimensiones de salida y el número de fotogramas. El vídeo puede contener, por ejemplo, una composición de profundidad, bordes o pose ya renderizada.
skip_control_preprocessopcional
Tipoboolean
Predeterminadofalse
Modo de control directo que usa `control_video_url` en lugar de estimar internamente la profundidad, los bordes o la pose; sin esa URL, esta configuración se ignora. En este modo, el tamaño de salida respeta las dimensiones explícitas con alineación de 64 para mantener sincronizados los vídeos RGB y de control, mientras que `auto` toma las dimensiones y la relación de aspecto del origen dentro de los límites de LTX.
preserve_original_videoopcional
Tipoboolean
Predeterminadofalse
Modo de conservación del vídeo original, disponible solo con `skip_control_preprocess`, `video_url` y `control_video_url`. Desactivado de forma predeterminada, mantiene intacto el procesamiento de control estándar; al activarlo, inicia la generación desde `video_url` y conserva la guía estructural de `control_video_url`. La eliminación de ruido mediante `strength` establece la cantidad conservada: los valores bajos conservan más píxeles originales.
image_urlopcional image
Tipourl · image
Estilo de anclaje de imagen o identidad de personaje opcional como fotograma clave del primer fotograma.
mid_image_urlopcional
Tipourl · image
Apariencia opcional de anclaje de imagen cerca del punto medio del clip, que complementa el fotograma clave inicial `image_url`. Ayuda a que la apariencia siga el movimiento de la cámara en lugar de desviarse; requiere `image_url`.
end_image_urlopcional end_image
Tipourl · image
Apariencia opcional de anclaje de imagen en el fotograma final del clip. Resulta útil cuando el movimiento de la cámara termina en una ubicación distinta de la imagen inicial; requiere `image_url`.
video_strengthopcional
Tiponumber
Predeterminado0.6
0 – 1
La libertad para modificar el movimiento y la estructura del vídeo de referencia se controla mediante esta intensidad de condicionamiento: los valores más pequeños permiten cambios mayores.
strengthopcional
Tiponumber
Predeterminado1
0 – 1
Control de eliminación de ruido para el muestreo de vídeo a vídeo de referencia, cuyo efecto depende de `preserve_original_video`. Cuando ese modo está desactivado, solo acorta la planificación de eliminación de ruido; cuando está activado, controla la transformación de los píxeles de origen: 1.0 lo regenera todo y los valores inferiores conservan más (por ejemplo, 0.5 conserva aproximadamente el 50 %).
num_framesopcional
Tipointeger
Predeterminado121
9 – 481
Número de fotogramas de salida, sujeto a un presupuesto de estabilidad de IC-LoRA basado en la resolución multiplicada por los fotogramas. Una respuesta 422 indica que se ha superado ese presupuesto: reduce la resolución o `num_frames`. El presupuesto permite aproximadamente 150 fotogramas con dimensiones de clase 720p y más con tamaños menores.
resolutionopcional
Tipoobject
Predeterminadoauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiones del vídeo de salida, que también afectan a la duración estable: los tamaños menores permiten más fotogramas, mientras que los mayores reducen el máximo. La estimación de control integrada mantiene el tamaño cerca del flujo de trabajo de control oficial; el control directo mediante `skip_control_preprocess` y `control_video_url` respeta las dimensiones explícitas con alineación de 64px. En el modo de control directo, `auto` hereda las dimensiones y la relación de aspecto del origen dentro de los límites de LTX.
frames_per_secondopcional
Tiponumber
Predeterminado24
1 – 60
Frecuencia de fotogramas del vídeo de salida, medida en fotogramas por segundo.
num_inference_stepsopcional
Tipointeger
Predeterminado15
8 – 30
Establece cuántos pasos de inferencia ejecutar, hasta 30; si no se modifica, usa 15.
guidance_scaleopcional
Tiponumber
Predeterminado1
1 – 20
Ajusta la guía sin clasificador mediante esta escala; su ajuste predeterminado busca alta calidad y generación rápida.
generate_audioopcional
Tipoboolean
Predeterminadotrue
Interruptor de la pista de audio del MP4 devuelto: desactivado produce un archivo solo de vídeo y activado incluye audio.
negative_promptopcional
Tipostring
Predeterminadocolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
Prompt negativo que especifica lo que debe evitar la generación.
seedopcional
Tipointeger | null
Semilla que hace reproducible la generación. Establecerla en None selecciona una semilla aleatoriamente.
enable_prompt_expansionopcional
Tipoboolean
Predeterminadotrue
Controla si está habilitada la expansión del prompt.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
Controla si está activada la comprobación de seguridad.
video_qualityopcional
Tipoenum
Predeterminadohigh
lowmediumhighmaximum
Preajuste de calidad aplicado al vídeo de salida.
video_write_modeopcional
Tipoenum
Predeterminadobalanced
fastbalancedsmall
Modo de escritura del vídeo resultante.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 270,
    "usd": "0.27",
    "charged": 270,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}Vídeo producido por el modelo.
seed
integerSemilla aplicada realmente durante la generación.
prompt
stringPrompt de generación, incluida cualquier expansión aplicada antes de usarlo.

Más modelos: Vídeo a vídeo

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/ltx-2.3-quality/reference-video-to-video.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt