Imagens
Criar Variação de Imagem
Cria uma variação de uma determinada imagem
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.
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.
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.
1Número de imagens a serem geradas (1-10, dependendo do modelo).
Tamanho da imagem gerada. Os valores suportados dependem do modelo selecionado.
O formato no qual as imagens geradas são retornadas. Deve ser url ou b64_json.
Um identificador exclusivo representando seu usuário final para monitoramento de abusos.
Resposta
Timestamp Unix de quando as imagens foram criadas.
Array de variações de imagem geradas.
Cada objeto contém:
url(string): URL da imagem da variação (se response_format forurl)b64_json(string): Imagem codificada em Base64 (se response_format forb64_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
{
"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 Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Cabeçalhos
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