Saltar al contenido principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

​
Autorizaciones

​
Authorization
string
requerido
Todas las APIs requieren autenticación mediante Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:
Authorization: Bearer YOUR_API_KEY

​
Parámetros de la solicitud

​
model
string
predeterminado:"grok-imagine-1.0-video-apimart"
requerido
Nombre del modelo de generación de videoModelos compatibles:
  • grok-imagine-1.0-video-apimart - Generación de video Grok
Ejemplo: "grok-imagine-1.0-video-apimart"
​
prompt
string
requerido
Descripción del contenido del video, admite múltiples idiomas
​
size
string
predeterminado:"16:9"
Tamaño del videoOpciones:
  • 16:9 - Horizontal (predeterminado)
  • 9:16 - Vertical
  • 1:1 - Cuadrado
  • 3:2 - Horizontal
  • 2:3 - Vertical
​
duration
integer
predeterminado:6
Duración del video (segundos)Rango: 6-30 (mínimo 6 segundos, máximo 30 segundos)⚠️ Nota: Debe ser un número simple (por ejemplo, 6), sin comillas, de lo contrario se producirá un error
​
quality
string
predeterminado:"480p"
Calidad del videoOpciones:
  • 480p - Definición estándar (predeterminado)
  • 720p - Alta definición
​
image_urls
string[]
Lista de URLs de imágenes de referenciaLímites:
  • Máximo 7 imágenes
  • Deben ser URLs de acceso público
  • No se admite el formato Base64
Tras subir una imagen de referencia, la relación de aspecto coincidirá automáticamente con la de la imagen de referencia.

​
Respuesta

​
code
integer
Código de estado de la respuesta
​
data
object
Objeto de datos de la respuesta
Consultar el resultado de la tareaLa generación de video es una tarea asíncrona. Tras la solicitud, se devolverá un id (es decir, task_id). Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.

​
Casos de uso

​
Caso 1: Texto a video

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "A dog running on the beach, sunny weather, slow motion",
  "size": "16:9",
  "duration": 6
}

​
Caso 2: Imagen a video

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "Bring the scene to life with natural dynamic effects",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}