Ir al contenido

PixVerse C1 Reference To Video

Integrar

Id del modelo pixverse/c1/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixverse/c1/reference-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",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

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

Esta solicitud: 0,25 $ 250 créditos de API Ejecutar en esta página

Obtener clave de API
PixVerse Referencia a vídeo Audio nativoEntradas de referencia1–15 shasta 1080p #video-generation#reference-to-video#pixverse#character-consistency

Video C1 que mantiene la coherencia de personajes y fondos a partir de hasta 7 imágenes de referencia

PixVerse · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud abajo 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 de referencia a video, donde las referencias cargadas se indican con @ref_name. Incluso un texto visualmente breve puede superar el máximo de 2048 bytes en UTF-8: los emojis, las letras acentuadas y los caracteres no latinos ocupan varios bytes cada uno, por lo que el límite se aplica al tamaño codificado, no al recuento de caracteres.

aspect_ratio predeterminado 16:9

Relación de aspecto del video de salida.

resolution predeterminado 720p

Resolución del video de salida.

predeterminado 5

Duración del video generado, de 1 a 15 segundos.

•obligatorio

Imágenes de referencia proporcionadas con un tipo y ref_name para cada entrada, de modo que cada imagen pueda indicarse en el prompt mediante @ref_name.

Avanzado seed · enable_safety_checker

Semilla para la generación de video repetible. La reproducción exacta en cada ejecución requiere mantener sin cambios la versión del modelo, el prompt y la semilla.

POST /run/pixverse/c1/reference-to-video?wait=20 cotización → 0,25 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixverse/c1/reference-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",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de PixVerse C1 Reference To Video

Genera un video a partir de 1 a 7 entradas en `image_references`, cada una con un tipo y un nombre. Usa `@ref_name` en el `prompt` para señalar una referencia. Admite ocho relaciones de aspecto, incluida 21:9 y 2:3, resoluciones de hasta 1080p, duraciones de 1 a 15 segundos y audio generado opcional.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Prompt de referencia a video, donde las referencias cargadas se indican con @ref_name. Incluso un texto visualmente breve puede superar el máximo de 2048 bytes en UTF-8: los emojis, las letras acentuadas y los caracteres no latinos ocupan varios bytes cada uno, por lo que el límite se aplica al tamaño codificado, no al recuento de caracteres.
aspect_ratioopcional
Tipoenum
Predeterminado16:9
16:94:31:13:49:162:33:221:9
Relación de aspecto del video de salida.
resolutionopcional
Tipoenum
Predeterminado720p
360p540p720p1080p
Resolución del video de salida.
durationopcional
Tipointeger
Predeterminado5
1 – 15
Duración del video generado, de 1 a 15 segundos.
seedopcional
Tipointeger | null
Semilla para la generación de video repetible. La reproducción exacta en cada ejecución requiere mantener sin cambios la versión del modelo, el prompt y la semilla.
generate_audio_switchopcional generate_audio
Tipoboolean
Predeterminadofalse
Interruptor de generación de audio para música de fondo, efectos de sonido y diálogo.
image_referencesobligatorio
Tipoobject[]
≤ 7 elementos
Imágenes de referencia proporcionadas con un tipo y ref_name para cada entrada, de modo que cada imagen pueda indicarse en el prompt mediante @ref_name.
image_references[].image_urlobligatorio
Tipourl · image
URL que apunta a la imagen de referencia.
image_references[].typeopcional
Tipoenum
Predeterminadosubject
subjectbackground
Categoría de referencia: 'subject' identifica un personaje u objeto, mientras que 'background' identifica una escena o entorno.
image_references[].ref_nameobligatorio
Tipostring
Identificador de referencia (ref_name): elige un nombre corto que permita al prompt indicar esta imagen como @ref_name.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
La moderación puede relajarse estableciendo false, siempre que el autor de la llamada esté autorizado.
obligatorio Nombre canónico, también aceptado

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/c1/reference-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": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  },
  "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
    }
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra 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}Archivo de video producido por la generación.

Más modelos: Referencia a vídeo

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