Imagens

Criar Variação de Imagem

Cria uma variação de uma determinada imagem

POST
/v1/images/variations

Visão Geral

Este endpoint oferece suporte a clientes existentes do OpenAI Variations. Para novos recursos image-to-image, use /v1/images/edits ou /v1/images/generations com um modelo image-to-image atual. As requisições usam multipart/form-data.

Corpo da Requisição

Este endpoint é síncrono: a resposta traz a imagem final e nunca uma tarefa. Defina o timeout do seu cliente HTTP para pelo menos 120s.

imagefileobrigatório

Imagem de origem em multipart. O arquivo e o corpo completo da requisição devem ter, cada um, no máximo 50 MiB (uploads maiores retornam 413). Os formatos e dimensões suportados dependem do modelo selecionado. Apenas um modelo cujos detalhes mapeiem image-to-image para /v1/images/variations é aceito; qualquer outro modelo retorna 400.

modelstringobrigatório

ID do modelo. Este endpoint não possui um modelo padrão. Os exemplos usam o placeholder your-legacy-variation-model: substitua-o por um modelo cujos detalhes listem este endpoint.

nintegerpadrão: 1

Número de imagens a serem geradas (1-10, dependendo do modelo).

sizestring

Tamanho da imagem gerada. Os valores suportados dependem do modelo selecionado.

response_formatstring

O formato no qual as imagens geradas são retornadas. Deve ser url ou b64_json.

userstring

Um identificador exclusivo representando seu usuário final para monitoramento de abusos.

Resposta

createdinteger

Timestamp Unix de quando as imagens foram criadas.

dataarray

Array de variações de imagem geradas.

Cada objeto contém:

  • url (string): URL da imagem da variação (se response_format for url)
  • b64_json (string): Imagem codificada em Base64 (se response_format for b64_json)

Requisição

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Resposta

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Observações

Este é um endpoint legado de compatibilidade. Ele não está incluído no catálogo de modelos de imagem recomendados atualmente. Para novas integrações, use /v1/images/edits com gpt-image-2, ou /v1/images/generations com operation: "image-to-image" e um modelo image-to-image atual.

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Corpo da requisição

multipart/form-data

Resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json