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": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

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": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
Autorización

​
Authorization
string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su 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
requerido
Nombre del modelo de generación de video, fijado como wan2.6
​
prompt
string
requerido
Descripción del contenido del videoRequerido para el modo text-to-video. Describa escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Array de URLs de imágenes de referencia (solo se admite 1 imagen)Requerido para el modo image-to-video. Admite URLs de imágenes accesibles públicamenteEjemplo: ["https://example.com/image.jpg"]
El sistema selecciona automáticamente el modo text-to-video o image-to-video según si se incluye image_urls
​
negative_prompt
string
Prompt negativo que describe contenido no deseadoEjemplo: "blurry, low quality, distorted"
​
aspect_ratio
string
predeterminado:"16:9"
Proporción de aspecto del videoOpciones:
  • 16:9 - Paisaje (por defecto)
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Por defecto: 16:9
No soportado en el modo image-to-video
​
resolution
string
predeterminado:"720p"
Resolución del videoOpciones:
  • 720p - Estándar (por defecto)
  • 1080p - Alta definición
Por defecto: 720p
La resolución 480p no es soportada
Facturado por segundo. El precio varía según la resolución. Consulte el marketplace de modelos para conocer los precios específicos
​
duration
integer
predeterminado:"5"
Duración del video (segundos)Valores soportados: 5, 10, 15 segundos únicamentePor defecto: 5
​
seed
integer
Semilla aleatoria para resultados reproduciblesEjemplo: 12345
​
prompt_extend
boolean
Si se debe extender automáticamente el promptCuando está activado, el sistema optimizará y enriquecerá automáticamente su prompt
​
audio
boolean
Si se debe añadir audio automáticamenteCuando está activado, el sistema generará audio que coincida con el video
​
audio_url
string
URL de audio especificadaTiene prioridad sobre el parámetro audio
La duración del audio no puede superar la duración del video. Si el audio es más corto que la duración del video, la primera parte del video tendrá sonido mientras que el resto será silencioso.
​
shot_type
string
Tipo de tomaOpciones:
  • single - Toma única
  • multi - Múltiples tomas
​
watermark
boolean
Si se debe añadir una marca de agua
​
template
string
Nombre de la plantilla de efecto para el modo de efectos especiales image-to-video
Al usar el modo de efectos:
  • Solo se requiere una imagen (pasada mediante image_urls)
  • No se necesita prompt (el modelo ignora el campo prompt)
Efectos generales:
  • squish - Squish & Squeeze
  • rotation - Rotación
  • poke - Pinchar
  • inflate - Inflado de globo
  • dissolve - Disolución molecular
  • melt - Derretimiento por ola de calor
  • icecream - Planeta helado
  • flying - Levitación mágica
Efectos para una sola persona:
  • carousel - Carrusel del tiempo
  • singleheart - Te amo
  • dance1 - Momento swing
  • dance2 - Movimiento de baile
Para más efectos, consulte la Documentación de plantillas de Alibaba Wanxiang

​
Combinaciones de resolución y proporción de aspecto

Proporción de aspectoDescripciónTamaño 720pTamaño 1080p
16:9Paisaje (por defecto)1280×7201920×1080
9:16Retrato720×12801080×1920
1:1Cuadrado960×9601440×1440
4:3Paisaje1088×8321632×1248
3:4Retrato832×10881248×1632

​
Respuesta

​
code
integer
Código de estado de la respuesta, 200 en caso de éxito
​
data
array
Array de datos de la respuesta

​
Casos de uso

​
Caso 1: Texto a video (Solicitud simple)

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

​
Caso 2: Texto a video (Parámetros completos)

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
Caso 3: Imagen a video

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

​
Caso 4: Imagen a video (Imagen Base64)

{
  "model": "wan2.6",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Descripción de modos

​
Texto a video (Text-to-Video)

  • El parámetro prompt es obligatorio
  • El parámetro image_urls no es necesario

​
Imagen a video (Image-to-Video)

  • El parámetro image_urls es obligatorio (solo se admite 1 imagen)
  • El parámetro prompt es opcional, se usa para describir las acciones esperadas
El sistema selecciona automáticamente el modo según si se incluye image_urls en la solicitud
Consultar resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.