Como chamar a API OutfitAnyone-Plus - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

O Aitryon-plus oferece maior nitidez de imagem, melhor textura de tecido e logotipos mais precisos, mas exige um tempo de processamento maior.

ImportanteEste documento se aplica apenas à região China (Beijing) — utilize uma chave de API dessa região.

Capacidades

Prova de múltiplas peças

Prova apenas da parte superior: Gera uma parte inferior aleatória ou mantém a original.
Prova apenas da parte inferior: Gera uma parte superior aleatória ou mantém a original.
Combinação de parte superior e inferior: Substitui o look completo.
Prova de vestido ou macacão

Controle refinado

Rosto: Mantém o original ou gera um rosto aleatório.
Resolução: Especifique as dimensões de saída ou use as originais.

Visão geral

Modelo	Preço	Limite de taxa (compartilhado pela conta Alibaba Cloud e usuários RAM)
		RPS da API de envio de tarefas	Tarefas simultâneas
aitryon-plus	$0,071677/imagem	10	5

Exemplos

Entrada: Imagem de pessoa de corpo inteiro e frente	Entrada: Imagem da peça em flat-lay	Saída: Imagem gerada da prova virtual
	Imagem da parte superior em flat-lay
	Imagem da parte inferior em flat-lay

Requisitos das imagens de entrada

Antes de chamar a API, verifique se as imagens atendem aos seguintes requisitos.

Requisitos da imagem da pessoa

Requisito	Detalhes
Imagem	- Tamanho do arquivo: 5 KB a 5 MB - Resolução: Largura e altura devem estar entre 150 e 4096 pixels. - Formato: JPG, JPEG, PNG, BMP e HEIC. - Link: A imagem deve estar em uma URL HTTP ou HTTPS publicamente acessível. Caminhos locais não são suportados.
Pessoa	- Diversidade: Suporta pessoas de diferentes gêneros, tons de pele e idades (a partir de 6 anos). - Pose: Foto de corpo inteiro e de frente com boa iluminação. As mãos devem estar totalmente visíveis. Evite braços cruzados ou obstruções. - Quantidade: A imagem deve conter apenas uma pessoa completa.

Imagens válidas de pessoa

Imagens inválidas de pessoa

Várias pessoas	Não é uma foto de corpo inteiro e de frente (evite fotos de lado, sentadas, deitadas ou meio corpo)	Pessoa ou roupa obstruída (evite segurar objetos, bolsas, etc.)	Iluminação ruim ou imagem desfocada

Requisitos da imagem da peça

Requisito

Detalhes

Imagem

- Tamanho do arquivo: 5 KB a 5 MB - Resolução: Largura e altura devem estar entre 150 e 4096 pixels. - Formato: JPG, JPEG, PNG, BMP e HEIC. - Link: A imagem deve estar em uma URL HTTP ou HTTPS publicamente acessível. Caminhos locais não são suportados.

Peça

- Tipo: Suporta partes superiores, inferiores e vestidos individuais. Também suporta ternos e combinações de parte superior e inferior. - Categoria: Suporta categorias comuns de vestuário. Não suporta roupas íntimas, vestidos de noiva ou trajes étnicos especiais. - Apresentação: - Peça única: Foto em flat-lay com apenas uma peça. - Sem dobras ou obstruções: Estendida, livre de amassados. - Fundo simples e limpo: Cor uniforme, sem iluminação complexa ou sombras. - Proporção grande da peça na imagem: Preencha o quadro. Espaço em branco excessivo reduz a qualidade.

Imagens válidas de peças

Parte superior
Parte inferior
Vestido/Macacão

Imagens inválidas de peças

Múltiplas peças	Não é uma foto frontal	Dobrada ou obstruída	Peça amassada

Pré-requisitos

Get an API key e set the API key as an environment variable.

HTTP

A API utiliza um fluxo de trabalho assíncrono:

Criar tarefa: Envie uma solicitação de geração de imagem e receba um task_id.
Consultar resultado: Verifique o status da tarefa com o task_id até a conclusão e recupere o resultado.

Etapa 1: Criar uma tarefa

Envie uma requisição POST para criar uma tarefa de prova virtual.

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis

Substitua {WorkspaceId} pelo seu workspace ID real.

Este modelo possui um tempo de processamento longo, portanto as tarefas usam envio assíncrono. Após a criação, o sistema retorna um task_id . Consulte os resultados dentro de 24 horas .

Parâmetros da requisição

Campo	Tipo	Localização	Obrigatório	Descrição	Exemplo
Content-Type	String	Header	Sim	Tipo da requisição: `application/json`.	`application/json`
Authorization	String	Header	Sim	Formato da chave de API: `Bearer sk-xxxx`.	`Bearer sk-xxxx`
X-DashScope-Async	String	Header	Sim	Valor fixo: `enable` (envio assíncrono).	`enable`
model	String	Body	Sim	Modelo a ser chamado.	`aitryon-plus`
input.person_image_url	String	Body	Sim	URL de imagem de pessoa publicamente acessível (ou get a temporary URL): - Tamanho do arquivo: 5 KB a 5 MB - Resolução: 150-4096 pixels (largura e altura) - Formatos: JPG, JPEG, PNG, BMP, HEIC - Deve conter exatamente uma pessoa completa - Apenas URLs HTTP/HTTPS (sem caminhos locais) <...... Baixe imagens de pessoa de referência aqui.	`http://aaa/1.jpg`
input.top_garment_url	String	Body	Não	URL de peça superior ou vestido publicamente acessível (ou get a temporary URL): - Tamanho do arquivo: 5 KB a 5 MB - Resolução: 150-4096 pixels (largura e altura) - Formatos: JPG, JPEG, PNG, BMP, HEIC - Imagem em flat-lay: apenas uma peça, totalmente visível, fundo limpo, espaço em branco mínimo - Apenas URLs HTTP/HTTPS (sem caminhos locais) Consulte Garment image requirements para exemplos. <...... - Forneça pelo menos um entre `top_garment_url` ou `bottom_garment_url`. - Se omitido, gera uma parte superior aleatória. - Para vestido/macacão, passe a URL aqui e omita `bottom_garment_url`.	`http://aaa/2.jpg`
input.bottom_garment_url	String	Body	Não	URL de peça inferior publicamente acessível (ou get a temporary URL): - Tamanho do arquivo: 5 KB a 5 MB - Resolução: 150-4096 pixels (largura e altura) - Formatos: JPG, JPEG, PNG, BMP, HEIC - Imagem em flat-lay: apenas uma peça, totalmente visível, fundo limpo, espaço em branco mínimo - Apenas URLs HTTP/HTTPS (sem caminhos locais) Consulte Garment image requirements para exemplos. - Forneça pelo menos um entre `top_garment_url` ou `bottom_garment_url`. - Se omitido, gera uma parte inferior aleatória.	`http://aaa/3.jpg`
parameters.resolution	Int	Body	Não	Predefinição de resolução da imagem de saída. Valores recomendados: - `-1` (padrão): Mesmas dimensões da imagem da pessoa de entrada. - `1024`: 576x1024 - `1280`: 720x1280 A API pode aceitar outros valores, mas estes valores recomendados fornecem os melhores resultados.	`-1`
parameters.restore_face	Bool	Body	Não	Define se deve preservar o rosto da imagem da pessoa. - `true` (padrão): Mantém o rosto original. - `false`: Gera um novo rosto aleatório.	`true`

Parâmetros da resposta

Campo	Tipo	Descrição	Exemplo
output.task_id	String	ID único da tarefa assíncrona.	`a8532587-fa8c-4ef8-82be-0c46b17950d1`
output.task_status	String	Status da tarefa após o envio.	`PENDING`
request_id	String	ID único desta requisição.	`7574ee8f-38a3-4b1e-9280-11c33ab46e51`

Exemplos de requisição

Provar uma parte superior

Provar uma parte superior: Passe top_garment_url da peça superior desejada. O modelo de IA gera a parte inferior aleatoriamente.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Manter a parte inferior original da pessoa: Este processo envolve duas etapas:
1. Chame a OutfitAnyone - Image Segmentation API para obter a URL da imagem da parte inferior da pessoa.
2. Chame a API de prova virtual deste tópico, passando top_garment_url da peça superior desejada e bottom_garment_url obtida na segmentação.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg",
        "bottom_garment_url": "Image URL from the Image Segmentation API output"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Provar uma parte inferior

