Générer des images et des vidéos
Ces outils consomment les crédits omg de l'utilisateur. 1 crédit = 1 USD. Traitez chaque appel comme un achat.
Quand les utiliser
- Utilisez-les quand la tâche nécessite un nouveau média visuel : une image hero, une icône, un logo, une illustration, un court clip.
- Ne les utilisez pas pour une capture d'écran, un graphique, ou tout ce que vous pouvez dessiner avec du code ou du SVG.
- Ne générez pas plusieurs variantes « pour être sûr ». Faites-en une, montrez-la, et demandez à l'utilisateur s'il en veut une autre.
Règles
-
Laissez
modelde côté, sauf si la demande nécessite un rendu spécifique. Sans modèle, le routeur choisit le modèle le moins cher adapté à la tâche (« auto ») et le nomme dans le résultat. -
Chaque résultat contient
modeletcostUsd. Informez l'utilisateur des deux dans votre réponse, par exemple « Généré avec flux-schnell pour 0,003 $ ». -
Un appel est refusé au-dessus du plafond par appel (1,00 $ par défaut) ou lorsque le plafond quotidien (25,00 $ par défaut, jour UTC) est épuisé. L'erreur indique le montant restant. Ne contournez pas le plafond. Informez l'utilisateur.
-
Si le résultat contient
pending: true, appelezomg_media_jobavec lejobId. Ne générez pas à nouveau ; cela facturerait deux fois. -
Si l'erreur indique que les crédits sont épuisés, dites à l'utilisateur d'ajouter des crédits sur omg.dev. Ne réessayez pas.
-
Affichez les images avec
omg_display_image. Affichez les vidéos avecomg_display_video. -
Une vidéo pour l'application iPhone doit faire moins de 6 Mo, en H.264, avec faststart. Les outils remuxent déjà les téléchargements en faststart. Vérifiez la taille. Si elle est plus grande, ré-encodez et conservez l'originale :
ffmpeg -i in.mp4 -vf scale=480:-2 -c:v libx264 -profile:v main -crf 27 -maxrate 1800k -bufsize 3600k -c:a aac -b:a 96k -movflags +faststart out.mp4
Choix d'un modèle
- En général, ne passez pas de
model. Le routeur choisit le modèle le moins cher adapté à la tâche et le nomme dans le résultat. - Passez
modeluniquement quand la demande nécessite un rendu spécifique, par exemple du texte lisible, du SVG, ou une vidéo de meilleure qualité. omg_media_modelsliste les meilleurs modèles avec leurs prix.omg_media_models {all: true, q: "kling"}recherche dans la liste complète.- Un modèle hors de la liste des meilleurs est tarifé avant d'être exécuté. S'il ne peut pas être tarifé, l'appel est refusé ; choisissez-en un autre.
La vidéo prend de 30 secondes à 5 minutes. Les images prennent de 3 à 20 secondes.
Champs
- Les champs conviviaux correspondent aux entrées du fournisseur :
prompt,aspectRatioversaspect_ratio,durationSecondsversduration,resolutionversresolution. - Placez tout autre champ du fournisseur dans
input, par exemple{"generate_audio": false}ou{"quality": "high"}. - Les fichiers sont enregistrés dans
~/omg-media/<date>/<jobId>-<n>.<ext>sauf si vous passezoutputPath.
Modèles 3D
Utilisez omg_generate_3d pour transformer une image d'un objet en fichier GLB. Donnez imageUrl, ou imagePath pour une image locale de moins de 600 Ko. Utilisez un seul objet sur fond uni.
tripo3d/h3.1/image-to-3dest le modèle par défaut. Il coûte 0,30 $. Utilisez{face_limit: 8000}pour un maillage prêt pour le jeu.fal-ai/hyper3d/rodin/v2.5/fastcoûte 0,10 $. Utilisez-le pour des ébauches rapides.fal-ai/trellis-2coûte de 0,25 $ à 0,35 $, selon laresolution.fal-ai/hunyuan3d-v3/image-to-3dcoûte 0,375 $.{generate_type: "LowPoly"}coûte 0,45 $.- Le PBR, les vues supplémentaires et la géométrie détaillée coûtent plus cher. Le devis les inclut.