MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/Investigación de CometAPI

Cómo usar la API Wan 2.7: guía completa para desarrolladores

Aprende a utilizar la API de Wan 2.7 a través de CometAPI para la generación de texto a video e imagen a video, con ejemplos, precios, comparaciones y mejores prácticas.

CometAPI
Mia MarenEquipo de investigación de modelos de IA y API
Actualizado Sep 3, 2026 22 min de lectura
Cómo usar la API Wan 2.7: guía completa para desarrolladores
Usa este patrón

Haz la primera llamada a la API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

Respuesta rápida

Wan 2.7 es un conjunto multimodal de generación de video de Alibaba para flujos de trabajo de texto a video, imagen a video, generación guiada por referencias y edición. A través de Wan 2.7 en CometAPI, los desarrolladores usan el ID de modelo wan2.7 con el endpoint asíncrono POST /v1/videos. La integración tiene tres etapas operativas: enviar una tarea, sondear el ID de video devuelto y descargar el MP4 completado. La ruta en vivo admite salida 720p y 1080p y muestra el precio por segundo, por lo que la duración y la resolución determinan el costo estimado de generación. Comienza con una solicitud de texto a video de 5 segundos en 720p, valida el flujo de trabajo y luego agrega referencias de imagen o mayor resolución solo después de que funcione la ruta básica.

Importante alcance: Esta guía cubre Wan 2.7 Video a través de CometAPI. No describe el modelo de generación de imágenes Wan por separado, por lo que las especificaciones solo de imagen, como salida de imágenes fijas 4K, no se tratan como capacidades de Wan 2.7 Video.

Key Takeaways

  • CometAPI expone Wan 2.7 mediante un endpoint de video asíncrono estilo OpenAI en lugar de una respuesta de chat sincrónica.
  • La ruta usa el ID de modelo wan2.7 y POST /v1/videos.
  • Una integración completa debe conservar el ID de video devuelto, sondear el endpoint de estado, manejar fallos terminales y descargar el MP4 solo después del éxito.
  • La API nativa de texto a video de Wan 2.7 de Alibaba admite 720P y 1080P con duración de 2-15 segundos; la ruta de CometAPI usa sus propios nombres de campos unificados.
  • Existen flujos de trabajo de imagen a video, primer/último fotograma y continuación en la familia nativa de modelos de Alibaba, pero los campos avanzados disponibles mediante la ruta unificada deben verificarse frente a la documentación de la ruta en vivo.
  • La evidencia de benchmark público es más sólida para video a video: Wan 2.7 encabezó la categoría Design Arena. Ese resultado no debe generalizarse a todas las tareas de texto a video o imagen a video.
  • La métrica de producción más útil es el costo por clip aceptado, no solo el precio por segundo generado.

What Is Wan 2.7?

Wan 2.7 in Plain Developer Terms

Wan 2.7 no es simplemente un checkpoint de prompt a video. Alibaba describe una familia de video de cuatro partes que abarca Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v y Wan2.7-videoedit. Juntas, esas variantes cubren la generación desde texto, animación desde imágenes, control de sujeto o estilo guiado por referencia y transformación de video existente. Esto importa para el diseño de aplicaciones: un clip de marketing simple puede usar solo texto a video, mientras que un pipeline de producción con consistencia de personaje puede necesitar entradas de referencia, fotogramas anclados, guía de audio y edición iterativa.

En CometAPI, la ruta comprime intencionalmente la nomenclatura específica del proveedor en el ID de modelo del cliente wan2.7. La capacidad de generación subyacente sigue siendo Wan 2.7, pero la autenticación, las rutas de endpoint y los nombres de parámetros difieren de la API nativa de Alibaba Cloud.

Wan 2.7 Technical Specifications

SpecificationWan 2.7 Video
ProviderAlibaba / Wan
CometAPI model IDwan2.7
Native text-to-video IDswan2.7-t2v, wan2.7-t2v-2026-06-12
Native image-to-video IDwan2.7-i2v-2026-04-25
Main inputsText; image, audio or video in supported workflows
Main outputGenerated video with supported audio behavior
ModesT2V, I2V, R2V, video editing, first/last frame, continuation
Resolution720P and 1080P
T2V duration2-15 seconds; default 5 seconds
T2V aspect ratios16:9, 9:16, 1:1, 4:3, 3:4
Prompt limit5,000 characters for native Wan 2.7 T2V
Negative prompt limit500 characters
Audio formats and limitsWAV/MP3; 2-30 seconds; up to 15 MB
InvocationAsynchronous
Architecture / parameter countNot comprehensively confirmed in official API documentation