Provar uma parte inferior: Passe bottom_garment_url da peça inferior desejada. O modelo de IA gera a parte superior aleatoriamente.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Manter a parte superior original da pessoa: Este processo envolve duas etapas:
1. Chame a OutfitAnyone - Image Segmentation API para obter a URL da imagem da parte superior da pessoa.
2. Chame a API de prova virtual deste tópico, passando top_garment_url obtida na segmentação e bottom_garment_url da peça inferior desejada.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "Image URL from the Image Segmentation API output",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Provar parte superior e inferior

Passe top_garment_url para a parte superior e bottom_garment_url para a parte inferior.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Provar um vestido ou macacão

Para vestido ou macacão, passe apenas top_garment_url.

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/odngby/dress.jpg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Exemplos de resposta

Resposta bem-sucedida

Salve o task_id para consultar o status e o resultado da tarefa.

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

Resposta de erro

Falha na criação da tarefa. Consulte Error codes para resolver o problema.

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Etapa 2: Consultar o resultado pelo ID da tarefa

Use o task_id da Etapa 1 para enviar uma requisição GET. Substitua {task_id} na URL pelo ID real da tarefa.

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

Substitua {WorkspaceId} pelo seu workspace ID real.

Parâmetros da requisição

Campo	Tipo	Localização	Obrigatório	Descrição	Exemplo
Authorization	String	Header	Sim	Formato da chave de API: `Bearer sk-xxx`.	`Bearer sk-xxx`
task_id	String	URL Path	Sim	O ID da tarefa a ser consultada.	`a8532587-fa8c-4ef8-82be-0c46b17950d1`

Parâmetros da resposta

Campo	Tipo	Descrição	Exemplo
output.task_id	String	O ID da tarefa consultada.	`a8532587-fa8c-4ef8-82be-0c46b17950d1`
output.task_status	String	O status da tarefa. Valores possíveis: - PENDING - PRE-PROCESSING - RUNNING - POST-PROCESSING - SUCCEEDED - FAILED - UNKNOWN: A tarefa não existe ou seu status é desconhecido. - CANCELED	`SUCCEEDED`
output.image_url	String	URL da imagem gerada da prova virtual. Válida por 24 horas — baixe prontamente.	`https://.../result.jpg?Expires=xxx`
output.submit_time	String	Horário de envio da tarefa.	`2024-07-30 15:39:39.918`
output.scheduled_time	String	Horário de início da execução da tarefa.	`2024-07-30 15:39:39.941`
output.end_time	String	Horário de conclusão da tarefa.	`2024-07-30 15:39:55.080`
output.code	String	Código de erro (retornado apenas em caso de falha).	`InvalidParameter`
output.message	String	Detalhes do erro (retornado apenas em caso de falha).	`The request is missing required parameters or in a wrong format`
usage.image_count	Int	Número de imagens geradas.	`1`
request_id	String	ID único desta requisição.	`7574ee8f-38a3-4b1e-9280-11c33ab46e51`

Exemplo de requisição

Substitua 86ecf553-d340-4e21-xxxxxxxxx pelo ID real da tarefa.

curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Os resultados das tarefas podem ser consultados por 24 horas após a criação, sendo removidos automaticamente depois disso.

Exemplos de resposta

Resposta bem-sucedida

Os dados da tarefa são mantidos por 24 horas e depois removidos. Baixe a imagem prontamente.

{
    "request_id": "98d46cd0-1f90-9231-9a6c-xxxxxx",
    "output": {
        "task_id": "15991992-1487-40d4-ae66-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-06-30 14:37:53.838",
        "scheduled_time": "2025-06-30 14:37:53.858",
        "end_time": "2025-06-30 14:38:11.472",
        "image_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/tryon.jpg?Expires=xxx"
    },
    "usage": {
        "image_count": 1
    }
}

Resposta com falha

