Pular para o conteúdo principal

Glossário para desenvolvedores

Entenda a API antes de integrar.

Definições práticas para escolher o modelo, gerenciar estados, validar callbacks, estimar o uso e proteger os arquivos dos usuários.

01

API de geração assíncrona

Definição

Uma API que aceita uma solicitação de mídia, retorna um taskId durável e termina fora da requisição HTTP original.

Nota de implementação

Salve o taskId antes do polling ou Webhook. queued e running estão em andamento; succeeded, failed e expired são terminais. Uma tarefa aceita não pode ser cancelada.

Página relacionada →
02

Chave de idempotência

Definição

Um identificador do cliente que liga reenvios a uma tarefa lógica e evita trabalho faturável duplicado.

Nota de implementação

Reutilize a chave apenas para a mesma solicitação validada, salve-a com a tarefa e devolva o resultado original na repetição.

Página relacionada →
03

Assinatura de Webhook

Definição

Um valor criptográfico para comprovar que o callback veio da API e não foi alterado.

Nota de implementação

Valide o corpo bruto, rejeite timestamps antigos e deduplique eventId antes de mudar tarefa ou cobrança.

Página relacionada →
04

Esquema do modelo

Definição

A especificação legível por máquina que descreve campos, tipos, limites, padrões e formato de saída.

Nota de implementação

Gere formulários e validação do servidor a partir do esquema publicado e registre a versão usada em cada tarefa.

Página relacionada →
05

Imagem de referência

Definição

Uma entrada que orienta identidade, composição, estilo ou movimento numa geração de imagem ou vídeo.

Nota de implementação

Registre origem e consentimento e valide o formato; uma referência não autoriza reproduzir uma pessoa real.

Página relacionada →
06

Cobrança por uso

Definição

O custo é calculado conforme o uso real. Cada modelo informa a unidade aplicável, como imagem, segundo de saída, megapixel, token ou solicitação.

Nota de implementação

Mostre a unidade e a estimativa antes de executar; mínimos, duração e quantidade de saídas podem alterar o total.

Página relacionada →
07

Modelo de IA com menos filtros de conteúdo

Definição

Uma opção de modelos específicos com menos filtros. O rótulo é informação de produto, não aprovação da plataforma.

Nota de implementação

Antes de enviar, implemente no seu aplicativo os controles de idade, consentimento, pessoas reais e jurisdição exigidos para seus usuários.

Página relacionada →

Pronto para integrar um modelo?

Confira entradas, exemplos e preços atuais e veja a estimativa das suas configurações antes de executar.