Specification boundary: Algunas páginas de catálogo describen una arquitectura o un recuento de parámetros, pero la documentación oficial de la API de video de Alibaba no publica una especificación de arquitectura completa para cada variante de Wan 2.7. La redacción editorial más segura es que el recuento total de parámetros y la arquitectura no se divulgan de manera exhaustiva.

What Can Wan 2.7 Do?

Text-to-video with timed multi-shot prompts.

Wan 2.7 puede interpretar cambios de plano escritos directamente en un prompt. Un desarrollador puede describir Plano 1, Plano 2 y Plano 3 con rangos de tiempo en lugar de depender de un campo separado de control de planos. Esto convierte al prompt en un storyboard compacto.

First- and last-frame control.

El flujo de trabajo nativo de imagen a video acepta medios de primer y último fotograma para que el modelo sintetice el movimiento entre dos anclas visuales. Esto es útil para transiciones de producto, cambios de pose y morphing de escenas.

Video continuation.

Una entrada nativa de tipo first_clip condiciona la siguiente porción del video. En este flujo de trabajo, la duración debe interpretarse según las reglas de la tarea del proveedor, por lo que las aplicaciones no deben asumir que siempre significa solo el segmento recién generado.

Audio-guided generation.

Alibaba documenta el audio como fuente guía para el timing y el comportamiento de sincronización labial. Sin un recurso de audio subido, el modelo puede generar música de fondo o efectos de sonido a juego. El audio más largo que el video solicitado se trunca; el audio más corto deja el resto del video en silencio.

Prompt extension, negative prompts and watermarking.

La API nativa admite reescritura de prompts, prompts negativos y una opción de marca de agua generada por IA. Estos controles ayudan a los equipos a estandarizar la calidad del prompt y el comportamiento de procedencia, aunque los campos unificados de CometAPI pueden no mapear uno a uno.

What Do Public Benchmarks Say About Wan 2.7?

Los modelos de video no tienen un benchmark universalmente aceptado equivalente al MMLU o SWE-bench de un LLM. Para Wan 2.7, la señal externa publicada más clara es que encabezó la categoría de video a video de Design Arena. La imagen de ranking de la publicación oficial muestra a Wan 2.7 con una calificación Elo de 1335 en ese instante. Esto respalda una afirmación sobre preferencia en transformación y edición de video; no prueba liderazgo universal en texto a video, imagen a video, calidad de audio o latencia.

EvidencePublic resultHow to interpret it
Design Arena video-to-videoRanked first; Elo 1335 in published imageStrong evidence for V2V preference
Official API specifications720P/1080P; 2-15 seconds for T2VProduction flexibility, not quality ranking
Standardized T2V scoreNot publicly disclosedDo not claim universal T2V leadership
Standardized I2V scoreNot publicly disclosedUse an internal A/B test
Latency or success-rate benchmarkNot publicly standardizedMeasure on the selected route

Benchmark Conclusion

  • Usa el resultado de Design Arena como evidencia de competitividad en video a video, no como una afirmación general para todos los modos.
  • No reutilices cifras de benchmark de Wan 2.1 como resultados de Wan 2.7.
  • Para la selección en producción, prueba los mismos prompts, recursos fuente, resolución, duración y condiciones de audio entre modelos.
  • Rastrea tasa de aceptación humana, estabilidad del movimiento, preservación de identidad, latencia, tasa de fallos y costo por clip aceptado.

Why Use Wan 2.7 Through CometAPI?

A Unified Video API

CometAPI expone el modelo mediante un ciclo de vida de video asíncrono común. La página actual del modelo Wan 2.7 publica el ID de modelo del cliente, el precio de la ruta y un patrón funcional de creación-sondeo-descarga. Esto reduce la cantidad de código de integración específico del proveedor cuando un producto necesita probar o enrutar entre varios modelos de video.

POST /v1/videos GET  /v1/videos/{video_id} GET  /v1/videos/{video_id}/content

Cómo usar la API Wan 2.7: guía completa para desarrolladores

El ciclo de vida de creación-sondeo-descarga de CometAPI para generación de video asíncrona. Fuente del endpoint: Documentación de la API de CometAPI.

  • Una clave de API para múltiples modelos de video compatibles.
  • Un patrón consistente para creación de tareas, recuperación de estado y descarga de archivos.
  • Visibilidad centralizada de uso y facturación.
  • Menos código de aplicación ligado a la autenticación y esquema de respuesta de un proveedor.
  • Pruebas A/B más rápidas porque la selección de modelo puede cambiar sin reemplazar todo el ciclo de vida de la tarea.