{
    "request_id": "6bf4693b-c6d0-933a-b7b7-xxxxxx",
    "output": {
        "task_id": "e32bd911-5a3d-4687-bf53-xxxxxx",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The request is missing required parameters xxxxx"
    }
}

Códigos de erro

Para códigos de status gerais, consulte Error codes.

Os seguintes códigos de erro são específicos do modelo OutfitAnyone-Plus:

Código de retorno HTTP	code	message	Descrição
400	InvalidParameter	The request is missing required parameters or has an incorrect format. Check the parameters in your request.	Um parâmetro obrigatório está ausente ou o formato está incorreto. Verifique se o corpo da requisição está em conformidade com a especificação da API.
400	InvalidParameter	Download the media resource timed out during the data inspection process.	O download da imagem expirou. Possíveis causas e soluções: - Problema de rede: A conexão de rede entre o servidor e o service Alibaba Cloud Model Studio está indisponível. Verifique a conexão de rede. - URL interna do OSS: O service Alibaba Cloud Model Studio não consegue acessar URLs internas. Use uma URL pública do OSS. - Recurso fora da China continental: O acesso à rede transfronteiriça é instável. Use um service de armazenamento na China continental.
400	InvalidURL	The request URL is invalid. Check that the URL is available and the image format is one of the following: JPEG, JPG, PNG, BMP, or WEBP.	A URL da imagem é inválida. Verifique se a URL é publicamente acessível e se o formato da imagem atende aos requisitos.
400	InvalidPerson	The input image does not contain a person or contains multiple people. Upload an image that contains only one person.	A imagem da pessoa não atende aos requisitos. Certifique-se de que a imagem de entrada contenha exatamente uma pessoa completa.
400	InvalidGarment	A garment image is missing. Provide an image for at least a top or bottoms.	Uma imagem de peça está ausente. Forneça pelo menos uma imagem: parte superior (`top_garment_url`) ou inferior (`bottom_garment_url`).
400	InvalidInputLength	The image resolution is invalid. Make sure that the longest side of the image is less than 4096 pixels, the shortest side is greater than 150 pixels, and the file size is between 5 KB and 5 MB.	As dimensões da imagem ou o tamanho do arquivo não atendem aos requisitos. Consulte a seção Requisitos das imagens de entrada.

Perguntas frequentes

Como preparar fotos de pessoa e imagens de peças

Por que imagens de peças em flat-lay são obrigatórias? Imagens em flat-lay fornecem a visão mais clara do corte, padrão e silhueta da peça. Isso ajuda a IA a compreender com precisão a estrutura da roupa e gerar um resultado de prova virtual mais ajustado e realista.
E se eu não tiver uma imagem da peça em flat-lay? Coloque a peça estendida sobre um fundo limpo, como um chão ou parede, e fotografe-a de cima. Alternativamente, tire uma foto frontal de uma pessoa ou manequim vestindo a peça. Certifique-se de que a roupa esteja totalmente visível, esticada e sem obstruções.
Como escolher uma foto de pessoa adequada? Escolha uma foto clara, frontal e de corpo inteiro. A pessoa deve usar roupas simples e justas ao corpo, como camiseta e shorts. Evite vestidos longos, roupões de mangas largas ou várias camadas. Garanta que as mãos e os pés da pessoa estejam visíveis e não bloqueados por acessórios como bolsas ou guarda-chuvas.
E se eu não tiver uma foto de pessoa adequada? Fotos de pessoa de referência que atendem aos requisitos estão disponíveis para download. Clique aqui para baixá-las.

Resultados insatisfatórios

Por que a imagem gerada tem baixa qualidade ou falta de detalhes? A causa mais comum é uma imagem de peça de entrada de baixa qualidade. Certifique-se de que a imagem da peça tenha alta resolução e esteja completa. Detalhes não devem ser perdidos devido a dobras ou ângulos ruins da câmera. Entradas de alta qualidade produzem saídas de alta qualidade.

Uso dos recursos

Como gero uma imagem de prova virtual para vestido ou macacão? Passe a URL da imagem do vestido ou macacão no campo input.top_garment_url. Deixe o campo input.bottom_garment_url vazio ou omita-o da requisição.