TikdekTikdek
Entrega asíncrona

Tareas de vídeo fiables con estados y webhooks

Usa sondeo en clientes simples o webhooks para entrega automática con el mismo ciclo de vida.

Generar clave APILeer documentos
Crear una tarea con webhook
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",
    "prompt": "A tracking shot through a quiet night market",
    "aspectRatio": "16:9",
    "webHook": "https://api.example.com/webhooks/video",
    "isPublic": false
  }'

# Your webhook receives a terminal payload:
{
  "id": "task_123",
  "status": "succeeded",
  "progress": 100,
  "results": [{ "url": "https://storage.example/video.mp4" }]
}

Un ciclo de vida, dos formas de entrega

Guarda cada ID y considera succeeded y failed como únicos estados finales.

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.

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.

Flujo de integración recomendado

Reglas de entrega del webhook

Responde 2xx rápido, procesa de forma idempotente y conserva el sondeo como recuperación.

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.

Publica generación asíncrona resistente

Empieza con sondeo y añade webhooks sin cambiar el contrato de generación.

Ir a la consola APIVer precios