Sora 2 es el modelo de generación de video y audio de OpenAI para crear clips dinámicos a partir de la descripción escrita de una escena o de una imagen de referencia. Genera la secuencia visual junto con voz, efectos y sonido de fondo sincronizados. El perfil estándar de Sora 2 se orienta a la exploración visual, el desarrollo de conceptos, los prototipos y los primeros montajes. Sora 2 Pro es una edición separada dirigida a una mayor fidelidad visual y a acabados de mayor resolución.
La guía de prompts del fabricante organiza un brief útil en torno al encuadre, el sujeto, la acción, el entorno y la luz. Dale a la escena un estilo visual coherente y después describe el movimiento en momentos claros. Un concepto de producto original podría mostrar un pequeño objeto mecánico que gira una vez sobre una mesa de trabajo mientras la cámara se acerca lentamente, con luz suave de ventana y un sonido sutil de motor. Indica qué debe notar el espectador y cómo termina la acción.
Mantén comprensibles el movimiento de cámara y la acción del sujeto en cada toma. Una secuencia complicada se puede dividir en bloques de toma distintos, cada uno con su propio encuadre, acción e iluminación. Conserva los mismos detalles del sujeto y la misma paleta cuando varios clips deban formar una sola secuencia. La guía destaca que las tomas más cortas suelen seguir las indicaciones con mayor fiabilidad y que generar repetidamente con el mismo prompt produce tomas diferentes.
El lanzamiento del modelo describe mejoras en el comportamiento físico y la continuidad entre tomas, incluidos estilos realistas, cinematográficos y de anime. Son capacidades previstas que debes dirigir y revisar. Examina el movimiento, el contacto entre objetos, las proporciones y la continuidad, en lugar de suponer que un primer fotograma creíble garantiza una secuencia coherente. Si una acción no queda clara, simplifícala y dale un inicio y un final visibles.
Especifica las líneas de diálogo por separado de la descripción visual y etiqueta a los hablantes de forma consistente. Mantén el diálogo lo bastante corto para ajustarse a la acción y a la duración prevista del clip. Para una animación con dos personajes, alterna una pregunta y una respuesta breves en lugar de pedir que una toma corta incluya un discurso largo. La guía advierte que un diálogo complejo y extenso puede alterar el ritmo y la sincronización.
Describe el paisaje sonoro que corresponde a la escena: el sonido de un pequeño movimiento, el ambiente de la habitación o el ritmo de un efecto del entorno. Explica qué sonido debe coincidir con la acción. Escucha la voz y los efectos resultantes junto con la imagen y revisa la asignación de hablantes, las palabras y los tiempos. El audio sincronizado forma parte del clip generado, en lugar de ser una respuesta de texto separada.
Los tamaños de salida documentados del modelo estándar son 720×1280 en vertical y 1280×720 en horizontal. Los tamaños de mayor resolución del perfil Pro no se deben atribuir a Sora 2 estándar. El tamaño y la duración son ajustes explícitos de la solicitud; escribir otro tamaño o pedir una película más larga en el prompt no modifica esos ajustes. La referencia de creación enumera duraciones de clip de 4, 8 y 12 segundos, así que elige una acción breve y definida al preparar una toma. El flujo ampliado del productor también documenta duraciones de clip de 16 y 20 segundos.
Una imagen de referencia fija el primer fotograma y el texto describe lo que sucede después. El productor admite referencias JPEG, PNG y WebP y exige que la imagen coincida con el tamaño del video de destino. Prepara el sujeto, el entorno y la composición en esa imagen inicial; después pide un movimiento específico. Se trata de una referencia para el fotograma inicial, no de una garantía de que cada detalle se mantendrá durante todo el clip.
El flujo ampliado del productor permite crear un recurso de personaje reutilizable a partir de un video de referencia corto de un animal, una mascota de marca o un objeto. Sus indicaciones de preparación piden un clip MP4 de aproximadamente dos a cuatro segundos, de 720p a 1080p, en 16:9 o 9:16. Hacer coincidir la relación de aspecto de origen y salida ayuda a evitar una apariencia estirada. La generación puede referenciar hasta dos personajes.
Conserva el identificador del personaje y menciona su nombre en el prompt; pasar únicamente el identificador no cumple toda la preparación indicada en la guía. Los recursos de personaje pueden acompañar una generación guiada por imagen, pero las extensiones de video no los aceptan. El productor bloquea por defecto las cargas de personajes con apariencia humana y rechaza imágenes de referencia que contengan rostros humanos en el flujo de API documentado. Las funciones de personajes personales de la app de Sora corresponden a otro flujo de producto.
Una extensión toma un video de origen terminado y un prompt de continuación, y usa el clip de origen completo como contexto para el movimiento, la dirección de cámara y la continuidad de la escena. La guía describe adiciones de hasta 20 segundos por extensión. La entrada documentada de la extensión es el video de origen y el texto; ese modo excluye referencias adicionales de personajes o imágenes. Describe cómo continúa la acción existente en vez de introducir una escena sin relación y sin transición.
La edición de video se centra en un cambio claro de un clip existente. Una revisión específica puede modificar el color de un objeto o la paleta de la escena y conservar el resto de la toma. La guía del productor recomienda un cambio bien definido a la vez y distingue entre editar un video generado y subir metraje arbitrario, lo cual tiene una condición de elegibilidad separada. Conserva el original terminado e identifica la revisión exacta que necesitas antes de hacer otra edición.
El flujo de video documentado del productor es asíncrono: un trabajo enviado puede quedar en cola o en curso antes de completarse o fallar. Un trabajo completado entrega un video MP4; las miniaturas y las hojas de sprites permiten generar vistas previas y explorar los resultados. Mantén la identidad del trabajo asociada con el prompt, las referencias y los recursos devueltos. Una respuesta inicial del trabajo no es el video reproducible terminado.
El flujo habitual de descarga describe una vigencia de una hora para la URL de descarga. El flujo ampliado por lotes prepara solicitudes de renderizado JSON independientes, con identificadores de elemento estables, referencias cargadas y un resultado vinculado a cada toma; sus recursos terminados tienen un periodo de descarga separado de hasta 24 horas. Conserva el clip terminado cuanto antes e inspecciona la imagen y el sonido reales antes de considerarlo una toma seleccionada.
Las restricciones de contenido documentadas para la API del productor exigen material apto para públicos menores de 18 años y rechazan personajes o música con derechos de autor y la generación de personas reales. Prepara la escena y las referencias de acuerdo con ello. El resultado directo del modelo es video con audio, no imágenes fijas generadas, una respuesta conversacional de herramienta ni una película ilimitada. Conserva la identidad exacta del modelo estándar y el clip de origen aceptado al continuar un concepto visual.
", "aboutText": "Sora 2 es el modelo de generación de video y audio de OpenAI para crear clips dinámicos a partir de la descripción escrita de una escena o de una imagen de referencia. Genera la secuencia visual junto con voz, efectos y sonido de fondo sincronizados. El perfil estándar de Sora 2 se orienta a la exploración visual, el desarrollo de conceptos, los prototipos y los primeros montajes. Sora 2 Pro es una edición separada dirigida a una mayor fidelidad visual y a acabados de mayor resolución.\n\n### Describe una toma que se pueda ver y escuchar\n\nLa guía de prompts del fabricante organiza un brief útil en torno al encuadre, el sujeto, la acción, el entorno y la luz. Dale a la escena un estilo visual coherente y después describe el movimiento en momentos claros. Un concepto de producto original podría mostrar un pequeño objeto mecánico que gira una vez sobre una mesa de trabajo mientras la cámara se acerca lentamente, con luz suave de ventana y un sonido sutil de motor. Indica qué debe notar el espectador y cómo termina la acción.\n\nMantén comprensibles el movimiento de cámara y la acción del sujeto en cada toma. Una secuencia complicada se puede dividir en bloques de toma distintos, cada uno con su propio encuadre, acción e iluminación. Conserva los mismos detalles del sujeto y la misma paleta cuando varios clips deban formar una sola secuencia. La guía destaca que las tomas más cortas suelen seguir las indicaciones con mayor fiabilidad y que generar repetidamente con el mismo prompt produce tomas diferentes.\n\nEl lanzamiento del modelo describe mejoras en el comportamiento físico y la continuidad entre tomas, incluidos estilos realistas, cinematográficos y de anime. Son capacidades previstas que debes dirigir y revisar. Examina el movimiento, el contacto entre objetos, las proporciones y la continuidad, en lugar de suponer que un primer fotograma creíble garantiza una secuencia coherente. Si una acción no queda clara, simplifícala y dale un inicio y un final visibles.\n\n### Dirige el diálogo y el sonido por separado\n\nEspecifica las líneas de diálogo por separado de la descripción visual y etiqueta a los hablantes de forma consistente. Mantén el diálogo lo bastante corto para ajustarse a la acción y a la duración prevista del clip. Para una animación con dos personajes, alterna una pregunta y una respuesta breves en lugar de pedir que una toma corta incluya un discurso largo. La guía advierte que un diálogo complejo y extenso puede alterar el ritmo y la sincronización.\n\nDescribe el paisaje sonoro que corresponde a la escena: el sonido de un pequeño movimiento, el ambiente de la habitación o el ritmo de un efecto del entorno. Explica qué sonido debe coincidir con la acción. Escucha la voz y los efectos resultantes junto con la imagen y revisa la asignación de hablantes, las palabras y los tiempos. El audio sincronizado forma parte del clip generado, en lugar de ser una respuesta de texto separada.\n\n### Tamaño, duración y un inicio guiado por imagen\n\nLos tamaños de salida documentados del modelo estándar son 720×1280 en vertical y 1280×720 en horizontal. Los tamaños de mayor resolución del perfil Pro no se deben atribuir a Sora 2 estándar. El tamaño y la duración son ajustes explícitos de la solicitud; escribir otro tamaño o pedir una película más larga en el prompt no modifica esos ajustes. La referencia de creación enumera duraciones de clip de 4, 8 y 12 segundos, así que elige una acción breve y definida al preparar una toma. El flujo ampliado del productor también documenta duraciones de clip de 16 y 20 segundos.\n\nUna imagen de referencia fija el primer fotograma y el texto describe lo que sucede después. El productor admite referencias JPEG, PNG y WebP y exige que la imagen coincida con el tamaño del video de destino. Prepara el sujeto, el entorno y la composición en esa imagen inicial; después pide un movimiento específico. Se trata de una referencia para el fotograma inicial, no de una garantía de que cada detalle se mantendrá durante todo el clip.\n\n### Personajes no humanos reutilizables\n\nEl flujo ampliado del productor permite crear un recurso de personaje reutilizable a partir de un video de referencia corto de un animal, una mascota de marca o un objeto. Sus indicaciones de preparación piden un clip MP4 de aproximadamente dos a cuatro segundos, de 720p a 1080p, en 16:9 o 9:16. Hacer coincidir la relación de aspecto de origen y salida ayuda a evitar una apariencia estirada. La generación puede referenciar hasta dos personajes.\n\nConserva el identificador del personaje y menciona su nombre en el prompt; pasar únicamente el identificador no cumple toda la preparación indicada en la guía. Los recursos de personaje pueden acompañar una generación guiada por imagen, pero las extensiones de video no los aceptan. El productor bloquea por defecto las cargas de personajes con apariencia humana y rechaza imágenes de referencia que contengan rostros humanos en el flujo de API documentado. Las funciones de personajes personales de la app de Sora corresponden a otro flujo de producto.\n\n### Continúa o edita un clip terminado\n\nUna extensión toma un video de origen terminado y un prompt de continuación, y usa el clip de origen completo como contexto para el movimiento, la dirección de cámara y la continuidad de la escena. La guía describe adiciones de hasta 20 segundos por extensión. La entrada documentada de la extensión es el video de origen y el texto; ese modo excluye referencias adicionales de personajes o imágenes. Describe cómo continúa la acción existente en vez de introducir una escena sin relación y sin transición.\n\nLa edición de video se centra en un cambio claro de un clip existente. Una revisión específica puede modificar el color de un objeto o la paleta de la escena y conservar el resto de la toma. La guía del productor recomienda un cambio bien definido a la vez y distingue entre editar un video generado y subir metraje arbitrario, lo cual tiene una condición de elegibilidad separada. Conserva el original terminado e identifica la revisión exacta que necesitas antes de hacer otra edición.\n\n### Trabajos de renderizado y el video terminado\n\nEl flujo de video documentado del productor es asíncrono: un trabajo enviado puede quedar en cola o en curso antes de completarse o fallar. Un trabajo completado entrega un video MP4; las miniaturas y las hojas de sprites permiten generar vistas previas y explorar los resultados. Mantén la identidad del trabajo asociada con el prompt, las referencias y los recursos devueltos. Una respuesta inicial del trabajo no es el video reproducible terminado.\n\nEl flujo habitual de descarga describe una vigencia de una hora para la URL de descarga. El flujo ampliado por lotes prepara solicitudes de renderizado JSON independientes, con identificadores de elemento estables, referencias cargadas y un resultado vinculado a cada toma; sus recursos terminados tienen un periodo de descarga separado de hasta 24 horas. Conserva el clip terminado cuanto antes e inspecciona la imagen y el sonido reales antes de considerarlo una toma seleccionada.\n\nLas restricciones de contenido documentadas para la API del productor exigen material apto para públicos menores de 18 años y rechazan personajes o música con derechos de autor y la generación de personas reales. Prepara la escena y las referencias de acuerdo con ello. El resultado directo del modelo es video con audio, no imágenes fijas generadas, una respuesta conversacional de herramienta ni una película ilimitada. Conserva la identidad exacta del modelo estándar y el clip de origen aceptado al continuar un concepto visual.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6e19bdd122bf3ecef05542d437efa3ef53a9a44613be172b5d41507ee39435c8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "sora-2Sora 2 crea video con diálogo sincronizado, efectos de sonido y audio de fondo a partir de texto o de una imagen de referencia. El perfil estándar permite explorar propuestas visuales y crear clips de concepto, con flujos separados del productor para personajes no humanos reutilizables, continuación y ediciones de video específicas.
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.
Sora 2 es el modelo de generación de video y audio de OpenAI para crear clips dinámicos a partir de la descripción escrita de una escena o de una imagen de referencia. Genera la secuencia visual junto con voz, efectos y sonido de fondo sincronizados. El perfil estándar de Sora 2 se orienta a la exploración visual, el desarrollo de conceptos, los prototipos y los primeros montajes. Sora 2 Pro es una edición separada dirigida a una mayor fidelidad visual y a acabados de mayor resolución.
La guía de prompts del fabricante organiza un brief útil en torno al encuadre, el sujeto, la acción, el entorno y la luz. Dale a la escena un estilo visual coherente y después describe el movimiento en momentos claros. Un concepto de producto original podría mostrar un pequeño objeto mecánico que gira una vez sobre una mesa de trabajo mientras la cámara se acerca lentamente, con luz suave de ventana y un sonido sutil de motor. Indica qué debe notar el espectador y cómo termina la acción.
Mantén comprensibles el movimiento de cámara y la acción del sujeto en cada toma. Una secuencia complicada se puede dividir en bloques de toma distintos, cada uno con su propio encuadre, acción e iluminación. Conserva los mismos detalles del sujeto y la misma paleta cuando varios clips deban formar una sola secuencia. La guía destaca que las tomas más cortas suelen seguir las indicaciones con mayor fiabilidad y que generar repetidamente con el mismo prompt produce tomas diferentes.
El lanzamiento del modelo describe mejoras en el comportamiento físico y la continuidad entre tomas, incluidos estilos realistas, cinematográficos y de anime. Son capacidades previstas que debes dirigir y revisar. Examina el movimiento, el contacto entre objetos, las proporciones y la continuidad, en lugar de suponer que un primer fotograma creíble garantiza una secuencia coherente. Si una acción no queda clara, simplifícala y dale un inicio y un final visibles.
Especifica las líneas de diálogo por separado de la descripción visual y etiqueta a los hablantes de forma consistente. Mantén el diálogo lo bastante corto para ajustarse a la acción y a la duración prevista del clip. Para una animación con dos personajes, alterna una pregunta y una respuesta breves en lugar de pedir que una toma corta incluya un discurso largo. La guía advierte que un diálogo complejo y extenso puede alterar el ritmo y la sincronización.
Describe el paisaje sonoro que corresponde a la escena: el sonido de un pequeño movimiento, el ambiente de la habitación o el ritmo de un efecto del entorno. Explica qué sonido debe coincidir con la acción. Escucha la voz y los efectos resultantes junto con la imagen y revisa la asignación de hablantes, las palabras y los tiempos. El audio sincronizado forma parte del clip generado, en lugar de ser una respuesta de texto separada.
Los tamaños de salida documentados del modelo estándar son 720×1280 en vertical y 1280×720 en horizontal. Los tamaños de mayor resolución del perfil Pro no se deben atribuir a Sora 2 estándar. El tamaño y la duración son ajustes explícitos de la solicitud; escribir otro tamaño o pedir una película más larga en el prompt no modifica esos ajustes. La referencia de creación enumera duraciones de clip de 4, 8 y 12 segundos, así que elige una acción breve y definida al preparar una toma. El flujo ampliado del productor también documenta duraciones de clip de 16 y 20 segundos.
Una imagen de referencia fija el primer fotograma y el texto describe lo que sucede después. El productor admite referencias JPEG, PNG y WebP y exige que la imagen coincida con el tamaño del video de destino. Prepara el sujeto, el entorno y la composición en esa imagen inicial; después pide un movimiento específico. Se trata de una referencia para el fotograma inicial, no de una garantía de que cada detalle se mantendrá durante todo el clip.
El flujo ampliado del productor permite crear un recurso de personaje reutilizable a partir de un video de referencia corto de un animal, una mascota de marca o un objeto. Sus indicaciones de preparación piden un clip MP4 de aproximadamente dos a cuatro segundos, de 720p a 1080p, en 16:9 o 9:16. Hacer coincidir la relación de aspecto de origen y salida ayuda a evitar una apariencia estirada. La generación puede referenciar hasta dos personajes.
Conserva el identificador del personaje y menciona su nombre en el prompt; pasar únicamente el identificador no cumple toda la preparación indicada en la guía. Los recursos de personaje pueden acompañar una generación guiada por imagen, pero las extensiones de video no los aceptan. El productor bloquea por defecto las cargas de personajes con apariencia humana y rechaza imágenes de referencia que contengan rostros humanos en el flujo de API documentado. Las funciones de personajes personales de la app de Sora corresponden a otro flujo de producto.
Una extensión toma un video de origen terminado y un prompt de continuación, y usa el clip de origen completo como contexto para el movimiento, la dirección de cámara y la continuidad de la escena. La guía describe adiciones de hasta 20 segundos por extensión. La entrada documentada de la extensión es el video de origen y el texto; ese modo excluye referencias adicionales de personajes o imágenes. Describe cómo continúa la acción existente en vez de introducir una escena sin relación y sin transición.
La edición de video se centra en un cambio claro de un clip existente. Una revisión específica puede modificar el color de un objeto o la paleta de la escena y conservar el resto de la toma. La guía del productor recomienda un cambio bien definido a la vez y distingue entre editar un video generado y subir metraje arbitrario, lo cual tiene una condición de elegibilidad separada. Conserva el original terminado e identifica la revisión exacta que necesitas antes de hacer otra edición.
El flujo de video documentado del productor es asíncrono: un trabajo enviado puede quedar en cola o en curso antes de completarse o fallar. Un trabajo completado entrega un video MP4; las miniaturas y las hojas de sprites permiten generar vistas previas y explorar los resultados. Mantén la identidad del trabajo asociada con el prompt, las referencias y los recursos devueltos. Una respuesta inicial del trabajo no es el video reproducible terminado.
El flujo habitual de descarga describe una vigencia de una hora para la URL de descarga. El flujo ampliado por lotes prepara solicitudes de renderizado JSON independientes, con identificadores de elemento estables, referencias cargadas y un resultado vinculado a cada toma; sus recursos terminados tienen un periodo de descarga separado de hasta 24 horas. Conserva el clip terminado cuanto antes e inspecciona la imagen y el sonido reales antes de considerarlo una toma seleccionada.
Las restricciones de contenido documentadas para la API del productor exigen material apto para públicos menores de 18 años y rechazan personajes o música con derechos de autor y la generación de personas reales. Prepara la escena y las referencias de acuerdo con ello. El resultado directo del modelo es video con audio, no imágenes fijas generadas, una respuesta conversacional de herramienta ni una película ilimitada. Conserva la identidad exacta del modelo estándar y el clip de origen aceptado al continuar un concepto visual.
POST /v1/chat/completionstextjson, sse| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites sora-2 | Predeterminado— |
Campomessages | Tipomessage[] | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomessages[].role | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomessages[].content | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
owned_text_messages
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, messages |
Parámetromaterial_types | Contratotext |
Parámetromessages | Contratoarreglo de mensajes con role y content como cadena literal |
Parámetrofile_material | ContratoEl contenido UTF-8 real puede insertarse como cadena literal en content; no se deduce ninguna referencia a un archivo. |
Parámetrooptional_controls | Contratostream |
Ciclo de vida: synchronous_json_or_sse
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
| Configuración | Tabla de tarifas | Cargo |
|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cargo Entrada · Tokens de entrada $0 / 1K tokens Salida · Tokens de salida $0.2 / 1K tokens Entrada · Lectura de caché $0 / 1K tokens Entrada · Escritura en caché $0 / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot 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}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":false}')\n\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/chat/completions \\\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'\nfrom pathlib import Path\nprint(Path("result.json").read_text(encoding="utf-8"))\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model="sora-2", messages=[{"role":"user","content":"hello"}], stream=False)\nimport json\nfrom pathlib import Path\n\ndata = result.to_dict(mode="json")\nPath("result.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\nprint(json.dumps(data, ensure_ascii=False, indent=2))\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":true}')\n\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/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.sse\nJSON o text/event-stream
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva todos los bytes JSON o SSE, los encabezados de respuesta, el uso devuelto y todos los campos del resultado proporcionados. No se afirma que exista una familia de salida específica del modelo.
Conserva la respuesta original y la identidad del intento; no se deduce ninguna consulta de trabajos nuevos ni un reenvío.
| Campo | Tipo | Significado |
|---|---|---|
Campocomplete response JSON | Tipoobject | SignificadoConserva todos los campos devueltos sin suponer una familia de resultados específica del modelo. |
CampoSSE data events | Tipostream | SignificadoConserva cada evento devuelto y marcador final sin seleccionar únicamente los campos de texto. |
Ailoot Ultra sora-2
Usa las rutas de método indicadas arriba.
sora-2Sora 2 crea video con diálogo sincronizado, efectos de sonido y audio de fondo a partir de texto o de una imagen de referencia. El perfil estándar permite explorar propuestas visuales y crear clips de concepto, con flujos separados del productor para personajes no humanos reutilizables, continuación y ediciones de video específicas.
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.
Sora 2 es el modelo de generación de video y audio de OpenAI para crear clips dinámicos a partir de la descripción escrita de una escena o de una imagen de referencia. Genera la secuencia visual junto con voz, efectos y sonido de fondo sincronizados. El perfil estándar de Sora 2 se orienta a la exploración visual, el desarrollo de conceptos, los prototipos y los primeros montajes. Sora 2 Pro es una edición separada dirigida a una mayor fidelidad visual y a acabados de mayor resolución.
La guía de prompts del fabricante organiza un brief útil en torno al encuadre, el sujeto, la acción, el entorno y la luz. Dale a la escena un estilo visual coherente y después describe el movimiento en momentos claros. Un concepto de producto original podría mostrar un pequeño objeto mecánico que gira una vez sobre una mesa de trabajo mientras la cámara se acerca lentamente, con luz suave de ventana y un sonido sutil de motor. Indica qué debe notar el espectador y cómo termina la acción.
Mantén comprensibles el movimiento de cámara y la acción del sujeto en cada toma. Una secuencia complicada se puede dividir en bloques de toma distintos, cada uno con su propio encuadre, acción e iluminación. Conserva los mismos detalles del sujeto y la misma paleta cuando varios clips deban formar una sola secuencia. La guía destaca que las tomas más cortas suelen seguir las indicaciones con mayor fiabilidad y que generar repetidamente con el mismo prompt produce tomas diferentes.
El lanzamiento del modelo describe mejoras en el comportamiento físico y la continuidad entre tomas, incluidos estilos realistas, cinematográficos y de anime. Son capacidades previstas que debes dirigir y revisar. Examina el movimiento, el contacto entre objetos, las proporciones y la continuidad, en lugar de suponer que un primer fotograma creíble garantiza una secuencia coherente. Si una acción no queda clara, simplifícala y dale un inicio y un final visibles.
Especifica las líneas de diálogo por separado de la descripción visual y etiqueta a los hablantes de forma consistente. Mantén el diálogo lo bastante corto para ajustarse a la acción y a la duración prevista del clip. Para una animación con dos personajes, alterna una pregunta y una respuesta breves en lugar de pedir que una toma corta incluya un discurso largo. La guía advierte que un diálogo complejo y extenso puede alterar el ritmo y la sincronización.
Describe el paisaje sonoro que corresponde a la escena: el sonido de un pequeño movimiento, el ambiente de la habitación o el ritmo de un efecto del entorno. Explica qué sonido debe coincidir con la acción. Escucha la voz y los efectos resultantes junto con la imagen y revisa la asignación de hablantes, las palabras y los tiempos. El audio sincronizado forma parte del clip generado, en lugar de ser una respuesta de texto separada.
Los tamaños de salida documentados del modelo estándar son 720×1280 en vertical y 1280×720 en horizontal. Los tamaños de mayor resolución del perfil Pro no se deben atribuir a Sora 2 estándar. El tamaño y la duración son ajustes explícitos de la solicitud; escribir otro tamaño o pedir una película más larga en el prompt no modifica esos ajustes. La referencia de creación enumera duraciones de clip de 4, 8 y 12 segundos, así que elige una acción breve y definida al preparar una toma. El flujo ampliado del productor también documenta duraciones de clip de 16 y 20 segundos.
Una imagen de referencia fija el primer fotograma y el texto describe lo que sucede después. El productor admite referencias JPEG, PNG y WebP y exige que la imagen coincida con el tamaño del video de destino. Prepara el sujeto, el entorno y la composición en esa imagen inicial; después pide un movimiento específico. Se trata de una referencia para el fotograma inicial, no de una garantía de que cada detalle se mantendrá durante todo el clip.
El flujo ampliado del productor permite crear un recurso de personaje reutilizable a partir de un video de referencia corto de un animal, una mascota de marca o un objeto. Sus indicaciones de preparación piden un clip MP4 de aproximadamente dos a cuatro segundos, de 720p a 1080p, en 16:9 o 9:16. Hacer coincidir la relación de aspecto de origen y salida ayuda a evitar una apariencia estirada. La generación puede referenciar hasta dos personajes.
Conserva el identificador del personaje y menciona su nombre en el prompt; pasar únicamente el identificador no cumple toda la preparación indicada en la guía. Los recursos de personaje pueden acompañar una generación guiada por imagen, pero las extensiones de video no los aceptan. El productor bloquea por defecto las cargas de personajes con apariencia humana y rechaza imágenes de referencia que contengan rostros humanos en el flujo de API documentado. Las funciones de personajes personales de la app de Sora corresponden a otro flujo de producto.
Una extensión toma un video de origen terminado y un prompt de continuación, y usa el clip de origen completo como contexto para el movimiento, la dirección de cámara y la continuidad de la escena. La guía describe adiciones de hasta 20 segundos por extensión. La entrada documentada de la extensión es el video de origen y el texto; ese modo excluye referencias adicionales de personajes o imágenes. Describe cómo continúa la acción existente en vez de introducir una escena sin relación y sin transición.
La edición de video se centra en un cambio claro de un clip existente. Una revisión específica puede modificar el color de un objeto o la paleta de la escena y conservar el resto de la toma. La guía del productor recomienda un cambio bien definido a la vez y distingue entre editar un video generado y subir metraje arbitrario, lo cual tiene una condición de elegibilidad separada. Conserva el original terminado e identifica la revisión exacta que necesitas antes de hacer otra edición.
El flujo de video documentado del productor es asíncrono: un trabajo enviado puede quedar en cola o en curso antes de completarse o fallar. Un trabajo completado entrega un video MP4; las miniaturas y las hojas de sprites permiten generar vistas previas y explorar los resultados. Mantén la identidad del trabajo asociada con el prompt, las referencias y los recursos devueltos. Una respuesta inicial del trabajo no es el video reproducible terminado.
El flujo habitual de descarga describe una vigencia de una hora para la URL de descarga. El flujo ampliado por lotes prepara solicitudes de renderizado JSON independientes, con identificadores de elemento estables, referencias cargadas y un resultado vinculado a cada toma; sus recursos terminados tienen un periodo de descarga separado de hasta 24 horas. Conserva el clip terminado cuanto antes e inspecciona la imagen y el sonido reales antes de considerarlo una toma seleccionada.
Las restricciones de contenido documentadas para la API del productor exigen material apto para públicos menores de 18 años y rechazan personajes o música con derechos de autor y la generación de personas reales. Prepara la escena y las referencias de acuerdo con ello. El resultado directo del modelo es video con audio, no imágenes fijas generadas, una respuesta conversacional de herramienta ni una película ilimitada. Conserva la identidad exacta del modelo estándar y el clip de origen aceptado al continuar un concepto visual.
POST /v1/messagestextjson, sse| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites sora-2 | Predeterminado— |
Campomessages | Tipomessage[] | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomessages[].role | Tipostring | RequisitoObligatorio | Valores y límites user, assistant | Predeterminado— |
Campomessages[].content | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomax_tokens | Tipointeger | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Texto · Texto UTF-8
cadena messages[].content
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, messages, max_tokens |
Parámetrooptional_controls | Contratostream |
Parámetromaterial_types | Contratotext |
Parámetrotext_file_material | ContratoLee el documento real en UTF-8 y coloca su texto en el campo input indicado o en la cadena de contenido del mensaje. |
Ciclo de vida: synchronous_or_streamed
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
| Configuración | Tabla de tarifas | Cargo |
|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cargo Entrada · Tokens de entrada $0 / 1K tokens Salida · Tokens de salida $0.2 / 1K tokens Entrada · Lectura de caché $0 / 1K tokens Entrada · Escritura en caché $0 / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot 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 →
{\n "model": "sora-2",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -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\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON o SSE
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva todos los bloques de contenido, las firmas de razonamiento y los ID reales de uso de herramientas. Ensambla todos los fragmentos incrementales de los bloques SSE; el primer bloque de texto no constituye la salida completa.
Conserva los ID de solicitud y respuesta y los encabezados. No se proporciona una URL genérica para recuperar tareas de texto.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campomodel | Tipostring |
Campocontent[] | Tipotext|thinking|tool_use|other content block |
Campostop_reason | Tipostring|null |
Campousage | Tipoobject |
| 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. |
Ailoot Ultra sora-2
Usa las rutas de método indicadas arriba.