Skip to main content
Creative Tools

Referensi API penyelesaian penghapusan gambar

Dokumen ini menjelaskan parameter model penyelesaian penghapusan gambar, yang menghapus satu atau beberapa elemen—seperti orang, hewan peliharaan, objek, teks, atau watermark—dari gambar sambil mempertahankan latar belakangnya. Anda dapat menentukan area yang akan dihapus menggunakan gambar mask.

Panduan terkait: Image erase completion
  • Dokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model ini, Anda harus menggunakan API key dari wilayah China (Beijing).
  • Model image-erase-completion saat ini hanya tersedia sebagai free trial. Setelah kuota gratis Anda habis, Anda tidak dapat lagi memanggil model ini karena opsi berbayar tidak didukung. Sebagai alternatif, kami merekomendasikan penggunaan Image editing - Qwen atau Image editing - Wan2.1.

Prasyarat

Buat API key dan ekspor API key sebagai variabel lingkungan.

Panggilan HTTP

Untuk mengurangi waktu tunggu dan mencegah timeout permintaan, layanan memproses permintaan secara asinkron. Anda perlu membuat dua permintaan:
  • Create a task: Kirim permintaan untuk membuat task pembuatan gambar. Permintaan ini mengembalikan ID task.
  • Query the result by task ID: Gunakan ID task yang dikembalikan untuk mengambil hasilnya.

Langkah 1: Membuat Tugas

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis

Request headers

Content-TypestringRequiredTipe konten permintaan. Nilainya harus application/json.AuthorizationstringRequiredKami merekomendasikan penggunaan Kunci API Model Studio Anda. Anda juga dapat menggunakan Kunci API DashScope. Contoh: Bearer d1xxx2a.X-DashScope-AsyncstringRequiredMenentukan apakah pemrosesan asinkron diaktifkan. Anda harus mengatur parameter ini ke enable.

Request body

modelstringRequiredModel yang akan dipanggil.inputobjectRequiredDetail gambar input, seperti URL gambar.

Properties

image_urlstringRequiredURL atau data yang dienkripsi Base64 dari gambar input.URL harus dapat diakses publik dan menggunakan HTTP atau HTTPS.Persyaratan gambar:
  • Format: JPEG, PNG, JPG, BMP, WEBP.
  • Resolusi: Minimal 512×512 piksel dan maksimal 4.096×4.096 piksel.
  • Rentang panjang sisi: [512, 4.096] piksel.
  • Ukuran file: Tidak boleh melebihi 10 MB.
  • URL tidak boleh mengandung karakter Tionghoa.
mask_urlstringRequiredURL atau data yang dienkripsi Base64 dari gambar mask yang menentukan area yang akan dihapus.URL harus dapat diakses publik dan menggunakan HTTP atau HTTPS.Persyaratan gambar:
  • Format: JPG, JPEG, PNG, HEIF, WEBP.
  • Resolusi: Minimal 512×512 piksel dan maksimal 4.096×4.096 piksel.
  • Rentang panjang sisi: [512, 4.096] piksel.
  • Ukuran file: Tidak boleh melebihi 10 MB.
Untuk membuat mask, lukis pada kanvas kosong dengan ukuran yang sama dengan gambar input. Area dengan nilai piksel bukan nol berfungsi sebagai mask penghapusan. Atau, gunakan human instance segmentation untuk langsung menghasilkan hasil segmentasi sebagai mask penghapusan.foreground_urlstring OptionalURL atau data yang dienkripsi Base64 dari gambar mask yang menentukan area yang akan dipertahankan.URL harus dapat diakses publik dan menggunakan HTTP atau HTTPS.Persyaratan gambar:
  • Format: JPG, JPEG, PNG, HEIF, WEBP.
  • Resolusi: Minimal 512×512 piksel dan maksimal 4.096×4.096 piksel.
  • Rentang panjang sisi: [512, 4.096] piksel.
  • Ukuran file: Tidak boleh melebihi 10 MB.
Untuk membuat mask pertahanan, lukis pada kanvas kosong dengan ukuran yang sama dengan gambar input. Area dengan nilai piksel bukan nol berfungsi sebagai mask pertahanan. Atau, gunakan human instance segmentation untuk menentukan ID orang, yang mengisolasi area mask orang tersebut agar tidak dihapus.
parametersobject OptionalParameter untuk pemrosesan gambar.

Properties

fast_modeboolOptionalMenentukan apakah mode cepat diaktifkan. Nilai default adalah false. Dalam mode cepat, inferensi membutuhkan waktu sekitar seperempat dari mode standar. Mode ini cocok untuk skenario yang tidak memerlukan detail tinggi.dilate_flagboolOptionalNilai default adalah true. Kami merekomendasikan mengatur nilai ini ke true jika mask penghapusan dihasilkan oleh algoritma, dan ke false jika Anda melukis mask penghapusan secara manual.add_watermark booleanOptionalMenambahkan watermark Generated by AI. Nilai default adalah true, yang menambahkan watermark di pojok kiri bawah gambar output.
  • Image erase completion
