ShareAI Platform Docs

Generar videos

La presentación devuelve HTTP 202 con un ID de trabajo de ShareAI y una URL de sondeo.

Ver como Markdown
En esta página
POST https://api.shareai.now/api/v1/videos

Generar videos

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado
Alcance requerido
inference or monetization_gateway

La presentación devuelve HTTP 202 con un ID de trabajo de ShareAI y una URL de sondeo. Envía un Idempotency-Key encabezado estable para reintentos de la misma solicitud. Reutilizar esa clave con una entrada diferente es rechazado. Sondea GET /api/v1/videos/{id} con la misma credencial de origen. Los estados incluyen en cola, pendiente, en_progreso, finalizando, completado, fallido y requiere_revisión. Un resultado requiere_revisión necesita reconciliación del equipo; el sondeo nunca inicia otra generación.

Antes de comenzar#

Configure SHAREAI_API_KEY en su servidor y reemplace el marcador de posición del modelo con un modelo actualmente habilitado. Nunca exponga la clave API en el código del navegador. El modelo, la cuenta, las credenciales y el proveedor deben permitir esta operación. Las configuraciones opcionales a continuación requieren soporte del modelo; los límites de seguridad de la API no garantizan que todos los modelos admitan todos los valores.

Envía una solicitud#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

Campos de solicitud#

CampoTipoSignificado y límites
model requeridocadenaIdentificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales.
prompt requeridocadenaIndicador de generación no vacío, de un máximo de 256 KiB de texto UTF-8.
durationenteroDuración opcional del video solicitada en segundos, de 1 a 600, restringida adicionalmente por el modelo seleccionado. Las duraciones reales devueltas determinan la facturación por duración.
resolutioncadenaSelector de resolución compatible con el modelo, de un máximo de 100 caracteres; debe coincidir con la variante de tarifa publicada.
aspect_ratiocadenaSelector de relación de aspecto compatible con el modelo, de un máximo de 100 caracteres.
sizecadenaTamaño de salida compatible con el modelo, de un máximo de 100 caracteres, por ejemplo 1024×1024. No todos los modelos admiten esta opción.
generate_audiobooleanoSelector opcional de banda sonora de video. Se requiere soporte del modelo y la variante de tarifa correspondiente.
seedenteroSemilla opcional compatible con el modelo. El video requiere un número entero no negativo; la reproducibilidad depende del ejecutor.
frame_imagesmatrizUn máximo de dos partes de image_url, cada una con frame_type como first_frame o last_frame, sin duplicados. No combines frame_images y input_references.
input_referencesmatrizUn máximo de 16 partes de image_url tipificadas con image_url.url configurado en una URL HTTPS o una URL de datos de imagen compatible. Se requiere compatibilidad con el modelo.
providerobjetoPreferencias opcionales de enrutamiento del proveedor. Use provider.only para etiquetas de proveedor aceptadas, no como prefijo en el ID del modelo. Las restricciones de cuenta y credenciales aún se aplican.
allow_temporary_retentionbooleanoSolo video. True explícito permite la retención temporal de resultados upstream en rutas que lo requieran. Omitido/false mantiene esas rutas no disponibles. Conflictos con provider.zdr:true; otras operaciones retienen ZDR obligatorio.

Leer el resultado#

El éxito devuelve HTTP 202 con JSON. La presentación devuelve HTTP 202 con un ID de trabajo de ShareAI y una URL de sondeo. Envía un Idempotency-Key encabezado estable para reintentos de la misma solicitud. Reutilizar esa clave con una entrada diferente es rechazado. Sondea GET /api/v1/videos/{id} con la misma credencial de origen. Los estados incluyen en cola, pendiente, en_progreso, finalizando, completado, fallido y requiere_revisión. Un resultado requiere_revisión necesita reconciliación del equipo; el sondeo nunca inicia otra generación.

Unidades de facturación#

Las rutas de video declaran sus unidades facturadas. Una ruta por segundo se liquida utilizando la duración medida de cada archivo devuelto, nunca la duración solicitada ni un costo USD upstream. La duración solicitada debe estar entre 1 y 600 segundos y ser compatible con el modelo. Una retención de crédito conservadora puede cubrir hasta cuatro salidas.

Elija el identificador exacto del modelo habilitado desde la Consola. Su operación declarada y capacidades de entrada/salida deben coincidir con este endpoint; un modelo de chat de texto no puede sustituirse por otra operación. Sus restricciones de credenciales, proveedor y cuenta aún se aplican.

Precios y uso#

Las tarifas se publican en créditos de IA en EUR para el modelo, proveedor, unidades y variantes seleccionados. Solo se cobran las dimensiones en su tarifa activa. Una estimación reserva créditos antes de la ejecución; los cargos finales usan el uso medido. Los precios pueden depender de la resolución, el formato de salida o una banda de uso. Consulte Uso en la Consola para el débito final de ShareAI. Los campos de costos ascendentes y bytes de medios no se convierten en recuentos de tokens inventados.

Acceso y errores#

Usar inference para inferencia aprobada con costo de red o monetization_gateway para un margen aprobado del Builder y términos de facturación aceptados. El acceso solo con identidad no autoriza gastos. La validación, autorización del modelo, créditos insuficientes, límites de tarifa y fallos de ejecución devuelven una error. estructura. Después de un tiempo de espera o envío incierto, inspeccione Uso o el trabajo de video antes de crear otra solicitud potencialmente pagada.

Retención temporal de video#

Algunas rutas de video necesitan retención temporal upstream para que el resultado generado pueda ser recuperado. Requieren tu allow_temporary_retention:true aceptación explícita en esa solicitud de video. Omitirla mantiene esas rutas no disponibles. Esta excepción se aplica solo a video y nunca permite el entrenamiento del modelo o la retención para otras operaciones. Una política ZDR explícita no puede ser debilitada silenciosamente.

JSON

{"allow_temporary_retention": true}

Verificar el estado del trabajo#

GET https://api.shareai.now/api/v1/videos/{id}

Lee una generación de video con su credencial de origen

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado
Alcance requerido
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

El JSON anterior ilustra los campos estables del trabajo, no una generación real. Sondea la ruta de ShareAI con la misma clave, esperando entre verificaciones. en_cola, pendiente, en_progreso y finalizando significan esperar; completado expone datos con URLs de contenido de ShareAI; fallido y requiere_revisión significan detenerse e inspeccionar. Los estados de reintento se leen después de errores transitorios, pero no vuelvas a enviar la generación automáticamente. Una credencial diferente o revocada no puede recuperar el trabajo.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Descargar el resultado#

Cuando se completa, cada entrada de datos contiene una URL de contenido de ShareAI. Recupera GET /api/v1/videos/{id}/content?index=0 usando la misma credencial de origen. El endpoint admite un único rango de bytes HTTP. Las URLs de proveedores, tickets privados y credenciales de proveedores nunca se devuelven. El sondeo y la descarga no crean una segunda solicitud de inferencia ni un cargo de ingestión del Monetization Gateway. Un trabajo completado significa que la liquidación está confirmada antes de que el archivo sea descargable.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

Los opcionales frame_images deben contener partes image_url con first_frame o last_frame. Usa imágenes de fotogramas o imágenes de referencia en una solicitud, no ambas. Las duraciones, resoluciones y relaciones de aspecto de los modelos pueden ser más restrictivas que los límites de seguridad de la API. No se admiten webhooks ni URLs de callback arbitrarias.

Última actualización noviembre 3, 2026.

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI