TikdekTikdek
Tikdek Video API

Integre Sora 2 Pro a través de API

Cree tareas de video de texto, imágenes o guiones gráficos con /api/v1/video/sora-pro, luego sondee el estado y entregue resultados con check-result.

Generar clave APIVer precios

Todo lo que necesitas para la entrega de Sora 2 Pro

Una API cubre Sora 2, Sora 2 Pro y flujos de trabajo de guiones gráficos con facturación clara y sondeos predecibles.

Siete modelos compatibles

Elija entre las variantes de texto/imagen de Sora 2, texto/imagen de Sora 2 estable y variantes de texto/imagen/guión gráfico de Sora 2 Pro.

Créditos escalonados

Los créditos varían con la duración y la calidad, incluido el estándar/alto para Sora 2 Pro.

Entrega basada en tareas

Cree una tarea, sondee el resultado de la verificación y envíe la URL del resultado final.

Autenticación y URL base

Todos los puntos finales reciben servicio desde https://sora2-api.com. Envíe la clave API desde la consola en el encabezado Autorización.

  • Incluya Autorización: Portador YOUR_API_KEY en cada solicitud.
  • Utilice Content-Type: application/json para cargas útiles JSON.
  • Las respuestas incluyen código/mensaje/datos; check-result puede devolver 4xx/5xx, así que valide también el estado HTTP.

Créditos y facturación

La facturación varía según el modelo, la duración y el nivel de calidad.

  • Texto/imagen de Sora 2: 10 chelines = 100 créditos, 15 chelines = 150 créditos.
  • Sora 2 Texto/imagen estable: 10 chelines = 100 créditos, 15 chelines = 150 créditos.
  • Texto/imagen de Sora 2 Pro: 10 s = 375, 15 s = 675.
  • Guión gráfico de Sora 2 Pro: 10s = 375, 15s = 675, 25s = 875.
  • Los precios anteriores son finales; los cargos se redondean.

Puntos finales principales

Comience creando una tarea de generación, luego sondee o verifique su saldo de crédito.

Crear vídeo de Sora 2 Pro

Envíe trabajos de texto, imágenes o guiones gráficos, deduzca créditos inmediatamente y reciba el identificador de tarea.

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

Parámetros de carga útil

  • modelo: Requerido. Utilice una de las cadenas de modelo compatibles anteriores.
  • mensaje: Obligatorio excepto para el guión gráfico. Describe la escena que deseas generar.
  • imageData: Necesario para la conversión de imagen a vídeo. URL de datos Base64 con prefijo "data:image/*;base64".
  • URL de la imagen: opcional. URL de imagen pública si prefieres no enviar base64.
  • relación de aspecto: opcional. "paisaje" o "retrato" (paisaje predeterminado).
  • nMarcos: Opcional. "10"/"15"/"25" (25 es solo el guión gráfico).
  • tamaño: Opcional (texto/imagen profesional). "estándar" o "alto".
  • removeWatermark: Opcional (texto/imagen). Eliminar la marca de marca de agua, el valor predeterminado es verdadero.
  • Tomas: Requeridas para el guión gráfico. Conjunto de planos con escena y duración.
  • esPúblico: Opcional. Si el resultado es público, el valor predeterminado es verdadero.

Notas

  • Modelos compatibles: sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Los créditos se deducen al enviar; Los trabajos fallidos se reembolsan automáticamente.
  • El modo de guión gráfico requiere la matriz de tomas.

Estructura de tiros

Requerido para solicitudes de guiones gráficos; cada elemento define una escena y una duración.

[
  { "scene": "Una acogedora cafetería al amanecer, luz cálida.", "duration": 7.5 }
]
  • escena: Descripción de la toma.
  • duración: Segundos (admite decimales como 7,5).

Solicitud de muestra

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "Un seguimiento cinematográfico a través de un mercado callejero iluminado con luces de neón al anochecer.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Respuesta de muestra

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

Verificar resultado de generación

Sondear el estado de la tarea y sincronizar los resultados.

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

Parámetros de carga útil

  • ID de tarea: obligatorio. El identificador devuelto cuando creó la tarea de generación.

Notas

  • Devuelve estado, progreso y result_url cuando esté disponible.
  • Puede devolver 4xx/5xx para validación, permiso o casos no encontrados.

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": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Obtener créditos de usuario

Obtenga los créditos restantes y el estado VIP.

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

Notas

  • Requiere una clave API o una sesión válida.
  • Devuelve los campos left_credits 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_vip": true
  }
}

1. Crea la tarea

Envíe /api/v1/video/sora-pro con su carga útil, luego almacene el taskId.

2. Seguimiento del progreso

Encuesta /api/video-generations/check-result hasta que el estado sea exitoso o fallido.

3. Entrega el vídeo

Utilice result_url/result_urls para distribuir o almacenar el vídeo generado.

Preguntas frecuentes

¿Qué modelos son compatibles?

Utilice sora-2-text-to-video o sora-2-image-to-video; Sora 2 Pro agrega variantes de texto, imágenes y guiones gráficos.

¿Qué valores admite nFrames?

Utilice "10" o "15" para todos los modos; "25" es sólo para el guión gráfico. El texto/imagen profesional admite tamaño estándar o alto.

¿Por qué el resultado de verificación puede devolver 4xx/5xx?

El punto final valida la propiedad y la entrada, por lo que las tareas no válidas o no autorizadas pueden devolver 4xx/5xx junto con el código/mensaje.

Recursos útiles

Consola de claves API

Cree, rote y revoque claves API para sus integraciones.

Precios

Revise el consumo de crédito y las opciones de recarga antes del lanzamiento.

Pruebas API en línea

Pruebe los puntos finales con nuestro parque interactivo Apifox.

Contactar con soporte

¿Necesita un límite de tarifa más alto o un contrato personalizado? Comuníquese con nosotros a través de [email protected].

Lanzar con Tikdek Video API

Crea tu clave API y comienza a generar videos de Sora 2 Pro en minutos.

Ir a la consola APIVer precios