BennyKok/omg.dev

Gerar imagens e vídeos

Essas ferramentas gastam os créditos omg do usuário. 1 crédito equivale a US$ 1. Trate cada chamada como uma compra.

Quando usar

• Use-as quando a tarefa precisar de nova mídia visual: uma imagem hero, um ícone, um logotipo, uma ilustração, um clipe curto.
• Não as use para capturar tela, fazer gráficos ou qualquer coisa que possa ser desenhada com código ou SVG.
• Não gere muitas variações "para garantir". Crie uma, mostre-a e pergunte se o usuário quer outra.

Regras

1. Deixe model de fora, a menos que a solicitação exija uma aparência específica. Sem modelo, o roteador escolhe o modelo mais barato e adequado para a tarefa ("auto") e nomeia-o no resultado.

2. Cada resultado contém model e costUsd. Informe ambos ao usuário em sua resposta, por exemplo "Gerado com flux-schnell por $0,003."

3. Uma chamada é recusada acima do limite por chamada (US$ 1,00 padrão) ou quando o limite diário (US$ 25,00 padrão, dia UTC) é esgotado. O erro informa quanto resta. Não contorne o limite. Informe o usuário.

4. Se o resultado tiver pending: true, chame omg_media_job com o jobId. Não gere novamente; isso cobraria duas vezes.

5. Se o erro disser que os créditos acabaram, informe o usuário para adicionar créditos em omg.dev. Não tente novamente.

6. Exiba imagens com omg_display_image. Exiba vídeos com omg_display_video.

7. Um vídeo para o aplicativo iPhone deve ter menos de 6 MB, H.264, com faststart. As ferramentas já remuxam os downloads para faststart. Verifique o tamanho. Se for maior, recodifique e mantenha o 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
   

Escolhendo um modelo

• Normalmente, não passe model. O roteador escolhe o modelo mais barato e adequado para a tarefa e nomeia-o no resultado.
• Passe model apenas quando a solicitação exigir uma aparência específica, por exemplo, texto legível, SVG ou vídeo da melhor qualidade.
• omg_media_models lista os principais modelos com preços. omg_media_models {all: true, q: "kling"} pesquisa na lista completa.
• Um modelo fora da lista principal é precificado antes de ser executado. Se não puder ser precificado, a chamada é recusada; escolha outro.

O vídeo leva de 30 segundos a 5 minutos. As imagens levam de 3 a 20 segundos.

Campos

• Os campos amigáveis mapeiam para a entrada do provedor: prompt, aspectRatio para aspect_ratio, durationSeconds para duration, resolution para resolution.
• Coloque qualquer outro campo do provedor em input, por exemplo {"generate_audio": false} ou {"quality": "high"}.
• Os arquivos são salvos em ~/omg-media/<data>/<jobId>-<n>.<ext>, a menos que você passe outputPath.

Modelos 3D

Use omg_generate_3d para transformar uma imagem de um objeto em um arquivo GLB. Forneça imageUrl ou imagePath para uma imagem local com menos de 600 KB. Use um objeto em um fundo simples.

• tripo3d/h3.1/image-to-3d é o padrão. Custa $0,30. Use {face_limit: 8000} para uma malha pronta para jogos.
• fal-ai/hyper3d/rodin/v2.5/fast custa $0,10. Use para rascunhos rápidos.
• fal-ai/trellis-2 custa $0,25 a $0,35, dependendo da resolution.
• fal-ai/hunyuan3d-v3/image-to-3d custa $0,375. {generate_type: "LowPoly"} custa $0,45.
• PBR, visualizações extras e geometria detalhada custam mais. O orçamento os inclui.