Skip to main content
OutfitAnyone

Referensi API Parsing OutfitAnyone

OutfitAnyone-Parsing memisahkan area pakaian—seperti atasan, bawahan, gaun, atau jumpsuit—dari gambar model atau gambar yang dihasilkan oleh OutfitAnyone. Gunakan bersama OutfitAnyone untuk partial try-on atau untuk mendapatkan koordinat pakaian .

Dokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model ini, Anda harus menggunakan API key dari wilayah China (Beijing).

Ikhtisar

Model

Harga

Batas laju (dibagi oleh akun dan Pengguna RAM)

RPS untuk API pengiriman tugas

Tugas konkuren

aitryon-parsing-v1

$0,000574/gambar

10

Tanpa Batas (API sinkron)

Output inti

Pemanggilan API ini menghasilkan tiga output inti. Contoh penguraian top berikut menjelaskan makna dan penggunaan setiap parameter.
InputOutput
Parameter outputContohMakna dan penggunaan
1
  • Input gambar model
  • Tetapkan jenis pakaian ke atasan
"clothes_type": ["upper"]
crop_img_url
3
  • Gambar pakaian yang dipotong (RGB): Gambar atasan dari model.
  • Digunakan untuk partial try-on dengan OutfitAnyone.
  • URL kedaluwarsa dalam 24 jam. Unduh segera.
parsing_img_url
4
  • Gambar pakaian hasil parsing (RGBA): Hasil parsing visual dari atasan.
  • Digunakan untuk pratinjau dan verifikasi akurasi parsing.
  • URL kedaluwarsa dalam 24 jam. Unduh segera.
bboxnilai bbox: [[331, 239,641,637]]
image
Gambar ini menunjukkan pemetaan antara nilai bbox dan koordinat gambar asli. Ini bukan output model.
  • Bounding box: Koordinat area persegi panjang pakaian hasil parsing pada gambar input.
    • Format: [x1, y1, x2, y2] (sudut kiri atas dan kanan bawah).
    • Origin: (0,0) di sudut kiri atas gambar input.
  • Digunakan untuk fitur antarmuka depan seperti hotspot produk.

Skenario

Skenario 1: Partial try-on

Tujuan: Mengganti sebagian pakaian model (atasan atau bawahan) sambil mempertahankan bagian lainnya tetap tidak berubah. Parsing gambar model diperlukan terlebih dahulu.

Contoh: Pertahankan atasan model dan ganti bawahannya

  1. Uraikan gambar model untuk mengekstrak bagian teratas
    • Panggil API ini dengan gambar model dan atur clothes_type ke ["upper"] untuk mengekstrak atasan.
    • API mengembalikan gambar teratas (crop_img_url).

    Input: Gambar model

    Output: Gambar pakaian hasil parsing (crop_img_url)

    1

    3

  2. Hasilkan gambar try-on

    Input

    Output: Gambar try-on

    Gambar model

    Gambar Atas

    Gambar bawahan

    1

    Sama dengan input API parsing.

    3

    Dari crop_img_url API parsing.

    2

    Gambar pakaian pengganti.

    5

Skenario 2: Mendapatkan koordinat pakaian tertentu

Tujuan: Mendapatkan koordinat bbox pakaian tertentu pada gambar model atau gambar try-on. Gunakan koordinat tersebut untuk label produk atau hotspot interaktif.

Contoh: Mendapatkan koordinat sebuah puncak

  1. Siapkan input: Gunakan gambar model atau gambar yang dihasilkan oleh OutfitAnyone. Lihat Referensi API OutfitAnyone-Plus.
  2. Parsing untuk mendapatkan koordinat: Tetapkan jenis parsing (misalnya, ["upper"] untuk atasan) untuk mendapatkan bbox.

    Input: Gambar model atau gambar try-on

    Output: Gambar pakaian hasil parsing dan rentang koordinat

    1

    Parameter permintaan "clothes_type": ["upper"]

    4

    • parsing_img_url: URL hasil visualisasi.

    • bbox: Koordinat bounding box (misalnya, [[331, 239, 641, 637]]).

Prasyarat

API OutfitAnyone-Parsing hanya mendukung panggilan HTTP. Dapatkan API key dan tetapkan API key sebagai variabel lingkungan.

HTTP

Titik akhir permintaan 

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process
Ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.

Parameter permintaan

Field

Tipe

Lokasi

Wajib

Deskripsi

Contoh

Content-Type

String

Header

Ya

Jenis permintaan. Atur ke application/json.

application/json

Authorization

String

Header

Ya

Kunci API. Format: Bearer sk-xxxx

Bearer sk-xxxx

model

String

Body

Ya

Model yang dipanggil. Atur ke aitryon-parsing-v1.

aitryon-parsing-v1

input.image_url

String

Body

Ya

URL publik gambar model yang akan diparsing. Dapatkan URL sementara di sini.

  • Ukuran file: 5 KB hingga 5 MB.

  • Dimensi: 150 hingga 4.096 piksel per sisi.

  • Format yang didukung: JPG, PNG, JPEG, BMP, dan HEIC.

  • Gambar harus berisi tepat satu orang utuh.

  • Hanya tautan HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung.

Untuk contoh gambar model, lihat Referensi API OutfitAnyone-Plus.

http://a/a.jpg

parameters.clothes_type

List[String]

Body

Tidak

Jenis pakaian yang akan diparsing. Default: ["upper"] (atasan).

Panjang dan urutan daftar menentukan daftar URL output.

Nilai yang valid:

  • ["upper"]: Pakaian atas.

  • ["lower"]: Pakaian bawahan.

  • ["dress"]: Gaun, jumpsuit, atau pakaian lengkap.

  • ["upper", "lower"]: Atasan dan bawahan.

["upper"]

Parameter respons

Field

Tipe

Deskripsi

Contoh

output.parsing_img_url

List[String]

Daftar URL untuk area hasil parsing yang divisualisasikan.

Daftar sesuai dengan panjang dan urutan clothes_type. Mengembalikan None/null pada posisi jika pakaian terkait tidak terdeteksi.

Gambar RGBA dalam format PNG.

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

[null] atau [None]

output.crop_img_url

List[String]

Daftar URL untuk gambar pakaian yang dipotong.

Daftar sesuai dengan panjang dan urutan clothes_type. Mengembalikan None/null pada posisi jika pakaian terkait tidak ditemukan.

Format RGB.

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

[null] atau [None]

output.bbox

List[List[Integer]]

Daftar koordinat untuk area hasil parsing pada gambar asli.

Diurutkan berdasarkan urutan clothes_type.

Setiap bbox: [x1, y1, x2, y2] (sudut kiri atas dan kanan bawah). Origin: sudut kiri atas gambar input.

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

usage.image_count

Integer

Jumlah gambar yang diproses per permintaan.

1

request_id

String

ID unik permintaan.

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

Contoh permintaan

  • Uraikan atasan dari gambar model
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"]
  }
}'

Contoh respons

  • Respons berhasil (jenis pakaian terkait ada)
  • Respons berhasil (jenis pakaian terkait tidak ada)
  • Respons gagal
URL dalam parsing_img_url dan crop_img_url kedaluwarsa dalam 24 jam. Unduh dalam periode tersebut.
{
    "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"
}

Kode error

Untuk kode status umum, lihat Kode error.
Penggunaan API
Generasi teks
Pembuatan Gambar
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model