API de Sora 2

Construya sobre la API de Sora 2

Envíe experiencias de texto a video respaldadas por OpenAI Sora 2 y Sora Pro. Autentíquese con claves API, sondee el estado de las tareas y entregue videos finales en minutos.

Por qué los equipos confían en la API de Sora 2

Ofrezca flujos de trabajo de generación de videos resistentes con sondeos predecibles, 20 solicitudes simultáneas y cargas de almacenamiento automáticas.

Sora 2 + Estable + Pro

Elija el modelo de cadena que se ajuste a sus necesidades de calidad y costo: sora-2, sora-2-stable o sora-2-pro.

Encuestas predecibles

Cree una tarea y luego sondee el punto final de verificación de resultados para mantener el estado y el progreso sincronizados sin SSE.

20 solicitudes simultáneas

Procese hasta 20 tareas de generación de video simultáneamente. Contáctenos para límites más altos.

Autenticación y URL base

Todos los puntos finales se encuentran bajo https://sora2-api.com/api. Proporcione la clave API creada en la consola a través del encabezado Autorización.

  • Envíe el encabezado Autorización: Portador YOUR_API_KEY con cada solicitud.
  • Utilice el tipo de contenido: aplicación/json al publicar cargas útiles.
  • Cada solicitud de generación deduce créditos según el modelo y la duración: sora-2/sora-2-stable 10s (100) o 15s (150), sora-2-pro (150); Los trabajos fallidos se reembolsan automáticamente.

Puntos finales principales

Comience creando una tarea de generación, luego sondee o escuche el resultado.

Crear vídeo de Sora 2

Inicie un trabajo de generación Sora 2 o Sora Pro con mensajes de texto a video o de imagen a video opcionales.

Método: POSTCamino: /api/v1/video/sora-video

Parámetros de carga útil

  • model: Requerido. Utilice "sora-2", "sora-2-stable" o "sora-2-pro".
  • prompt: Requerido. Descripción en lenguaje natural de la escena que quieres que cree Sora.
  • imageData: Opcional (recomendado). URL de datos Base64 con prefijo "data:image/*;base64", para el modo de imagen a vídeo.
  • url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
  • aspectRatio: Opcional. Valores admitidos: "9:16" (predeterminado) o "16:9".
  • isPublic: Opcional. Si mostrar el video públicamente; el valor predeterminado es verdadero.
  • remixTargetId: Opcional (solo VIP). Apunte al pid de video para funciones de continuación/remezcla.
  • characters: Opcional (solo VIP). Matriz de control de caracteres; cada elemento incluye URL y marcas de tiempo.

Notas

  • Las respuestas regresan inmediatamente con un taskId; resultado de la verificación de la encuesta hasta que el estado sea exitoso o fallido.

Solicitud de muestra

curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

Respuesta de muestra

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890"
  }
}

Verificar resultado de generación

Sondee el estado más reciente de una tarea de generación para realizar un seguimiento del progreso y recuperar resultados.

Método: POSTCamino: /api/video-generations/check-result

Parámetros de carga útil

  • taskId: Requerido. El identificador devuelto cuando creó la tarea de generación.

Notas

  • El punto final verifica que la tarea pertenece a su cuenta antes de devolver los datos.
  • Los trabajos fallidos devuelven créditos automáticamente y exponen metadatos de reembolso en la respuesta.

Solicitud de muestra

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

Respuesta de muestra

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

Obtenga créditos de usuario y estado VIP

Consulta los créditos disponibles del usuario actual y el estado de membresía VIP.

Método: POSTCamino: /api/get-user-credits

Notas

  • Requiere una sesión de inicio de sesión válida o un token API para acceder a la información del usuario.
  • Devuelve los campos de estado left_credits, is_recharged, is_pro e is_vip.

Solicitud de muestra

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Respuesta de muestra

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}

1. Crea la tarea

Envíe la solicitud de Tikdek con su mensaje y luego almacene el taskId devuelto.

2. Seguimiento del progreso

Llame al punto final de verificación de resultados hasta que el estado sea exitoso o fallido.

3. Entrega el vídeo

Utilice las URL respaldadas por almacenamiento en result_url/result_urls para publicar o descargar el video generado.

Preguntas frecuentes

¿Cómo autentico mis solicitudes?

Cree una clave API en la consola y luego inclúyala como Autorización: Portador YOUR_API_KEY. Las claves se pueden girar en cualquier momento.

¿Cómo debo realizar una encuesta para obtener resultados?

Después de llamar a crear, almacene el taskId. Llame a /api/video-generations/check-result cada 3-5 segundos hasta que el estado sea exitoso o fallido, luego use result_url/result_urls.

¿Cómo se manejan los créditos por fallas?

Reembolsamos créditos automáticamente cuando falla una tarea y devolvemos refund_trans_no más credits_refunded=true en la carga útil de resultados de verificación para pistas de auditoría.

Recursos útiles

Lanzamiento con Tikdek hoy

Cree su clave API y comience a generar videos cinematográficos de IA en minutos.