Guía de migración

Planifica el futuro después de Sora 2

Mantén estable tu producto con un contrato neutral, archivos propios y modelos alternativos probados.

Una solicitud neutral respecto al proveedor
type VideoGenerationRequest = {
  prompt: string;
  imageUrl?: string;
  aspectRatio: "16:9" | "9:16";
  durationSeconds: number;
  quality: "standard" | "high";
  callbackUrl?: string;
};

type VideoGenerationResult = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed";
  progress: number;
  outputUrl?: string;
  errorCode?: string;
};

interface VideoProvider {
  create(input: VideoGenerationRequest): Promise<{ id: string }>;
  retrieve(id: string): Promise<VideoGenerationResult>;
}

Separa tu producto del modelo

Normaliza entradas, estados, errores y URLs antes de llegar al código del proveedor.

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.

Facturación transparente

Cada llamada cuesta 100 créditos para 10s sora-2/sora-2-stable, 150 créditos para 15s sora-2/sora-2-stable o 150 créditos para sora-2-pro, con reembolsos automáticos cuando falla una generación.

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.

Flujo de integración recomendado

Fecha de migración

OpenAI prevé retirar Sora 2 y Videos API el 24 de septiembre de 2026. Valida una alternativa antes.

Crea la tarea

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

Seguimiento del progreso

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

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.

Haz rutinario el próximo cambio de modelo

Mantén endpoints estables y limita la selección del proveedor a un adaptador reemplazable.