Skip to main content
OutfitAnyone

Referência da API OutfitAnyone-Parsing

O OutfitAnyone-Parsing segmenta áreas de vestuário, como partes superiores, inferiores, vestidos ou macacões, em imagens de modelos ou imagens geradas pelo OutfitAnyone. Use este recurso com o OutfitAnyone para prova virtual parcial ou para obter coordenadas de roupas .

Este documento aplica-se apenas à região China (Beijing). Para usar o modelo, você precisa de uma chave de API da região China (Beijing).

Visão geral

Modelo

Preço

Limite de taxa (compartilhado pela conta e usuários RAM)

RPS para API de envio de tarefas

Tarefas simultâneas

aitryon-parsing-v1

$0,000574/imagem

10

Ilimitado (API síncrona)

Saídas principais

Esta API retorna três saídas principais. O exemplo a seguir de parsing de uma parte superior ilustra o significado e o uso de cada parâmetro.
EntradaSaída
Parâmetro de saídaExemploSignificado e uso
1
  • Imagem do modelo de entrada
  • Defina o tipo de roupa como parte superior
"clothes_type": ["upper"]
crop_img_url
3
  • Imagem da roupa recortada (RGB): Imagem da parte superior do modelo.
  • Usada para prova virtual parcial com o OutfitAnyone.
  • As URLs expiram em 24 horas. Baixe-as imediatamente.
parsing_img_url
4
  • Imagem da roupa segmentada (RGBA): Resultado visualizado do parsing da parte superior.
  • Serve para visualizar e verifique a precisão do parsing.
  • As URLs expiram em 24 horas. Baixe-as imediatamente.
bboxValor bbox: [[331, 239,641,637]]
image
Esta imagem mostra o mapeamento entre o valor bbox e as coordenadas da imagem original. Não é uma saída do modelo.
  • Bounding box: Coordenadas da área retangular da roupa segmentada na imagem de entrada.
    • Formato: [x1, y1, x2, y2] (cantos superior esquerdo e inferior direito).
    • Origem: (0,0) no canto superior esquerdo da imagem de entrada.
  • Aplicável em recursos de frontend, como hotspots de product.

Cenários

Cenário 1: Prova virtual parcial

Objetivo: Substituir parte da roupa do modelo (superior ou inferior) mantendo a outra parte inalterada. Requer o parsing prévio da imagem do modelo.

Exemplo: Manter a parte superior do modelo e substituir a inferior

  1. Faça o parsing da imagem do modelo para extrair a parte superior
    • Chame esta API com a imagem do modelo e defina clothes_type como ["upper"] para extrair a parte superior.
    • A API retorna a imagem da parte superior (crop_img_url).

    Entrada: Imagem do modelo

    Saída: Imagem da roupa segmentada (crop_img_url)

    1

    3

  2. Gere a imagem de prova virtual
    • Consulte a Referência da API OutfitAnyone-Plus.
    • Forneça a imagem do modelo, a imagem da parte superior segmentada e a imagem da parte inferior para gerar o resultado da prova virtual.

    Entrada

    Saída: Imagem de prova virtual

    Imagem do modelo

    Imagem da parte superior

    Imagem da parte inferior

    1

    Mesma da entrada da API de parsing.

    3

    Obtida via crop_img_url da API de parsing.

    2

    Imagem da roupa de substituição.

    5

Cenário 2: Obter coordenadas de roupas específicas

Objetivo: Obter coordenadas bbox de roupas específicas em imagens de modelos ou de prova virtual. Use as coordenadas para rótulos de product ou hotspots interativos.

Exemplo: Obter as coordenadas de uma parte superior

  1. Prepare a entrada: Use uma imagem de modelo ou gerada pelo OutfitAnyone. Consulte a Referência da API OutfitAnyone-Plus.
  2. Faça o parsing para obter coordenadas: Defina o tipo de parsing (por exemplo, ["upper"] para parte superior) para obter o bbox.

    Entrada: Imagem do modelo ou de prova virtual

    Saída: Imagem da roupa segmentada e intervalo de coordenadas

    1

    Parâmetro de solicitação "clothes_type": ["upper"]

    4

    • parsing_img_url: URL do resultado visualizado.

    • bbox: Coordenadas da bounding box (ex.: [[331, 239, 641, 637]]).