A Necessary Compatibility Note

Compatibilidad de la ruta: El esquema unificado /v1/videos de CometAPI no necesariamente expone todos los campos de las APIs nativas de T2V, I2V, R2V y edición de video de Alibaba Cloud. Texto a video e imagen a video son los puntos de partida más seguros. Antes de lanzar control de primer/último fotograma, entrada de múltiples referencias, conducción por audio o edición de video, verifica los campos y límites de medios exactos de la ruta en vivo.

What You Need Before You Start

Create a CometAPI Account and API Key

Crea o inicia sesión en una cuenta de CometAPI, luego genera una clave de API. Guárdala en una variable de entorno. No la incluyas en el control de código fuente, código de navegador o aplicaciones móviles.

export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"

Know the Model ID and Endpoints

Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content

Install the Python Package

python -m pip install --upgrade requests

Los ejemplos usan solicitudes HTTP sin procesar porque los datos multipart, el sondeo de estado y las descargas binarias son más fáciles de entender sin una abstracción adicional de SDK.

How to Use Wan 2.7 API with CometAPI

Step 1: Create a Text-to-Video Task

Envía una solicitud multipart con el modelo, el prompt, la duración y el tamaño. Este ejemplo de 5 segundos en 720p es la forma de menor riesgo para validar credenciales, enrutamiento y creación de tareas.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \  -F "seconds=5" \  -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{  "id": "video_task_id",  "status": "queued",  "progress": 0 }

Step 2: Poll the Video Status

Usa el ID devuelto en el endpoint de estado. Sondear cada 10-15 segundos suele ser más apropiado que bucles apretados para una tarea de video intensiva en cómputo.

curl https://api.cometapi.com/v1/videos/{video_id} \  -H "Authorization: Bearer $COMETAPI_KEY"{  "id": "video_task_id",  "status": "in_progress",  "progress": 45 }

Tu aplicación debe tratar completed o success como estados terminales exitosos y failed, error o FAILURE como estados terminales fallidos. Conserva la carga completa de fallo para diagnóstico.

Step 3: Download the Completed MP4

Descarga solo después de que la tarea alcance un estado terminal exitoso. Guardar una respuesta de una tarea incompleta puede crear un archivo vacío o un documento de error con extensión MP4.

curl https://api.cometapi.com/v1/videos/{video_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  --output wan2_7_output.mp4

Step 4: Generate Video from an Image

Para imagen a video, sube la referencia como datos multipart y usa un prompt que describa el movimiento, el comportamiento de la cámara y el cambio temporal previsto. La ruta unificada suele usar input_reference. Confirma sus reglas actuales de tamaño de archivo, formato y recuento de imágenes antes de producción.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \  -F "input_reference=@reference.png" \  -F "seconds=5" \  -F "size=1280x720"

Consejo para el prompt de imagen: No gastes la mayor parte del prompt volviendo a describir contenido estático ya visible en la referencia. Usa el presupuesto del prompt para movimiento, dirección de cámara, timing, cambios y restricciones.

Step 5: Build the Complete Python Workflow

El siguiente programa valida la clave de API, envía una tarea, normaliza respuestas de estado envueltas, aplica un tiempo máximo de espera, maneja fallos terminales y descarga el archivo completado.

import os import time from pathlib import Path​ import requests​ API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900​ if not API_KEY:    raise RuntimeError("Set COMETAPI_KEY before running this script.")​ headers = {"Authorization": f"Bearer {API_KEY}"}​ def parse_task_data(payload):    return payload.get("data") or payload​ # 1. Submit the generation task. submit = requests.post(    f"{BASE_URL}/videos",    headers=headers,    files={        "model": (None, "wan2.7"),        "prompt": (            None,            "A cinematic tracking shot of a futuristic train "            "crossing a snowy mountain valley at sunrise."        ),        "seconds": (None, "5"),        "size": (None, "1280x720"),    },    timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id")​ if not video_id:    raise RuntimeError(f"No video ID in response: {submit_payload}")​ print(f"Created video task: {video_id}")​ # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline:    response = requests.get(        f"{BASE_URL}/videos/{video_id}",        headers=headers,        timeout=30,    )    response.raise_for_status()    payload = response.json()    data = parse_task_data(payload)    status = str(data.get("status", "unknown"))    progress = data.get("progress", "unknown")    print(f"status={status}, progress={progress}")​    if status in {"completed", "success"} or progress in {100, "100", "100%"}:        break    if status in {"failed", "error", "FAILURE"}:        raise RuntimeError(f"Video generation failed: {payload}")​    time.sleep(POLL_INTERVAL) else:    raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s")​ # 3. Download the completed MP4. video = requests.get(    f"{BASE_URL}/videos/{video_id}/content",    headers=headers,    timeout=180, ) video.raise_for_status()​ output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content)​ if output.stat().st_size == 0:    raise RuntimeError("Downloaded file is empty.")​ print(f"Saved {output} ({output.stat().st_size} bytes)")

