apimart-zoe API

apimart-zoe est un modèle multimodal de génération vidéo d'APIMart, appelé avec l'ID de modèle apimart-zoe. L'apimart-zoe API prend en charge le texte vers vidéo, la vidéo à partir des première et dernière images, la vidéo à partir de références image, vidéo et audio, le montage d'une vidéo existante, un audio facultatif généré avec la vidéo, ainsi qu'un processus en deux étapes du brouillon 480p à la vidéo finale 1080p. Les clips durent de 4 à 30 secondes en 480p, 720p, 1080p, 2k ou 4k.

Envoyez POST /v1/videos/generations avec model apimart-zoe et votre prompt, en utilisant Authorization: Bearer <clé API>. La réponse renvoie un task_id. La génération prend généralement 1 à 3 minutes : interrogez GET /v1/tasks/{task_id} toutes les 5 à 10 secondes jusqu'à ce que data.status soit completed, puis lisez l'URL de la vidéo dans data.result.videos[0].url[0]. L'exemple de cette page fournit du code cURL et Python, et la référence complète de l'apimart-zoe API se trouve dans la documentation APIMart.

model (apimart-zoe) est obligatoire. prompt est obligatoire en texte vers vidéo, facultatif si vous n'envoyez que des médias, et limité à 204 800 caractères. Les paramètres facultatifs sont resolution (480p, 720p, 1080p, 2k ou 4k), aspect_ratio ou size (21:9, 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive), duration ou seconds (4 à 30 ou -1), audio ou generate_audio, seed, image_with_roles, image_urls (alias image, images, image_url), first_frame_image, last_frame_image, video_urls, audio_urls, draft, draft_task_id, omni_reference_task_type (auto, reference ou edit), return_last_frame, output_format ou response_format (mp4 ou mov) et enhance_prompt, ainsi que le champ APIMart nsfw_check. negative_prompt, camera_fixed (y compris camerafixed), extend_from_task_id, mask_url, video_list, element_list, multi_shot et tools ne sont pas pris en charge : dès que le champ figure dans la requête, même vide, false ou null, elle renvoie 400. n ne peut être qu'omis ou égal à 1. Le tableau des paramètres de cette page indique les valeurs par défaut et les limites.

Réglez duration (ou seconds) sur un nombre entier de 4 à 30 ; la valeur par défaut est 5, et -1 laisse le modèle décider. resolution vaut 480p, 720p (par défaut), 1080p, 2k ou 4k, sans tenir compte de la casse. aspect_ratio, aussi accepté sous le nom size, vaut 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive (par défaut : le modèle ou vos médias définissent le cadrage). Pour un montage vidéo, omettez duration et aspect_ratio (ou envoyez -1 et adaptive) : la durée et le cadrage suivent la vidéo source. Les brouillons sont toujours en 480p et les vidéos finales en 1080p.

Oui. Envoyez image_with_roles avec first_frame et last_frame, ou utilisez first_frame_image et last_frame_image. Chaque image clé prend une seule image, et une dernière image exige une première image. Une requête avec première et dernière images ne peut pas inclure aussi des images, vidéos ou audio de référence ; une telle requête renvoie 400 et n'est pas facturée. Décrivez dans le prompt comment le plan passe d'une image à l'autre.

