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

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 de 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 a estes 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 cada. - 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 (6 anos ou mais). - 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 de 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 cada. - 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 rugas. - 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

Obtenha uma chave de API e defina a chave de API como variável de ambiente.

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 solicitaçã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 ID do workspace 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 solicitação

Campo	Tipo	Localização	Obrigatório	Descrição	Exemplo
Content-Type	String	Header	Sim	Tipo de solicitaçã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 obtenha uma URL temporária): - 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) <...... Nota 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 obtenha uma URL temporária): - 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 Requisitos da imagem da peça para exemplos. Nota - 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 obtenha uma URL temporária): - 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 Requisitos da imagem da peça para exemplos. Nota - 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 Nota 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 exclusivo 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 exclusivo desta solicitação.	`7574ee8f-38a3-4b1e-9280-11c33ab46e51`

Exemplos de solicitação

Provar uma parte superior

Provar uma parte superior: Passe a top_garment_url da peça superior para provar. 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 API de Segmentação de Imagem do OutfitAnyone para obter a URL da imagem da parte inferior da pessoa.
2. Chame a API de prova virtual deste tópico, passando a top_garment_url da peça superior para provar e a 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 a bottom_garment_url da peça inferior para provar. 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 API de Segmentação de Imagem do OutfitAnyone para obter a URL da imagem da parte superior da pessoa.
2. Chame a API de prova virtual deste tópico, passando a top_garment_url obtida na segmentação e a bottom_garment_url da peça inferior para provar.

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 a top_garment_url da parte superior e a bottom_garment_url da 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 a 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 Códigos de erro 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 solicitaçã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 ID do workspace real.

Parâmetros da solicitaçã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	Hora de envio da tarefa.	`2024-07-30 15:39:39.918`
output.scheduled_time	String	Hora de início da execução da tarefa.	`2024-07-30 15:39:39.941`
output.end_time	String	Hora 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 exclusivo desta solicitação.	`7574ee8f-38a3-4b1e-9280-11c33ab46e51`

Exemplo de solicitaçã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 e depois são removidos automaticamente.

Exemplos de resposta

Resposta bem-sucedida

Os dados da tarefa são retidos 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 Códigos de erro.

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 solicitaçã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 pessoas 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, estampa e silhueta da peça. Isso ajuda a IA a entender 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 esticada 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 adequada da pessoa? 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 adequada da pessoa? Fotos de referência de pessoas 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 entrada da peça com baixa qualidade. Certifique-se de que a imagem da peça tenha alta resolução e esteja completa. Os detalhes não devem ser perdidos devido a dobras ou ângulos ruins da câmera. Uma entrada de alta qualidade produz uma saída de alta qualidade.

Uso dos recursos

Como gerar 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 solicitação.