Step 6: Call Wan 2.7 with JavaScript

Este ejemplo de Node.js usa fetch y FormData integrados. Usa Node.js 18 o posterior; el ejemplo escribe el resultado con node:fs/promises.

import { mkdir, writeFile } from "node:fs/promises";​ const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000;​ if (!apiKey) throw new Error("Set COMETAPI_KEY first.");​ const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));​ const form = new FormData(); form.append("model", "wan2.7"); form.append(  "prompt",  "A cinematic tracking shot of a futuristic train crossing " +    "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720");​ const submitResponse = await fetch(`${baseUrl}/videos`, {  method: "POST",  headers,  body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text());​ const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`);​ const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) {  const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });  if (!statusResponse.ok) throw new Error(await statusResponse.text());​  const payload = await statusResponse.json();  const data = payload.data || payload;  const status = String(data.status || "unknown");  const progress = data.progress ?? "unknown";  console.log({ status, progress });​  if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) {    break;  }  if (["failed", "error", "FAILURE"].includes(status)) {    throw new Error(`Generation failed: ${JSON.stringify(payload)}`);  }  await sleep(pollIntervalMs); }​ if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`);​ const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text());​ await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);

What Are the Wan 2.7 API Parameters?

ParameterTypeRequiredExamplePurpose
modelstringYeswan2.7Selecciona la ruta
promptstringYesScene descriptionDefine contenido, movimiento y estilo
secondsintegerNo5Controla duración y costo
sizestringNo1280x720Controla resolución / relación de aspecto
input_referencefileI2Vreference.pngProporciona una imagen fuente
AuthorizationheaderYesBearer tokenAutentica la solicitud

CometAPI and Alibaba Native Parameter Mapping

ConceptCometAPIAlibaba native API
Modelwan2.7wan2.7-t2v or wan2.7-i2v-*
Durationsecondsduration
Resolutionsizeresolution plus ratio
Reference imageinput_referencemedia[].type=first_frame
Task identifierid or task_idoutput.task_id
Task statusGET /v1/videos/{id}Provider task-query endpoint
Binary resultGET /v1/videos/{id}/contentTemporary result URL / provider response

Este mapeo explica por qué los ejemplos copiados de Alibaba Cloud no pueden pegarse sin cambios en CometAPI. La capacidad del modelo está relacionada, pero la capa de acceso y el esquema son diferentes.

How to Write Better Wan 2.7 Prompts: Examples

Un prompt práctico de video define qué debe permanecer estable y qué debe cambiar con el tiempo. Usa esta estructura:

Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints

Single-Shot Prompt

A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.

Multi-Shot Prompt

Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.

Image-to-Video Prompt

Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.

Negative Prompt Guidance

Usa prompts negativos para suprimir fallos recurrentes en lugar de describir la escena deseada por segunda vez. Una lista concisa como low resolution, deformed hands, duplicated limbs, flicker, unstable face, unreadable text y watermark suele ser más útil que un párrafo largo y contradictorio.

How Much Does the Wan 2.7 API Cost?

La ruta actual de CometAPI lista Wan 2.7 a $0.08 por segundo para 720p y $0.12 por segundo para 1080p. El costo estimado es, por lo tanto, una función directa de la duración generada y la resolución seleccionada.

ResolutionPrice / second5 seconds10 seconds15 seconds
720p$0.08$0.40$0.80$1.20
1080p$0.12$0.60$1.20$1.80
Estimated video cost = price per second x generated duration in seconds

Fuente de datos: Precios del modelo en vivo de CometAPI.

Interpretación de precios: No afirmes que una ruta de agregador es más barata que Alibaba Cloud sin comparar la misma región, variante de modelo, resolución, duración, modo de audio y unidad de facturación. El precio claro por segundo y la facturación unificada de CometAPI son ventajas de integración; una ventaja de precio del proveedor requiere una comparación en igualdad de condiciones.

