Saltar al contenido
AlibabaComprobando

Wan 2.7 / Video Extend

wan-2-7-video-extend

edición de vídeoSalida: VídeoEntrada: texto + vídeo + audio
Cargando precio…
Precio de lista oficial · Sin verificar

Endpoint

Todos los modelos comparten una API de tareas asíncrona. Este modelo se selecciona por su slug.

Enviar
POST https://api.hermes-ai.net/api/v1/jobs

{
  "model": "wan-2-7-video-extend",
  "input": {
    "videoUrl": "https://example.com/input.mp4",
    "resolution": "1080P",
    "duration": "5"
  }
}

Después consulta GET /api/v1/jobs/{id} hasta que el estado sea final.

Autenticación

Envía una clave de API con el permiso jobs:create para enviar y jobs:read para consultar.

EncabezadoValorNotas
AuthorizationBearer <API key>O envía la clave en x-api-key.
Content-Typeapplication/json
Idempotency-Key<unique string ≤128>Obligatorio. Reutilízalo solo para reintentar la misma solicitud.

Cuerpo de la solicitud

CampoTipoObligatorioNotas
modelstringobligatorioSlug del modelo en el catálogo.
inputobjectobligatorioCampos del esquema de entrada del modelo.
expectedPriceMicrosintegeropcionalPrecio que mostraste al usuario. Si no coincide, se devuelve 409 PRICE_CHANGED antes de cualquier cargo.

campos de input

Los campos desconocidos se rechazan con INVALID_MODEL_INPUT.

CampoTipoObligatorioPredeterminadoValores permitidos y restricciones
prompt
stringopcional—

1–5000 chars

videoUrl
stringobligatorio—

Based on the video segments, let the model generate subsequent content

HTTPS video URL or media:<uuid>

audioUrl
stringopcional—

audioUrl MP3 or WAV; maximum 15 MB.

HTTPS audio URL or media:<uuid>

negativePrompt
stringopcional—

0–500 chars

resolution
stringobligatorio"1080P"

Uno de: "720P", "1080P"

duration
stringobligatorio"5"

Uno de: "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15"

promptExtend
booleanopcionaltrue

Whether to enable prompt intelligent rewriting. After activation, use the large model to intelligently rewrite the input prompt. For shorter prompt generation, the effect is significantly improved, but it will increase the time consumption.

seed
integeropcional—

Randomly select seeds with a value range of [0, 2147483647]. If not specified, the system will automatically generate random seeds. If you need to improve the reproducibility of the generated results, it is recommended to fix the seed value. Please note that due to the probabilistic nature of model generation, even with the same seed, it cannot be guaranteed that the results generated each time will be completely consistent

0–2147483647

Respuesta

202 para una tarea nueva, 200 cuando coincide una repetición con Idempotency-Key. GET /api/v1/jobs/{id} devuelve la misma estructura sin replayed.

CampoTipoNotas
idstringID de tarea de Hermes AI. Úsalo para consultar.
modelstringSlug del modelo.
statusstringConsulta los estados de la tarea.
errorCodestring | nullSe establece cuando una tarea falla o requiere revisión.
priceMicrosintegerCotización fijada al aceptarla, en micro-unidades de USD.
currency"USD"
createdAt / updatedAtstringMarcas de tiempo ISO 8601.
assets[]array{ id, type, url?, text? }. url es un enlace /api/v1/results/<uuid> del mismo origen.
replayedbooleanSolo al enviar. true cuando coincide un reintento idempotente.

Estados de la tarea

EstadoFinalSignificado
queuednoAceptada y a la espera de un trabajador.
submittingnoEnviándose al proveedor del modelo.
runningnoEl modelo está generando.
succeededsíTerminada. Los resultados están en assets.
failedsíTerminada sin resultado. La reserva se libera.
reconciliation_requiredsíThe result is being verified. Keep the task ID and do not resubmit automatically.

Errores

Todos los cuerpos de error son { code, error }. Gestiónalos por code.

HTTPCódigoSignificado y acción
401AUTH_REQUIREDFalta la clave de API o la sesión, o no es válida.
403INSUFFICIENT_SCOPELa clave de API no tiene el permiso que necesita este endpoint.
403PERMISSION_DENIEDEsta credencial no puede realizar la operación.
429API_KEY_RATE_LIMITEDSe alcanzó el límite de frecuencia de la clave de API. Respeta Retry-After.
429API_KEY_USAGE_EXCEEDEDLa clave de API alcanzó su límite de uso. Crea una clave nueva.
400INVALID_REQUESTEl cuerpo no es un objeto JSON o falta un valor obligatorio.
400INVALID_IDEMPOTENCY_KEYIdempotency-Key debe tener entre 1 y 128 caracteres ASCII imprimibles.
400INVALID_MODEL_INPUTinput no coincide con el esquema del modelo (campo desconocido, campo obligatorio ausente o valor no válido).
400 / 413INPUT_TOO_LARGEEl cuerpo de la solicitud supera los 256 KB. Sube primero los archivos multimedia y envía una referencia.
404REQUEST_NOT_FOUNDNo chat request with this ID belongs to your account.
404MODEL_NOT_FOUNDNingún modelo tiene este slug.
404JOB_NOT_FOUNDNinguna tarea con este ID pertenece a tu cuenta.
409IDEMPOTENCY_CONFLICTEsta Idempotency-Key se usó con otra entrada. Usa una clave nueva para una solicitud nueva.
409PRICE_CHANGEDEl precio difiere de expectedPriceMicros. Obtén el precio y vuelve a confirmarlo.
409MODEL_PRICE_UNAVAILABLEEste modelo aún no tiene precio configurado, por lo que no puede ejecutarse.
409PAYMENT_REVIEW_REQUIREDA refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
409INSUFFICIENT_CREDITSLos créditos disponibles no cubren el precio de la tarea.
429RATE_LIMITEDDemasiados envíos de tareas por minuto. Vuelve a intentarlo más tarde.
429CONCURRENCY_LIMITEDDemasiadas tareas sin terminar. Espera a que termine alguna.
503EXECUTION_UNAVAILABLELa ejecución no está configurada para este modelo en este momento.
429UPSTREAM_RATE_LIMITEDThe model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
502UPSTREAM_ERRORThe model provider failed the chat request. Nothing was charged; retry later.
503PLATFORM_BUDGET_EXCEEDEDThis model is temporarily unavailable. Try again later.
503EXECUTION_TEMPORARILY_UNAVAILABLELa ejecución no está disponible temporalmente. Reintenta con la misma Idempotency-Key.
503AUTH_UNAVAILABLELa autenticación no está disponible temporalmente. Vuelve a intentarlo más tarde.
503API_UNAVAILABLELa API no está disponible temporalmente. Vuelve a intentarlo más tarde.

Guía completa de la API · OpenAPI 3.1