HappyHorse-1.1-I2V es un modelo de Alibaba que inicia una escena de video a partir de una imagen ya creada. La imagen se convierte en el primer fotograma y el texto puede definir la acción posterior: el movimiento del personaje, los cambios en la escena y la dirección de la cámara. Resulta adecuado para animar una ilustración, una fotografía de producto o un concepto visual preparado previamente.
La descripción de texto es opcional. Si no se proporciona, el modelo deduce un movimiento posible a partir del contenido de la imagen inicial. Cuando se especifica, la imagen de partida determina la composición y la apariencia de los objetos, mientras que las palabras orientan la evolución de la escena en el tiempo.
Alibaba destaca la conservación de la apariencia del personaje, la coherencia visual, la fluidez del movimiento y la combinación de imagen y sonido. Entre los objetivos declarados también figuran la estabilidad de los textos y las texturas. Estas características forman parte del planteamiento del modelo y no implican conservar literalmente cada píxel en todos los fotogramas generados.
Este modo utiliza una única imagen inicial. Define la escena de partida, no un conjunto de muestras independientes para una nueva composición. No se ha anunciado la posibilidad de fijar un fotograma final independiente para esta versión concreta.
Se admiten JPEG, JPG, PNG y WEBP. Cada lado de la imagen de entrada debe medir al menos 300 píxeles; la relación de aspecto permitida va de 1:2,5 a 2,5:1 y el archivo puede ocupar hasta 20 MB. La relación de aspecto del video final sigue la del primer fotograma.
La duración se elige como un número entero entre 3 y 15 segundos. Hay resoluciones de 480P, 720P y 1080P; el formato de salida es MP4 y la frecuencia, 24 fotogramas por segundo. Se admite la creación de sonido junto con el video.
La descripción puede estar en cualquier idioma y contener hasta 5000 caracteres no chinos o 2500 caracteres chinos. Si se supera el límite, se descarta el exceso, por lo que las acciones importantes y los detalles del movimiento deben describirse dentro de ese espacio. Una misma semilla aleatoria inicial puede producir videos parecidos, pero no garantiza que coincidan fotograma a fotograma.
", "aboutText": "HappyHorse-1.1-I2V es un modelo de Alibaba que inicia una escena de video a partir de una imagen ya creada. La imagen se convierte en el primer fotograma y el texto puede definir la acción posterior: el movimiento del personaje, los cambios en la escena y la dirección de la cámara. Resulta adecuado para animar una ilustración, una fotografía de producto o un concepto visual preparado previamente.\n\nLa descripción de texto es opcional. Si no se proporciona, el modelo deduce un movimiento posible a partir del contenido de la imagen inicial. Cuando se especifica, la imagen de partida determina la composición y la apariencia de los objetos, mientras que las palabras orientan la evolución de la escena en el tiempo.\n\n### Del primer fotograma al movimiento\n\nAlibaba destaca la conservación de la apariencia del personaje, la coherencia visual, la fluidez del movimiento y la combinación de imagen y sonido. Entre los objetivos declarados también figuran la estabilidad de los textos y las texturas. Estas características forman parte del planteamiento del modelo y no implican conservar literalmente cada píxel en todos los fotogramas generados.\n\nEste modo utiliza una única imagen inicial. Define la escena de partida, no un conjunto de muestras independientes para una nueva composición. No se ha anunciado la posibilidad de fijar un fotograma final independiente para esta versión concreta.\n\nSe admiten JPEG, JPG, PNG y WEBP. Cada lado de la imagen de entrada debe medir al menos 300 píxeles; la relación de aspecto permitida va de 1:2,5 a 2,5:1 y el archivo puede ocupar hasta 20 MB. La relación de aspecto del video final sigue la del primer fotograma.\n\n### Parámetros del video\n\nLa duración se elige como un número entero entre 3 y 15 segundos. Hay resoluciones de 480P, 720P y 1080P; el formato de salida es MP4 y la frecuencia, 24 fotogramas por segundo. Se admite la creación de sonido junto con el video.\n\nLa descripción puede estar en cualquier idioma y contener hasta 5000 caracteres no chinos o 2500 caracteres chinos. Si se supera el límite, se descarta el exceso, por lo que las acciones importantes y los detalles del movimiento deben describirse dentro de ese espacio. Una misma semilla aleatoria inicial puede producir videos parecidos, pero no garantiza que coincidan fotograma a fotograma.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d6a239574ed08ccc0a58bd07e41bbd35a3c2f154980c70c17f3ac621c425d645", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "happyhorse-1.1-i2vModelo para animar imágenes: la imagen de partida define el primer fotograma y la descripción guía el movimiento posterior. Genera un video corto con la opción de añadir sonido.
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
HappyHorse-1.1-I2V es un modelo de Alibaba que inicia una escena de video a partir de una imagen ya creada. La imagen se convierte en el primer fotograma y el texto puede definir la acción posterior: el movimiento del personaje, los cambios en la escena y la dirección de la cámara. Resulta adecuado para animar una ilustración, una fotografía de producto o un concepto visual preparado previamente.
La descripción de texto es opcional. Si no se proporciona, el modelo deduce un movimiento posible a partir del contenido de la imagen inicial. Cuando se especifica, la imagen de partida determina la composición y la apariencia de los objetos, mientras que las palabras orientan la evolución de la escena en el tiempo.
Alibaba destaca la conservación de la apariencia del personaje, la coherencia visual, la fluidez del movimiento y la combinación de imagen y sonido. Entre los objetivos declarados también figuran la estabilidad de los textos y las texturas. Estas características forman parte del planteamiento del modelo y no implican conservar literalmente cada píxel en todos los fotogramas generados.
Este modo utiliza una única imagen inicial. Define la escena de partida, no un conjunto de muestras independientes para una nueva composición. No se ha anunciado la posibilidad de fijar un fotograma final independiente para esta versión concreta.
Se admiten JPEG, JPG, PNG y WEBP. Cada lado de la imagen de entrada debe medir al menos 300 píxeles; la relación de aspecto permitida va de 1:2,5 a 2,5:1 y el archivo puede ocupar hasta 20 MB. La relación de aspecto del video final sigue la del primer fotograma.
La duración se elige como un número entero entre 3 y 15 segundos. Hay resoluciones de 480P, 720P y 1080P; el formato de salida es MP4 y la frecuencia, 24 fotogramas por segundo. Se admite la creación de sonido junto con el video.
La descripción puede estar en cualquier idioma y contener hasta 5000 caracteres no chinos o 2500 caracteres chinos. Si se supera el límite, se descarta el exceso, por lo que las acciones importantes y los detalles del movimiento deben describirse dentro de ese espacio. Una misma semilla aleatoria inicial puede producir videos parecidos, pero no garantiza que coincidan fotograma a fotograma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites happyhorse-1.1-i2v | Predeterminado— |
Campoprompt | Tipostring | RequisitoOpcional | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 3 Máximo: 15 Unidad: segundos | Predeterminado5 |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 480P, 720P, 1080P | Predeterminado720P |
Camporatio | Tipostring | RequisitoNo compatible | Valores y límites | Predeterminado— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Máximo de bytes decodificados: 20,971,520 Tipos MIME: image/jpeg, image/png, image/webp | Predeterminado— |
first_frame_to_video · Obligatorio: image_urls
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, image_urls |
Parámetromaterial_types | Contratotext, image |
Parámetrooptional | Contratoduration, resolution, ratio, prompt |
Parámetroduration_integer_range | Contrato3, 15 |
Parámetrodefault_duration | Contrato5 |
Parámetroresolution | Contrato480P, 720P, 1080P |
Parámetrodefault_resolution | Contrato720P |
Parámetroratio | Contrato |
Parámetroratio_must_omit | Contratotrue |
Parámetroimage_urls | Contrato{"min_count":1,"max_count":1,"schemes":["https","datos de imagen ráster en base64"],"max_data_image_bytes":20971520} |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.
POST /v1/videos/generationsAiloot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nGuarda todos los videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva cada elemento de data e índice de salida devuelto. content_url corresponde únicamente al primero; recupera cada ruta de contenido y recurso real. GET de content sin index no devuelve todas las salidas.
Consulta el trabajo original existente; nunca repitas un envío de resultado desconocido.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuesta409 · video_not_ready | CondiciónEl contenido del resultado original todavía no está disponible | Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa las rutas de método indicadas arriba.
happyhorse-i2vModelo para animar imágenes: la imagen de partida define el primer fotograma y la descripción guía el movimiento posterior. Genera un video corto con la opción de añadir sonido.
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
HappyHorse-1.1-I2V es un modelo de Alibaba que inicia una escena de video a partir de una imagen ya creada. La imagen se convierte en el primer fotograma y el texto puede definir la acción posterior: el movimiento del personaje, los cambios en la escena y la dirección de la cámara. Resulta adecuado para animar una ilustración, una fotografía de producto o un concepto visual preparado previamente.
La descripción de texto es opcional. Si no se proporciona, el modelo deduce un movimiento posible a partir del contenido de la imagen inicial. Cuando se especifica, la imagen de partida determina la composición y la apariencia de los objetos, mientras que las palabras orientan la evolución de la escena en el tiempo.
Alibaba destaca la conservación de la apariencia del personaje, la coherencia visual, la fluidez del movimiento y la combinación de imagen y sonido. Entre los objetivos declarados también figuran la estabilidad de los textos y las texturas. Estas características forman parte del planteamiento del modelo y no implican conservar literalmente cada píxel en todos los fotogramas generados.
Este modo utiliza una única imagen inicial. Define la escena de partida, no un conjunto de muestras independientes para una nueva composición. No se ha anunciado la posibilidad de fijar un fotograma final independiente para esta versión concreta.
Se admiten JPEG, JPG, PNG y WEBP. Cada lado de la imagen de entrada debe medir al menos 300 píxeles; la relación de aspecto permitida va de 1:2,5 a 2,5:1 y el archivo puede ocupar hasta 20 MB. La relación de aspecto del video final sigue la del primer fotograma.
La duración se elige como un número entero entre 3 y 15 segundos. Hay resoluciones de 480P, 720P y 1080P; el formato de salida es MP4 y la frecuencia, 24 fotogramas por segundo. Se admite la creación de sonido junto con el video.
La descripción puede estar en cualquier idioma y contener hasta 5000 caracteres no chinos o 2500 caracteres chinos. Si se supera el límite, se descarta el exceso, por lo que las acciones importantes y los detalles del movimiento deben describirse dentro de ese espacio. Una misma semilla aleatoria inicial puede producir videos parecidos, pero no garantiza que coincidan fotograma a fotograma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites happyhorse-i2v | Predeterminado— |
Campoprompt | Tipostring | RequisitoOpcional | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 3 Máximo: 15 Unidad: segundos | Predeterminado5 |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 480P, 720P, 1080P | Predeterminado720P |
Camporatio | Tipostring | RequisitoNo compatible | Valores y límites | Predeterminado— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Máximo de bytes decodificados: 20,971,520 Tipos MIME: image/jpeg, image/png, image/webp | Predeterminado— |
first_frame_to_video · Obligatorio: image_urls
| Parámetro | Contrato |
|---|---|
Parámetromaterial_types | Contratotext, image |
Parámetrorequired | Contratonull |
Parámetrooptional_controls | Contratonull |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.
POST /v1/videos/generationsAiloot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nGuarda todos los videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva cada elemento de data e índice de salida devuelto. content_url corresponde únicamente al primero; recupera cada ruta de contenido y recurso real. GET de content sin index no devuelve todas las salidas.
Consulta el trabajo original existente; nunca repitas un envío de resultado desconocido.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuesta409 · video_not_ready | CondiciónEl contenido del resultado original todavía no está disponible | Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa las rutas de método indicadas arriba.
happyhorse-i2v-latestModelo para animar imágenes: la imagen de partida define el primer fotograma y la descripción guía el movimiento posterior. Genera un video corto con la opción de añadir sonido.
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
HappyHorse-1.1-I2V es un modelo de Alibaba que inicia una escena de video a partir de una imagen ya creada. La imagen se convierte en el primer fotograma y el texto puede definir la acción posterior: el movimiento del personaje, los cambios en la escena y la dirección de la cámara. Resulta adecuado para animar una ilustración, una fotografía de producto o un concepto visual preparado previamente.
La descripción de texto es opcional. Si no se proporciona, el modelo deduce un movimiento posible a partir del contenido de la imagen inicial. Cuando se especifica, la imagen de partida determina la composición y la apariencia de los objetos, mientras que las palabras orientan la evolución de la escena en el tiempo.
Alibaba destaca la conservación de la apariencia del personaje, la coherencia visual, la fluidez del movimiento y la combinación de imagen y sonido. Entre los objetivos declarados también figuran la estabilidad de los textos y las texturas. Estas características forman parte del planteamiento del modelo y no implican conservar literalmente cada píxel en todos los fotogramas generados.
Este modo utiliza una única imagen inicial. Define la escena de partida, no un conjunto de muestras independientes para una nueva composición. No se ha anunciado la posibilidad de fijar un fotograma final independiente para esta versión concreta.
Se admiten JPEG, JPG, PNG y WEBP. Cada lado de la imagen de entrada debe medir al menos 300 píxeles; la relación de aspecto permitida va de 1:2,5 a 2,5:1 y el archivo puede ocupar hasta 20 MB. La relación de aspecto del video final sigue la del primer fotograma.
La duración se elige como un número entero entre 3 y 15 segundos. Hay resoluciones de 480P, 720P y 1080P; el formato de salida es MP4 y la frecuencia, 24 fotogramas por segundo. Se admite la creación de sonido junto con el video.
La descripción puede estar en cualquier idioma y contener hasta 5000 caracteres no chinos o 2500 caracteres chinos. Si se supera el límite, se descarta el exceso, por lo que las acciones importantes y los detalles del movimiento deben describirse dentro de ese espacio. Una misma semilla aleatoria inicial puede producir videos parecidos, pero no garantiza que coincidan fotograma a fotograma.
POST /v1/videos/generationstext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites happyhorse-i2v-latest | Predeterminado— |
Campoprompt | Tipostring | RequisitoOpcional | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 3 Máximo: 15 Unidad: segundos | Predeterminado5 |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 480P, 720P, 1080P | Predeterminado720P |
Camporatio | Tipostring | RequisitoNo compatible | Valores y límites | Predeterminado— |
Campoimage_urls | Tipohttps_url|data_image_url[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Máximo de bytes decodificados: 20,971,520 Tipos MIME: image/jpeg, image/png, image/webp | Predeterminado— |
first_frame_to_video · Obligatorio: image_urls
| Parámetro | Contrato |
|---|---|
Parámetromaterial_types | Contratotext, image |
Parámetrorequired | Contratonull |
Parámetrooptional_controls | Contratonull |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.
POST /v1/videos/generationsAiloot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nGuarda todos los videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva cada elemento de data e índice de salida devuelto. content_url corresponde únicamente al primero; recupera cada ruta de contenido y recurso real. GET de content sin index no devuelve todas las salidas.
Consulta el trabajo original existente; nunca repitas un envío de resultado desconocido.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campoobject | Tipostring |
Campomodel | Tipostring |
Campostatus | Tipostring |
Campocontent_url | Tiposigned URL |
Campodata[] | Tiposigned URL |
Campousage | Tipoobject |
Camporesult_pending_check | Tipoboolean |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuesta409 · video_not_ready | CondiciónEl contenido del resultado original todavía no está disponible | Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Usa las rutas de método indicadas arriba.