Referênciav1.0.0 Estável

API do AI Video to Prompt

Integre capacidades de geração de imagens com IA de alto desempenho. Esta documentação fornece referência completa da API, guias de integração e exemplos de código para ajudar desenvolvedores a criar rapidamente aplicações de geração de imagens com IA.

https://aivideotoprompt.com

Início rápido

Conclua sua primeira chamada à API em apenas duas etapas: envie uma tarefa de geração e, em seguida, consulte o status.

Enviar tarefa

Envie uma requisição POST para o endpoint de geração para obter um ID de tarefa.

Consultar status

Use o ID de tarefa para verificar o progresso até obter a URL da imagem.

Autenticação

Observação: mantenha sua chave de API segura e não a exponha em código do lado do cliente.

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://aivideotoprompt.com/api/generate

Cria uma nova tarefa de geração de imagens. Este ponto de acesso é assíncrono e retorna um task_id e o estado inicial; chame /api/status para obter as imagens finais.

Este ponto de acesso retorna task_id imediatamente. Consulte /api/status periodicamente até o estado ser SUCCESS para obter as URLs das imagens.

Parâmetros do corpo

Nome do parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	Sim	Prompt de texto para geração (máximo de 1000 caracteres).
`aspect_ratio`	string	Sim	Proporção da imagem gerada. Valores permitidos: 1:1, 4:3, 3:4, 16:9, 9:16.

Resposta (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://aivideotoprompt.com/api/status

Consulta o status de execução e os resultados de uma tarefa.

Parâmetros de consulta

Nome do parâmetro	Obrigatório	Descrição
`task_id`	Sim	O ID retornado ao enviar a tarefa.

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Cobrança

Custo por geração

$0.02 / requisição

Tarefas com falha não são cobradas.

Tratamento de erros

401 Não autorizadoChave de API inválida
402 Pagamento necessárioSaldo insuficiente
429 Excesso de solicitaçõesMuitas requisições

Sobre o AI Video to Prompt

AI Video to Prompt transforma os clipes de referência enviados em listas de planos com tempos e prompts editáveis. Adapte um plano ao modelo de vídeo escolhido ou substitua o sujeito e abra o espaço de vídeo para gerar uma nova versão. A ferramenta de imagem segue o mesmo fluxo, do prompt ao espaço de trabalho, com uma imagem estática.

Z-Image-Turbo — modelo texto-para-imagem de 6B parâmetros, ultrarrápido

Z-Image-Turbo é um modelo texto-para-imagem de 6 bilhões de parâmetros da Tongyi-MAI, criado para workloads em produção em que latência e throughput são críticos. Ele utiliza apenas 8 etapas de amostragem para renderizar uma imagem completa, alcançando latência abaixo de um segundo em GPUs de data center e rodando confortavelmente em muitas placas de vídeo de 16 GB de VRAM para consumidores.

Geração ultrarrápida com qualidade pronta para produção

Enquanto muitos modelos de difusão precisam de dezenas de etapas, o Z-Image-Turbo é agressivamente otimizado em torno de um amostrador de 8 etapas. Isso mantém a inferência extremamente rápida, ao mesmo tempo em que entrega imagens fotorrealistas e texto confiável na imagem, tornando-o uma ótima opção para produtos interativos, dashboards e backends em larga escala — não apenas jobs em lote offline.

Por que as imagens ficam tão boas?

Saída fotorrealista em alta velocidade — Gera imagens de alta fidelidade e realistas que funcionam para fotos de produto, banners de destaque e visuais de interface sem esperas de vários segundos.
Prompts e texto bilíngues — Entende prompts em inglês e chinês e pode renderizar texto multilíngue diretamente na imagem — útil para campanhas globais, pôsteres e capturas de tela.
Baixa latência com poucas etapas — Apenas 8 avaliações de função por imagem oferecem latência extremamente baixa, ideal para chatbots, ferramentas de configuração, assistentes de design e qualquer experiência do tipo “clique → imagem”.
Uso amigável de VRAM — Roda bem em ambientes com 16 GB de VRAM, reduzindo custos de hardware e tornando mais viáveis implantações locais ou na borda.
Escala para geração em massa — Sua eficiência torna viáveis grandes jobs — catálogos, feeds contínuos de imagens ou miniaturas geradas automaticamente — sem estourar o orçamento de computação.
Gerações reprodutíveis — Um parâmetro de semente controlável permite recriar uma imagem anterior ou gerar pequenas variações controladas para segurança de marca e experimentação.

Como usar

promptprompt – descrição em linguagem natural da cena, estilo e qualquer texto na imagem (em inglês ou chinês).
sizesize (largura / altura) – escolha a resolução de saída; suporta imagens quadradas e retangulares em altas resoluções (por exemplo, 1536 × 1536).
seedseed – defina como -1 para resultados aleatórios ou use um inteiro fixo para tornar as saídas reprodutíveis.

Espaço de geração de imagens Imagem para prompt