BennyKok/omg.dev

Generar imágenes y videos

Estas herramientas consumen los créditos omg del usuario. 1 crédito equivale a 1 USD. Trata cada llamada como una compra.

Cuándo usarlas

• Úsalas cuando la tarea necesite material visual nuevo: una imagen heroica, un icono, un logotipo, una ilustración, un clip corto.
• No las uses para capturas de pantalla, gráficos o cualquier cosa que puedas dibujar con código o SVG.
• No generes muchas variaciones "por si acaso". Genera una, muéstrala y pregunta al usuario si quiere otra.

Reglas

1. Omite el campo model a menos que la solicitud requiera un aspecto específico. Sin modelo, el enrutador selecciona el modelo curado más económico para la tarea ("auto") y lo nombra en el resultado.

2. Cada resultado incluye model y costUsd. Informa ambos al usuario en tu respuesta, por ejemplo: "Generado con flux-schnell por $0.003".

3. Una llamada se rechaza si supera el límite por llamada ($1.00 por defecto) o cuando se agota el límite diario ($25.00 por defecto, día UTC). El error indica cuánto queda. No intentes eludir el límite. Informa al usuario.

4. Si el resultado tiene pending: true, llama a omg_media_job con el jobId. No generes de nuevo; eso cobraría dos veces.

5. Si el error indica que los créditos se agotaron, dile al usuario que agregue créditos en omg.dev. No reintentes.

6. Muestra imágenes con omg_display_image. Muestra videos con omg_display_video.

7. Un video para la aplicación de iPhone debe tener menos de 6 MB, ser H.264 con faststart. Las herramientas ya reempaquetan las descargas con faststart. Verifica el tamaño. Si es mayor, reconviértelo y conserva el original:

   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
   

Cómo elegir un modelo

• Generalmente no pases ningún model. El enrutador selecciona el modelo más económico adecuado para la tarea y lo nombra en el resultado.
• Pasa model solo cuando la solicitud requiera un aspecto específico, por ejemplo texto legible, SVG o video de máxima calidad.
• omg_media_models lista los mejores modelos con sus precios. omg_media_models {all: true, q: "kling"} busca en la lista completa.
• Un modelo que no esté en la lista principal se cotiza antes de ejecutarse. Si no se puede cotizar, la llamada se rechaza; elige otro.

Los videos tardan de 30 segundos a 5 minutos. Las imágenes tardan de 3 a 20 segundos.

Campos

• Los campos descriptivos se asignan a la entrada del proveedor: prompt, aspectRatio a aspect_ratio, durationSeconds a duration, resolution a resolution.
• Coloca cualquier otro campo del proveedor en input, por ejemplo {"generate_audio": false} o {"quality": "high"}.
• Los archivos se guardan en ~/omg-media/<fecha>/<jobId>-<n>.<ext> a menos que pases outputPath.

Modelos 3D

Usa omg_generate_3d para convertir una imagen de un objeto en un archivo GLB. Proporciona imageUrl o imagePath para una imagen local de menos de 600 KB. Usa un solo objeto sobre un fondo simple.

• tripo3d/h3.1/image-to-3d es el predeterminado. Cuesta $0.30. Usa {face_limit: 8000} para un modelo listo para juegos.
• fal-ai/hyper3d/rodin/v2.5/fast cuesta $0.10. Úsalo para borradores rápidos.
• fal-ai/trellis-2 cuesta entre $0.25 y $0.35, según la resolution.
• fal-ai/hunyuan3d-v3/image-to-3d cuesta $0.375. {generate_type: "LowPoly"} cuesta $0.45.
• PBR, vistas adicionales y geometría detallada cuestan más. La cotización los incluye.