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-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "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-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'

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

​
Autenticación

​
Authorization
string
requerido
Todos los endpoints requieren autenticación mediante Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñadir 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-i2v-flash
​
image_urls
array<string>
requerido
Array de URLs de imágenes de referencia (solo se admite 1 imagen del primer fotograma)Admite URLs de imágenes accesibles públicamente o codificación Base64 (data:image/png;base64,...)Ejemplo: ["https://example.com/image.jpg"]
Requisitos de la imagen:
  • Formato: JPEG, JPG, PNG (sin transparencia), BMP, WEBP
  • Resolución: rango de ancho/alto 240-8000 píxeles
  • Tamaño: ≤ 10MB
​
prompt
string
Descripción del contenido del videoOpcional pero recomendado para image-to-video, describe las acciones y efectos esperadosEspecifique claramente el sujeto, la acción, la cámara y el estilo para obtener mejores resultadosEjemplo: "The person in the image smiles and waves, camera slowly zooms in"
​
negative_prompt
string
Prompt negativo, describe contenido no deseadoMáximo 500 caracteresEjemplo: "blurry, low quality, distorted"
​
resolution
string
predeterminado:"1080p"
Resolución del videoOpciones:
  • 720p - HD
  • 1080p - FHD (por defecto)
Por defecto: 1080p
La resolución afecta directamente al precio, 1080p es más caro que 720p. La proporción de aspecto la determina la imagen de entrada.
​
duration
integer
predeterminado:"5"
Duración del video (segundos)Rango soportado: 2 a 15 segundos (entero)Por defecto: 5
​
audio
boolean
predeterminado:"true"
Si se debe generar audioEstablecer en true: genera automáticamente música de fondo / efectos de sonido que coincidan (por defecto)Establecer en false: produce un video silenciosoPor defecto: true
No se admite cuando el modelo es wan2.6-i2v.
​
audio_url
string
URL de audio personalizado (wav/mp3, 3-30 segundos, ≤ 15MB)Tiene menor prioridad que audio: se ignora cuando audio=falseSi el audio es más largo que la duración del video, será recortado; si es más corto, la parte restante quedará en silencio
Requisitos del archivo de audio:
  • Formato: wav, mp3
  • Duración: 3-30 segundos
  • Tamaño: ≤ 15MB
​
prompt_extend
boolean
predeterminado:"true"
Si se debe activar la reescritura inteligente del promptMejora significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamientoPor defecto: true
​
shot_type
string
Tipo de toma, requiere prompt_extend=trueOpciones:
  • single - Toma única (por defecto), produce un video de toma única continua
  • multi - Multi-toma, produce un video narrativo con múltiples transiciones de toma
shot_type tiene mayor prioridad que prompt. Incluso si el prompt menciona “multi-toma”, establecer single seguirá produciendo una toma única.
​
seed
integer
Semilla aleatoria (≥0), especificar la misma semilla puede reproducir resultados similaresEjemplo: 12345
​
watermark
boolean
predeterminado:"false"
Si se debe añadir una marca de agua “AI Generated” (esquina inferior derecha)Por defecto: false

​
Control de audio

Combinación de parámetrosResultado
Sin audio ni audio_urlAudio generado automáticamente (por defecto)
audio_url: "https://..."Usar audio especificado
audio: falseVideo silencioso
audio: false + audio_url: "..."Video silencioso (audio tiene mayor prioridad)

​
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: Solicitud mínima

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/image.jpg"]
}

​
Caso 2: Parámetros completos

{
  "model": "wan2.6-i2v-flash",
  "prompt": "The person in the image smiles and waves, camera slowly zooms in",
  "image_urls": ["https://example.com/image.jpg"],
  "negative_prompt": "blurry, low quality, distorted",
  "resolution": "1080p",
  "duration": 10,
  "seed": 12345,
  "prompt_extend": true,
  "shot_type": "multi",
  "audio": true,
  "watermark": false
}

​
Caso 3: Audio personalizado

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Person dancing to the music",
  "image_urls": ["https://example.com/dancer.jpg"],
  "audio_url": "https://example.com/music.mp3",
  "resolution": "1080p",
  "duration": 10
}

​
Caso 4: Video silencioso

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Flower slowly blooming",
  "image_urls": ["https://example.com/flower.jpg"],
  "audio": false,
  "resolution": "720p",
  "duration": 5
}

​
Caso 5: Plantilla de efecto

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/person.jpg"],
  "template": "flying",
  "resolution": "720p"
}

​
Caso 6: Imagen Base64

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}
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.