Jusqu'à 30 images, 10 vidéos et 10 clips audio de référence, 50 fichiers au total ; l'audio de référence doit être accompagné d'une image ou d'une vidéo de référence. Images : jpeg, png, webp, bmp, tiff, gif, heic ou heif, 300 à 6000 pixels par côté, rapport 0,4 à 2,5, moins de 30 Mo. Vidéos : mp4 ou mov (H.264/H.265, piste audio AAC ou MP3), 2 à 15 secondes chacune (1,8 à 15,2 s acceptées) et 200 Mo maximum, largeur et hauteur de 300 à 6000 pixels, largeur × hauteur entre 409 600 et 8 295 044 (environ 640×640 à 3840×2160), rapport 0,4 à 2,5, 24 à 60 i/s après arrondi (23,976 et 59,94 sont acceptés) ; la vidéo source d'un montage peut durer de 4 à 30 secondes (au moins 3,8 s et moins de 30,2 s), et sans type de tâche, une vidéo de plus de 15 secondes nécessite edit. Audio : wav ou mp3, 2 à 15 secondes (1,8 à 15,2 s) et 15 Mo maximum par clip, 30 secondes au total (30,2 s au plus). La durée, les dimensions, le rapport et la fréquence d'images des vidéos de référence, ainsi que la durée de l'audio de référence, sont vérifiés à l'envoi : un fichier non conforme renvoie 400 invalid_request_error, sans facturation. Les dimensions des images, la taille des fichiers et l'encodage sont vérifiés pendant la génération : un fichier non conforme fait échouer la tâche et le montant est remboursé automatiquement, vérifiez donc vos fichiers avant l'appel. Tous les médias doivent être des URL http(s) publiques ou des ID asset:// ; les URI data: ne sont pas acceptées, téléversez donc d'abord vos fichiers à une adresse publique. À l'envoi, APIMart enregistre chaque fichier automatiquement, et un même fichier réutilisé sous 7 jours n'est pas réenregistré. Si vous n'envoyez que des médias, prompt peut être omis.

Envoyez une requête avec draft: true pour obtenir un aperçu 480p peu coûteux ; les brouillons sont uniquement en 480p et ne se combinent pas avec un montage vidéo. Une fois le brouillon réussi, envoyez une deuxième requête avec model et draft_task_id, égal au task_id du brouillon. La vidéo finale est rendue en 1080p et reprend le prompt, les médias, la durée, le format d'image, la graine et le réglage audio du brouillon. Hormis model, draft_task_id, resolution et des champs communs comme nsfw_check ou webhook, aucun champ n'est accepté : prompt, médias, duration, aspect_ratio, seed, audio, omni_reference_task_type, return_last_frame, output_format ou enhance_prompt renvoient 400, même vides. Créez la vidéo finale dans les 24 heures : un draft_task_id inexistant, qui n'est pas un brouillon, inachevé ou de plus de 24 heures renvoie 400. Le brouillon et la vidéo finale sont chacun facturés comme une génération ; la vidéo finale est facturée en 1080p sur la durée du brouillon, ou sur sa durée réelle si le brouillon utilisait -1.

Les erreurs d'envoi renvoient un objet error avec message, type, param et code, et ne sont pas facturées. 400 invalid_request_error couvre les valeurs non valides, le nombre et la combinaison des médias (par exemple première et dernière images avec des références, ou image_urls avec image_with_roles), une durée, des dimensions, un rapport ou une fréquence d'images de vidéo de référence ou une durée d'audio de référence hors limites, les règles du type de tâche et du montage vidéo, les valeurs de output_format, les règles du brouillon et de la vidéo finale, et les paramètres non pris en charge comme negative_prompt ou camera_fixed. 400 input_video_probe_failed signifie qu'une vidéo de référence est inaccessible ou que sa durée ne peut pas être lue. 402 payment_required signifie un solde insuffisant ; avec duration -1 ou un montage vidéo, 30 secondes sont réservées. 400 nsfw_content_detected signifie que nsfw_check a détecté un contenu ; message indique les catégories détectées. 503 draft_channel_unavailable ou draft_task_unavailable signifie que les brouillons sont temporairement indisponibles : réessayez plus tard ou créez un nouveau brouillon.

Un clip prend généralement 1 à 3 minutes : interrogez donc la tâche toutes les 5 à 10 secondes. data.status vaut pending, processing, completed ou failed, et data.progress va de 0 à 100. L'URL de la vidéo dans data.result.videos[0].url est stockée chez APIMart et expire 72 heures après la fin : téléchargez-la à temps. Avec return_last_frame: true, data.result.last_frame_url fournit aussi la dernière image de la vidéo au format png. Si une tâche échoue, y compris quand l'enregistrement des médias n'aboutit pas ou que la vérification des dimensions d'image, de la taille de fichier ou de l'encodage échoue pendant la génération, data.error.message indique la raison, data.error.code vaut task_failed et data.cost vaut 0, car le montant réservé est remboursé automatiquement.