Un clip 1080p que no pasa la revisión creativa es más caro que su precio de generación listado porque el equipo debe regenerarlo. Para la planificación de producción, divide el gasto total por el número de clips aceptados sin retrabajo.

Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1

Las alternativas más útiles en la misma plataforma son Seedance 2.5, Vidu Q3 y Veo 3.1. La tabla a continuación compara el ajuste del flujo de trabajo en lugar de declarar un ganador universal. Las funciones de la ruta pueden cambiar, por lo que verifica entradas avanzadas antes de producción.

DimensionWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Main positioningControllable multimodal suiteLonger narrative and reference-heavy generationFast story-driven creationCinematic video with native audio
Text-to-videoYesYesYesYes
Image-to-videoYesYesYesYes
First/last-frame controlNative family supportRoute dependentSupportedSupported in selected workflows
Video continuationNative family supportEditing-orientedRoute dependentExtension workflows
AudioInput guidance + automatic BGM/SFXJoint audio-videoNative synchronized audioNative synchronized audio
Common route duration2-15 s native T2V4-30 s listed route1-16 s listed route4/6/8 s official modes
Common maximum resolution1080pRoute dependent1080p1080p; other variants may differ
Best fitControlled production workflowsLonger multi-shot storytellingRapid narrative iterationHigh-end cinematic shots

Comparison Results

  • Elige Wan 2.7 cuando el control de primer/último fotograma, la continuación, la guía de audio y un flujo de trabajo controlable amplio importan más que la duración máxima de un solo clip.
  • Elige Seedance 2.5 cuando la narración más larga de múltiples planos y el trabajo creativo con muchas referencias son la prioridad.
  • Elige Vidu Q3 cuando la iteración narrativa rápida, el audio sincronizado y los flujos de trabajo orientados al creador son centrales.
  • Elige Veo 3.1 cuando la calidad cinematográfica, el realismo visual y el audio integrado justifican un mayor costo de ruta.
  • No selecciones un ganador solo por especificaciones. Usa un conjunto fijo de prompts y recursos, luego compara la tasa de salida aceptada y el costo total de producción.

Production Best Practices

Task Lifecycle and Reliability

  • Conserva el ID de la tarea inmediatamente después de crearla.
  • Usa una estrategia de idempotencia en tu propia aplicación para que un reintento del cliente no cree tareas pagadas duplicadas.
  • Sondea con un intervalo de 10-15 segundos y un tiempo máximo de espera en lugar de un bucle ilimitado.
  • Diferencia fallos HTTP transitorios de fallos de generación declarados por el proveedor.
  • Aplica backoff exponencial para errores de red o de límite de tasa, pero no reintentes ciegamente fallos de políticas de contenido.
  • Marca un trabajo como completo solo después de que la salida se haya descargado y validado como no vacía.
  • No dependas permanentemente de una URL temporal del proveedor; copia las salidas aceptadas a tu propio almacenamiento controlado donde esté permitido.

Quality and Cost Control

  • Prototipa prompts en 720p y duración corta antes de generar masters en 1080p.
  • Mantén juntos el prompt, prompt negativo, ID de modelo, ruta, resolución, duración, ID de tarea y hash de salida para reproducibilidad.
  • Crea una rúbrica de revisión para adherencia al prompt, movimiento, consistencia temporal, identidad, manos, artefactos de texto, audio y seguridad.
  • Mide el costo por salida aceptada, no solo el costo por solicitud.
  • Mantén un pequeño conjunto de prompts de regresión y vuelve a ejecutarlo antes de cambiar versiones de ruta o proveedores de modelos.

Security and Governance

  • Mantén las claves de API en el servidor y rótalas cuando sospeches exposición.
  • Valida las cargas de imagen y video antes de reenviarlas a la ruta de generación.
  • Aplica controles de consentimiento, semejanza y propiedad intelectual para medios de referencia.
  • Agrega revisión humana para publicidad, noticias, política, temas médicos u otros usos de alto impacto.
  • Conserva metadatos de procedencia y aplica políticas de marca de agua o divulgación requeridas por tu jurisdicción y plataforma.

Common Errors and Troubleshooting

