Skip to main content
POST

Autenticación

string
requerido
Todos los endpoints requieren autenticación mediante Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñadir al encabezado de la solicitud:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de video, fijado como wan2.6-i2v-flash
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
array<string>
requerido
Array de URLs de imágenes de referencia (solo se admite 1 imagen del primer fotograma)Admite URLs de imágenes accesibles públicamente o codificación Base64 (data:image/png;base64,...)Ejemplo: ["https://example.com/image.jpg"]
Requisitos de la imagen:
  • Formato: JPEG, JPG, PNG (sin transparencia), BMP, WEBP
  • Resolución: rango de ancho/alto 240-8000 píxeles
  • Tamaño: ≤ 10MB
string
Descripción del contenido del videoOpcional pero recomendado para image-to-video, describe las acciones y efectos esperadosEspecifique claramente el sujeto, la acción, la cámara y el estilo para obtener mejores resultadosEjemplo: "The person in the image smiles and waves, camera slowly zooms in"
string
Prompt negativo, describe contenido no deseadoMáximo 500 caracteresEjemplo: "blurry, low quality, distorted"
string
predeterminado:"1080p"
Resolución del videoOpciones:
  • 720p - HD
  • 1080p - FHD (por defecto)
Por defecto: 1080p
La resolución afecta directamente al precio, 1080p es más caro que 720p. La proporción de aspecto la determina la imagen de entrada.
integer
predeterminado:"5"
Duración del video (segundos)Rango soportado: 2 a 15 segundos (entero)Por defecto: 5
boolean
predeterminado:"true"
Si se debe generar audioEstablecer en true: genera automáticamente música de fondo / efectos de sonido que coincidan (por defecto)Establecer en false: produce un video silenciosoPor defecto: true
No se admite cuando el modelo es wan2.6-i2v.
string
URL de audio personalizado (wav/mp3, 3-30 segundos, ≤ 15MB)Tiene menor prioridad que audio: se ignora cuando audio=falseSi el audio es más largo que la duración del video, será recortado; si es más corto, la parte restante quedará en silencio
Requisitos del archivo de audio:
  • Formato: wav, mp3
  • Duración: 3-30 segundos
  • Tamaño: ≤ 15MB
boolean
predeterminado:"true"
Si se debe activar la reescritura inteligente del promptMejora significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamientoPor defecto: true
string
Tipo de toma, requiere prompt_extend=trueOpciones:
  • single - Toma única (por defecto), produce un video de toma única continua
  • multi - Multi-toma, produce un video narrativo con múltiples transiciones de toma
shot_type tiene mayor prioridad que prompt. Incluso si el prompt menciona “multi-toma”, establecer single seguirá produciendo una toma única.
integer
Semilla aleatoria (≥0), especificar la misma semilla puede reproducir resultados similaresEjemplo: 12345
boolean
predeterminado:"false"
Si se debe añadir una marca de agua “AI Generated” (esquina inferior derecha)Por defecto: false

Control de audio

Respuesta

integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta

Casos de uso

Caso 1: Solicitud mínima

Caso 2: Parámetros completos

Caso 3: Audio personalizado

Caso 4: Video silencioso

Caso 5: Plantilla de efecto

Caso 6: Imagen Base64

Consultar resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.