API de imagem para ativos estáticos
Escolha imagem quando o resultado é um quadro e resolução, referências ou qualidade são os principais controles.
Use a Imya como camada de API para gerar imagens e vídeos, consultar tarefas, calcular créditos em tempo real e entregar arquivos. Os contratos em prévia do GPT Image 2, Seedream 5.0 Pro, Hailuo 2.3 e Seedance 2.0 estão documentados aqui.
Cada página descreve o endpoint disponível, os parâmetros públicos, a resposta de cobrança e o ciclo de vida da tarefa.
Geração por texto ou imagens de referência, créditos por resolução e consulta de tarefas.
Geração por texto e até dez imagens de referência, com controle de proporção, qualidade e formato.
Texto para vídeo e imagem para vídeo, incluindo a variante Fast de menor latência.
Texto ou imagem para vídeo com controles de duração, resolução, proporção e áudio.
Crie uma API Key nas configurações.
Envie uma solicitação com model e prompt.
Consulte o endpoint da tarefa até ela concluir ou falhar.
Salve no aplicativo a URL de imagem ou vídeo retornada.
Guia de integração de APIs de modelos de IA
Decida primeiro se o produto retorna imagem ou vídeo e depois os controles necessários. Os quatro modelos Imya compartilham autenticação e tarefas assíncronas, permitindo reutilizar infraestrutura.
Escolha imagem quando o resultado é um quadro e resolução, referências ou qualidade são os principais controles.
Escolha vídeo para movimento; valide texto ou imagem inicial, duração e resolução e prepare uma fila separada.
A referência de cada modelo define os campos; use credits_reserved da resposta como custo exato.
Para prompts ou até 16 referências e saídas 1K, 2K e 4K.
Ler GPT Image 2 APIPara até 10 referências e qualidade basic ou high.
Ler Seedream 5.0 Pro APIPara texto ou imagem em vídeo de 6 ou 10 segundos, Standard ou Fast.
Ler Hailuo 2.3 APIPara texto ou imagem em vídeo em 480p, 720p ou 1080p e 4 a 15 segundos.
Ler Seedance 2.0 APIMantenha a API Key fora do navegador e centralize criação, consulta, cobrança e status no backend.
Envie Bearer token e Idempotency-Key única. Repetir a mesma chave e corpo retorna a tarefa original.
credits_reserved é descontado na aceitação. Registre o valor e não replique preços no cliente.
Salve id e consulte GET /v1/tasks/{id} a cada 5 segundos ou mais até pending, processing, succeeded ou failed.
Após 30 minutos uma tarefa inacabada falha. refund_pending indica liquidação e credits_refunded confirma o reembolso único.
Conclua estes controles antes do tráfego real.
Respostas comuns aos quatro modelos.
Comece pelo modelo que produz o primeiro fluxo e adicione outro quando o ciclo estiver confiável.
Sim, com a mesma Idempotency-Key e corpo; a tarefa original volta sem nova cobrança.
credits_reserved é descontado na aceitação e falhas elegíveis são reembolsadas uma vez com a validade original.
7 dias em contas grátis e até 30 em contas pagas ativas ou Lifetime.
Abra a referência mais próxima do caso e conclua criar, consultar e obter resultado antes de adicionar outro modelo.