L'apimart-zoe API est facturée à la seconde produite, avec des tarifs pour 480p, 720p, 1080p, 2k et 4k et un tarif distinct pour les requêtes avec vidéo de référence. Si vous fixez duration (4 à 30) ou gardez la valeur par défaut de 5, les secondes demandées sont facturées et ne sont pas ajustées à la durée du clip. Avec duration -1 ou un montage vidéo (omni_reference_task_type: edit), 30 secondes sont préfacturées puis ajustées à la durée réelle du clip, arrondie à la seconde la plus proche ; le montage vidéo utilise le tarif des requêtes avec vidéo de référence. Avec une vidéo de référence, secondes facturées = durée de la vidéo + max(durée totale des vidéos de référence, ⌈durée de la vidéo × 2/3⌉) ; la durée des références est mesurée à l'envoi pour chaque vidéo, additionnée, arrondie à la seconde inférieure et n'est plus ajustée ensuite. Une vidéo finale issue d'un brouillon est facturée en 1080p sur la durée du brouillon (sa durée réelle si le brouillon utilisait -1) et, si le brouillon utilisait une vidéo de référence, compte aussi sa durée. Votre montant reflète la remise de votre niveau d'adhésion ou de votre groupe de compte ; consultez le tableau des tarifs en temps réel de cette page.

Sur APIMart, les deux modèles utilisent POST /v1/videos/generations et GET /v1/tasks/{task_id}, créent des clips de 4 à 30 secondes dans des formats de 21:9 à 9:16, acceptent jusqu'à 30 images, 10 vidéos et 10 clips audio de référence par requête, prennent en charge seed, la génération audio, return_last_frame, output_format et le montage vidéo (omni_reference_task_type: edit), et proposent le passage du brouillon 480p à la vidéo finale 1080p. Les différences : apimart-zoe (ID de modèle apimart-zoe) produit en plus du 2k et du 4k, n'autorise pas les première et dernière images avec des références, exige une image ou une vidéo de référence dès que vous envoyez de l'audio de référence et laisse le modèle décider de l'audio si audio est omis ; chez Seedance 2.5 (seedance-2.5), generate_audio est activé par défaut et l'extension de vidéos (extend) est aussi prise en charge, alors qu'elle n'est pas encore ouverte sur apimart-zoe. Avec une vidéo de référence, les deux modèles ne comptent pas non plus les secondes facturées de la même façon. Les tableaux de comparaison de cette page détaillent chaque différence et les prix actuels à la seconde.

Cela dépend de la résolution et de l'envoi ou non d'une vidéo de référence. La comparaison des prix de cette page affiche les tarifs actuels à la seconde des deux modèles avec et sans vidéo de référence, l'écart en pourcentage et des exemples de coût pour des durées courantes. Avec une vidéo de référence, apimart-zoe ajoute max(secondes totales des références arrondies à l'inférieur, ⌈secondes produites × 2/3⌉) aux secondes produites, tandis que Seedance 2.5 ajoute les secondes de la vidéo de référence : comparez l'exemple qui correspond à votre clip. apimart-zoe propose aussi des paliers 2k et 4k que Seedance 2.5 n'a pas. Les tarifs proviennent de l'API de tarifs d'APIMart et dépendent de votre niveau d'adhésion.

Non. Elle est payante à l'usage et facturée à la seconde produite ; un brouillon et sa vidéo finale sont chacun facturés comme une génération. Les erreurs d'envoi ne sont pas facturées, une requête renvoie 402 si le solde est insuffisant, et les tâches échouées sont remboursées automatiquement, avec data.cost à 0. Votre prix dépend de votre niveau d'adhésion ou de votre groupe de compte ; le tableau des tarifs en temps réel de cette page indique le tarif actuel pour chaque résolution.

Inscrivez-vous sur APIMart, ouvrez la page API Keys de votre tableau de bord et créez une clé, puis envoyez-la sous la forme Authorization: Bearer <key>. La même clé appelle l'apimart-zoe API et les autres modèles d'APIMart, avec un paiement à l'usage et sans abonnement.