Imagens
Criar variação de imagem
Cria uma variação de uma imagem fornecida
Visão geral
Este endpoint é mantido para clientes legacy de variações compatíveis com OpenAI. Ele não é o caminho recomendado para workflows image-to-image atuais; use /v1/images/edits com gpt-image-2 ou /v1/images/generations com um modelo image-to-image como nano-banana-pro quando possível. Requer multipart/form-data.
Corpo da requisição
Timeout de solicitações síncronas: alguns provedores de imagem roteados retornam a imagem final inline e aguardam a geração terminar. Solicitações de alta resolução ou alta qualidade podem levar perto de um minuto ou mais, então configure o timeout do seu cliente HTTP para pelo menos 120s. Se a resposta de criação incluir status: "pending", task_id ou poll_url, siga o poll_url retornado.
Imagem de origem multipart. O arquivo e o corpo completo da requisição não devem exceder 50 MiB cada. Os formatos e dimensões dependem do modelo; seus detalhes atuais devem listar explicitamente /v1/images/variations.
Identificador de modelo obrigatório para rotas legacy compatíveis com variações. Não há padrão implícito; para workflows image-to-image atuais, prefira /v1/images/edits ou /v1/images/generations com um modelo atual.
1Número de imagens a gerar (1-10, dependendo do modelo).
O tamanho das imagens geradas para rotas legacy compatíveis com variações. Os valores compatíveis dependem do modelo selecionado.
O formato em que as imagens geradas são retornadas. Deve ser url ou b64_json.
Um identificador único representando seu usuário final para monitoramento de abuso.
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 de 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 de compatibilidade legacy. Ele não está incluído no catálogo atual de modelos de imagem recomendados. 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