Génération vidéo apimart-zoe

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "Un chaton roux sur un rebord de fenêtre regarde la caméra, éclairé par le soleil de côté, avec un lent travelling avant",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "Un chaton roux sur un rebord de fenêtre regarde la caméra, éclairé par le soleil de côté, avec un lent travelling avant",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "Un chaton roux sur un rebord de fenêtre regarde la caméra, éclairé par le soleil de côté, avec un lent travelling avant",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

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

​

Choisir un mode

​

En-têtes

​

Paramètres

​

Adresses et limites des médias

​

Validation des vidéos de référence

​

Règles de combinaison des médias

• Ne transmettez pas image_urls et image_with_roles ensemble : cela renvoie HTTP 400 (invalid_request_error) à l’envoi, sans frais. Les alias image, images et image_url comptent comme image_urls et ne contournent pas cette restriction.
• Les images de début/fin ne peuvent pas figurer dans la même requête que des références image, vidéo ou audio.
• Une image de début et une de fin au maximum. La fin exige un début.
• Jusqu’à 30 images, 10 vidéos et 10 audios de référence, dans la limite de 50 médias au total.
• Toute violation de ces combinaisons ou quantités entraîne un HTTP 400 synchrone, sans facturation.
• omni_reference_task_type: "edit" exige au moins une vidéo source (3.8 ≤ t < 30.2 secondes). duration / seconds : omission ou -1 uniquement ; aspect_ratio / size : omission ou adaptive uniquement. Interdit avec draft: true. Les modes auto/reference conservent la limite 2–15 secondes et sa tolérance.

​

Exemples de requêtes

​

Première et dernière images

{
  "model": "apimart-zoe",
  "prompt": "Transition naturelle de la première à la dernière image, avec un éclairage cohérent",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Références image, vidéo et audio

{
  "model": "apimart-zoe",
  "prompt": "Le personnage de référence se déplace naturellement dans la scène de la vidéo, avec une musique adaptée au rythme des images",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Montage vidéo

{
  "model": "apimart-zoe",
  "prompt": "Transformer toute la scène en film classique noir et blanc en conservant les mouvements de caméra et la composition",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Dernière image, sortie MOV et optimisation du prompt

{
  "model": "apimart-zoe",
  "prompt": "Un chaton roux sur un rebord de fenêtre regarde la caméra, éclairé par le soleil de côté, avec un lent travelling avant",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Brouillon → vidéo finale

1. Envoyez le brouillon avec draft: true. Si resolution est omis, 480p est utilisé ; si le champ est présent, seule cette valeur est acceptée.

{
  "model": "apimart-zoe",
  "prompt": "Un chaton roux sur un rebord de fenêtre regarde la caméra, éclairé par le soleil de côté, avec un lent travelling avant",
  "draft": true
}

2. Attendez la réussite du brouillon, puis envoyez son task_id pour le rendu final. model et draft_task_id suffisent. Si vous indiquez resolution, utilisez uniquement 1080p.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

Statut et résultat

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Règles de facturation

• Durée totale des vidéos de référence R : mesure de chaque vidéo à l’envoi, addition, puis arrondi de la somme à l’entier inférieur. Aucun ajustement ultérieur.
• Sans vidéo de référence : secondes facturées = D. Avec référence : D + max(R, ceil(D × 2/3)). ceil arrondit à l’entier supérieur. Le tarif avec vidéo de référence s’applique.
• Exemple : une demande de 8 secondes conserve D = 8, même si le résultat dure 8.2 secondes. Une durée automatique de 8.5 donne D = 9. Deux références de 2.8 et 3.8 secondes sont additionnées à 6.6 puis arrondies vers le bas : R = 6.
• Brouillon (480p) et rendu final (1080p) sont facturés séparément. Les vidéos de référence du brouillon conservent leur durée initiale dans la facturation du rendu final, sans nouvel envoi.
• Aucun frais si l’envoi échoue. Les tâches échouées sont remboursées automatiquement.

​

Erreurs courantes