Error or symptomLikely causeRecommended fix
401 UnauthorizedMissing, invalid or revoked keyCheck the Bearer token and environment variable
400 Bad RequestUnsupported field, size or durationStart from the model-page example and add fields one at a time
No task IDUnexpected response wrapperLog the complete response and check data, id, and task_id
Queued for a long timeProvider load or capacityContinue bounded polling; do not duplicate the task
Generation failedMedia, prompt, policy or provider errorInspect the terminal payload before deciding whether to retry
Empty MP4Downloaded before completion or error body savedCheck status and Content-Type before writing the file
Reference rejectedFormat, dimensions, size or media countConvert to PNG/JPEG and follow live route limits
Unexpected costLong duration, high resolution or retriesPrototype at 720p and track accepted-output rate
Inconsistent resultStochastic generation or vague motion promptSpecify timing and constraints; compare several candidates

Final Recommendation

El valor práctico de Wan 2.7 es la amplitud de su flujo de trabajo de video controlable: texto a video, animación de imagen, fotogramas anclados, continuación, generación guiada por referencias y comportamiento consciente del audio. A través de CometAPI, el camino más rápido es validar una solicitud de 5 segundos en 720p con el endpoint asíncrono unificado, luego agregar entradas de imagen y salida 1080p después de que la creación de tareas, el sondeo y la descarga sean confiables.

Para producción, mantén las funciones nativas avanzadas detrás de comprobaciones explícitas de capacidad porque el esquema unificado de CometAPI puede no exponer todos los campos de Alibaba. Compara Wan 2.7 con alternativas usando los mismos prompts y recursos, y selecciona la ruta que produzca el menor costo por video aprobado en lugar del precio de lista más bajo.

FAQs

What is the Wan 2.7 API?

Es una familia de generación de video multimodal accesible por API que cubre texto a video, imagen a video, flujos de trabajo guiados por referencia y edición de video. CometAPI expone la ruta para clientes mediante el ID de modelo wan2.7.

What is the Wan 2.7 model ID on CometAPI?

Usa wan2.7. No lo reemplaces con identificadores nativos de Alibaba como wan2.7-t2v a menos que estés llamando directamente a Alibaba Cloud.

Which endpoint creates a Wan 2.7 video?

Envía una solicitud multipart POST a https://api.cometapi.com/v1/videos. Luego consulta /v1/videos/{video_id} y descarga desde /v1/videos/{video_id}/content.

Does Wan 2.7 support text-to-video and image-to-video?

Sí. Ambas son capacidades listadas. Imagen a video agrega una imagen de referencia y debe usar los requisitos multipart actuales de la ruta.

What resolutions does Wan 2.7 support?

La ruta de video publicada de Wan 2.7 admite 720p y 1080p. La documentación nativa de texto a video también lista dimensiones de salida específicas por relación de aspecto para ambos niveles.

How long can a Wan 2.7 video be?

La API nativa de texto a video de Wan 2.7 de Alibaba permite duraciones enteras de 2 a 15 segundos con un valor predeterminado de 5 segundos. Usa los valores documentados para la ruta específica de CometAPI que llames.

Does Wan 2.7 generate audio?

Alibaba documenta generación guiada por audio y música de fondo o efectos de sonido automáticos cuando se omite el audio. Los campos de audio exactos expuestos a través de una ruta unificada deben verificarse antes de producción.

Can Wan 2.7 use first and last frames?

La familia nativa de imagen a video admite flujos de trabajo de primer fotograma y primer más último fotograma. Confirma los campos correspondientes de la ruta unificada antes de depender de ellos en CometAPI.

Is the Wan 2.7 API synchronous or asynchronous?

Es asíncrona. La creación de tareas devuelve un ID; tu aplicación debe sondear el estado y descargar el resultado tras la finalización.

How much does Wan 2.7 cost on CometAPI?

La ruta publicada lista $0.08 por segundo para 720p y $0.12 por segundo para 1080p. Un clip de 5 segundos se estima en $0.40 o $0.60 respectivamente.

Should I use Wan 2.7, Seedance 2.5, Vidu Q3 or Veo 3.1?

Usa Wan 2.7 para control amplio, Seedance 2.5 para narrativas más largas con muchas referencias, Vidu Q3 para iteración narrativa rápida y Veo 3.1 para salida cinematográfica premium. Valida la elección con una prueba A/B controlada.

Can Wan 2.7 continue an existing video?

Sí en la familia nativa del modelo mediante un flujo de trabajo first_clip. Debe verificarse la disponibilidad y el mapeo de parámetros en la ruta unificada de CometAPI.

Seguir aprendiendo

Conecta este artículo con la siguiente decisión.

Ver todos los temas
Publicado el Aug 31, 2026
Última actualización Sep 3, 2026
19 visitas
Revisado para mayor claridad, atribución de fuentes y terminología API actual.

Leer Más