Proceso de Solicitud
Para utilizar la API, primero debe ir a la página correspondiente de Sora Videos Generation API para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón “Acquire”, como se muestra en la imagen:
Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que lo invita a registrarse e iniciar sesión. Después de iniciar sesión o registrarse, será redirigido automáticamente a la página actual.
En la primera solicitud, se le otorgará un crédito gratuito que le permitirá utilizar la API sin costo.
Uso Básico
Primero, comprenda la forma básica de uso, que consiste en ingresar la palabra claveprompt, un array de enlaces de imágenes de referencia image_urls y el modelo model, para obtener el resultado procesado. El contenido específico es el siguiente:
accept: el formato de respuesta que desea recibir, aquí se establece comoapplication/json, es decir, en formato JSON.authorization: la clave para llamar a la API, que puede seleccionarse directamente después de la solicitud.
model: el modelo para generar el video, que incluyesora-2ysora-2-pro. Actualmente,sora-2ysora-2-propermiten seleccionar los parámetrossizeydurationpara el video, dondesora-2-proadmite videos de 25s, mientras quesora-2solo admite videos de 10 y 15 segundos.size: la claridad de la tarea de generación de video, que puede sersmallolarge.image_urls: enlaces de imágenes de referencia que deben subirse o un array codificado en Base64.duration: la duración de la tarea de generación de video, que puede ser de 10s, 15s o 25s, siendo solosora-2-proel que admite 25s.character_start/character_end: la posición de inicio y fin del personaje en la pantalla (0-1), utilizada para controlar la posición del sujeto.orientation: la dirección del marco, que admitelandscape,portraitosquare.prompt: la palabra clave.callback_url: la URL para recibir el resultado.
success, el estado de la tarea de generación de video en ese momento.task_id, el ID de la tarea de generación de video en ese momento.trace_id, el ID de seguimiento de la generación de video en ese momento.data, la lista de resultados de la tarea de generación de video en ese momento.id, el ID del video de la tarea de generación de video en ese momento.video_url, el enlace del video de la tarea de generación de video en ese momento.state, el estado de la tarea de generación de video en ese momento.
data.
Además, si desea generar el código de integración correspondiente, puede copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
Tarea de Video a partir de Imágenes
Si desea realizar una tarea de video a partir de imágenes, primero debe pasar el parámetroimage_urls con los enlaces de las imágenes de referencia, lo que permitirá especificar el siguiente contenido:
- image_urls: el array de enlaces de las imágenes de referencia utilizadas en esta tarea de video a partir de imágenes.
Tarea de generación de video de personajes
Si deseas realizar una tarea de generación de video de personajes, primero el parámetrocharacter_url debe incluir el enlace del video necesario para crear el personaje, ten en cuenta que en el video no debe aparecer ninguna persona real, de lo contrario fallará, así que puedes especificar el siguiente contenido:
- character_url: enlace del video necesario para crear el personaje, ten en cuenta que en el video no debe aparecer ninguna persona real, de lo contrario fallará.
Callback asíncrono
Debido a que el tiempo de generación de la API de Sora Videos es relativamente largo, aproximadamente de 1 a 2 minutos, si la API no responde durante mucho tiempo, la solicitud HTTP mantendrá la conexión, lo que provocará un consumo adicional de recursos del sistema, por lo que esta API también ofrece soporte para callbacks asíncronos. El flujo general es: cuando el cliente inicia la solicitud, se especifica un campo adicionalcallback_url, después de que el cliente inicia la solicitud a la API, la API devolverá inmediatamente un resultado que incluye un campo de información task_id, que representa el ID de la tarea actual. Cuando la tarea se completa, el resultado del video generado se enviará al callback_url especificado por el cliente en formato JSON POST, que también incluye el campo task_id, de esta manera el resultado de la tarea se puede asociar mediante el ID.
A continuación, veamos un ejemplo para entender cómo operar específicamente.
Primero, el callback de Webhook es un servicio que puede recibir solicitudes HTTP, los desarrolladores deben reemplazarlo con la URL de su propio servidor HTTP. Para facilitar la demostración, se utiliza un sitio web de muestra de Webhook público https://webhook.site/, al abrir este sitio se obtiene una URL de Webhook, como se muestra en la imagen:
Copia esta URL y se puede usar como Webhook, el ejemplo aquí es https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa.
A continuación, podemos establecer el campo callback_url como la URL de Webhook anterior, al mismo tiempo que llenamos los parámetros correspondientes, el contenido específico es como se muestra en la imagen:
https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa, como se muestra en la imagen:
El contenido es el siguiente:
task_id, los otros campos son similares a los anteriores, y a través de este campo se puede lograr la asociación de tareas.
Manejo de errores
Al llamar a la API, si se encuentra con un error, la API devolverá el código de error correspondiente y la información. Por ejemplo:400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.401 invalid_token: No autorizado, token de autorización inválido o faltante.429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.500 api_error: Error interno del servidor, algo salió mal en el servidor.