curl --location --request POST 'https://dashscope.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-raw '{
    "model": "image-erase-completion",
    "input": {
            "image_url": "http://xxx/input.png",
            "mask_url": "http://xxx/mask.png",
            "foreground_url": "http://xxx/foreground.png"
        },
    "parameters":{
        "dilate_flag":true
    }
}'

Response

outputobjectDetail output task.

Properties

task_idstringIdentifikasi unik task.task_statusstringStatus task.
  • PENDING: Task sedang dalam antrian.
  • RUNNING: Task sedang diproses.
  • SUSPENDED: Task ditangguhkan.
  • SUCCEEDED: Task berhasil diselesaikan.
  • FAILED: Task gagal.
codestringKode kesalahan. Parameter ini tidak dikembalikan jika permintaan berhasil.messagestringPesan kesalahan. Parameter ini tidak dikembalikan jika permintaan berhasil.request_idstringID permintaan unik. Gunakan ID ini untuk melacak dan memecahkan masalah.
{
    "output": {
        "task_status": "PENDING",
        "task_id": "53950fb7-281a-4e60-b543-xxxxxxxxxxxx"
    },
    "request_id": "1027557e-8c3f-9db5-8cd2-xxxxxxxxxxxx"
}

Langkah 2: Kueri hasilnya

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Request headers

AuthorizationstringRequiredKunci API Anda. Contoh: Bearer d1**2a.

Path parameters

task_idstringRequiredID task.
  • Task result
curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/53950fb7-281a-4e60-b543-xxxxxxxxxxxx

Response

outputobjectDetail output task.

Properties

task_id stringID task.task_status stringStatus task.
  • PENDING: Task sedang dalam antrian.
  • RUNNING: Task sedang diproses.
  • SUSPENDED: Task ditangguhkan.
  • SUCCEEDED: Task berhasil diselesaikan.
  • FAILED: Task gagal.
task_metrics objectStatistik task.

Properties

TOTAL integerJumlah total task.SUCCEEDED integerJumlah task yang berhasil.FAILED integerJumlah task yang gagal.
submit_time stringWaktu task diajukan.scheduled_time stringWaktu task mulai dijalankan.end_time stringWaktu penyelesaian tugas.output_image_url stringURL gambar output.codestringKode kesalahan. Parameter ini tidak dikembalikan jika permintaan berhasil.messagestringPesan kesalahan. Parameter ini tidak dikembalikan jika permintaan berhasil.
usageobjectStatistik penggunaan.

Properties

image_countintegerJumlah gambar yang dihasilkan.
request_idstringID permintaan unik. Gunakan ID ini untuk melacak dan memecahkan masalah.
  • Completed task
  • In-progress task
  • Failed task
Hasil task yang telah selesai tersedia selama 24 jam. Setelah periode ini, sistem akan menghapus task beserta hasilnya. URL gambar yang dihasilkan juga kedaluwarsa setelah 24 jam, sehingga Anda harus menyimpan gambar tersebut setelah mengambil hasil task.
{
    "request_id": "b67df059-ca6a-9d51-afcd-9b3c4456b1e2",
    "output": {
        "task_id": "53950fb7-281a-4e60-b543-xxxxxxxxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2024-05-16 13:50:01.247",
        "scheduled_time": "2024-05-16 13:50:01.354",
        "end_time": "2024-05-16 13:50:27.795",
        "output_image_url": "http://xxx/result.png"
    },
    "usage": {
        "image_count": 1
    }
}

Status codes

Untuk kode status umum layanan Model Studio, lihat Error messages. API ini juga mengembalikan kode status spesifik berikut:

HTTP status code

Error code

Error message

Description

400

InvalidParameter.JsonPhrase

input json error

JSON dalam permintaan tidak valid.

400

InvalidParameter.FileDownload

oss download error

Gagal mengunduh gambar input.

400

InvalidParameter.ImageFormat

read image error

Gagal membaca gambar.

400

InvalidParameter.ImageContent

The image content is not compliant.

Konten gambar tidak sesuai.

400

InvalidParameter

An input parameter value is out of range: xxx

Nilai parameter input berada di luar rentang.

400

InvalidParameter.ImageResolution

The input image size is too small or too large.

Ukuran gambar input terlalu kecil atau terlalu besar.

500

InternalError.Algo

algorithm process error

Kesalahan algoritma.

500

InternalError.FileUpload

oss upload error

Gagal mengunggah file.

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