Documentação

Introdução

Leva a geração de imagem e vídeo para o teu próprio produto.

A API expõe exatamente o que o estúdio usa: os mesmos modelos, o mesmo cálculo de custo, a mesma cadeia de renderização. Aquilo que consegues gerar no navegador também geras com uma chave, e os resultados vão parar igualmente à tua biblioteca de recursos.

O que podes fazer

Texto / imagem para imagemImagens de referência, proporções e níveis de qualidade 1K/2K/4K. Até 4 imagens por pedido.
Texto / imagem para vídeoPrimeiro e último fotograma, imagens de referência e várias resoluções. A duração é ajustada ao nível escolhido.
Escolhe o modeloTodos os modelos disponibilizados são invocáveis. Consulta /v1/models para ids e preços atuais.
Verifica o saldoLê os créditos disponíveis a qualquer momento para que um lote não pare a meio.

Desenho da API

O formato segue a OpenAI: as chaves começam por sk-, viajam em Authorization: Bearer, os caminhos ficam sob /v1 e as falhas devolvem um objeto error de estrutura fixa. Se já usaste o SDK da OpenAI, trocar o URL base leva-te quase lá.

A geração de imagens aceita as duas formas. Por predefinição é síncrona: a chamada espera até a imagem estar pronta e responde com a mesma estrutura do endpoint images/generations da OpenAI, pelo que o SDK da OpenAI e os gateways de reencaminhamento podem ligar a plataforma como fornecedor compatível sem mais nada. Com async: true passas ao fluxo assíncrono: recebes de imediato um id de tarefa e lês o resultado em GET /v1/tasks/{id}.

O vídeo é apenas assíncrono: renderizar demora minutos e esperar de forma síncrona deixaria a ligação colada ao tempo limite do gateway, com uma nova tentativa a cobrar duas vezes. Em lotes, muita concorrência ou latência sensível, usa também o fluxo assíncrono para imagens.

URL base de todos os endpoints: https://open.pikpikgo.com/v1

Passos seguintes