Pré-requisitos

A API OutfitAnyone-Parsing aceita apenas chamadas HTTP. Obtenha uma chave de API e defina a chave de API como uma variável de ambiente.

HTTP

Endpoint da solicitação 

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process
Substitua {WorkspaceId} pelo seu ID do workspace real.

Parâmetros da solicitação

Campo

Tipo

Localização

Obrigatório

Descrição

Exemplo

Content-Type

String

Header

Sim

Tipo da solicitação. Defina como application/json.

application/json

Authorization

String

Header

Sim

A chave de API. Formato: Bearer sk-xxxx

Bearer sk-xxxx

model

String

Body

Sim

O modelo a ser chamado. Defina como aitryon-parsing-v1.

aitryon-parsing-v1

input.image_url

String

Body

Sim

URL pública da imagem do modelo para parsing. Obtenha uma URL temporária aqui.

  • Tamanho do arquivo: 5 KB a 5 MB.

  • Dimensões: 150 a 4.096 pixels por lado.

  • Formatos suportados: JPG, PNG, JPEG, BMP e HEIC.

  • A imagem deve conter exatamente uma pessoa completa.

  • Somente links HTTP e HTTPS são suportados. Caminhos locais não são aceitos.

Para exemplos de imagens de modelos, consulte a Referência da API OutfitAnyone-Plus.

http://a/a.jpg

parameters.clothes_type

List[String]

Body

Não

Tipo de roupa para parsing. Padrão: ["upper"] (parte superior).

O tamanho e a ordem da lista determinam a lista de URLs de saída.

Valores válidos:

  • ["upper"]: Parte superior.

  • ["lower"]: Parte inferior.

  • ["dress"]: Vestido, macacão ou traje completo.

  • ["upper", "lower"]: Parte superior e inferior.

["upper"]

Parâmetros de resposta

Campo

Tipo

Descrição

Exemplo

output.parsing_img_url

List[String]

Lista de URLs das áreas segmentadas visualizadas.

A lista corresponde ao tamanho e à ordem de clothes_type. Retorna None/null na posição se a roupa correspondente não for detectada.

Imagem RGBA no formato PNG.

["http://a/a.png"]

[null] ou [None]

output.crop_img_url

List[String]

Lista de URLs das imagens de roupas recortadas.

A lista corresponde ao tamanho e à ordem de clothes_type. Retorna None/null na posição se a roupa correspondente não for encontrada.

Formato RGB.

["http://a/a.png"]

[null] ou [None]

output.bbox

List[List[Integer]]

Lista de coordenadas das áreas segmentadas na imagem original.

Ordenada conforme a sequência de clothes_type.

Cada bbox: [x1, y1, x2, y2] (cantos superior esquerdo e inferior direito). Origem: canto superior esquerdo da imagem de entrada.

[[10,20,30,40], [50,60,70,80]]

usage.image_count

Integer

Número de imagens processadas por solicitação.

1

request_id

String

ID exclusivo da solicitação.

7574ee8f-38a3-4b1e-9280-11c33ab46e51

Exemplo de solicitação

  • Extrair a parte superior de uma imagem de modelo
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
  "model": "aitryon-parsing-v1",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250630/bakbqz/aitryon_parse_model.png"
  },
  "parameters": {
      "clothes_type": ["upper"]
  }
}'

Exemplo de resposta

  • Resposta bem-sucedida (tipo de roupa correspondente existe)
  • Resposta bem-sucedida (tipo de roupa correspondente não existe)
  • Resposta com falha
As URLs em parsing_img_url e crop_img_url expiram em 24 horas. Baixe-as dentro desse período.
{
    "output": {
        "bbox": [[331, 239,641,637]],
        "parsing_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_parsing_img.png?Expires=xxxx"],
        "crop_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_crop_img.jpg?Expires=xxxx"]
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "b68147d6-e7d0-920f-b889-xxxxxx"
}

Códigos de erro

Para códigos de status gerais, consulte Códigos de erro.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais