Alibaba Cloud Model Studio:Gunakan Postman atau cURL untuk memanggil API pembuatan gambar dan video

Contoh panggilan HTTP (text-to-image)

Prasyarat

Sebelum memanggil API, dapatkan Kunci API untuk wilayah Anda dan unduh Postman.

Langkah 1: Buat task

Gunakan perintah cURL berikut untuk mengonfigurasi Postman.

URL dasar berikut berlaku untuk wilayah Singapura. Anda harus menggunakan URL dasar yang sesuai dengan wilayah Anda.

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.5-t2i-preview",
    "input": {
        "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

1. Di Postman, klik tombol New atau + untuk membuat permintaan baru, lalu pilih HTTP sebagai jenis permintaan.

2. Dari drop-down metode permintaan, pilih POST dan masukkan URL untuk wilayah penerapan model Anda:

   • Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis, dan ganti WorkspaceId dengan Workspace ID Anda yang sebenarnya seperti dijelaskan dalam Dapatkan Workspace ID.

   • AS (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

   • China (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

   Untuk model yang didukung di setiap wilayah, lihat konsol Model Studio. Wilayah saat ini dan cakupan penerapan layanan didasarkan pada hubungan binding sistem yang telah ditentukan, dan kombinasi kustom tidak didukung.

   

3. Klik tab Headers dan tambahkan tiga pasangan kunci-nilai berikut.

   Key	Value	Deskripsi	Di Postman, pada tab Headers, atur X-DashScope-Async ke enable, Authorization ke Bearer <your-api-key>, dan Content-Type ke application/json.
   X-DashScope-Async	enable	Mengaktifkan panggilan asinkron.
   Authorization	Bearer sk-xxx (Ganti sk-xxx dengan Kunci API Anda)	Kredensial autentikasi.
   Content-Type	application/json	Menyatakan bahwa badan permintaan dalam format JSON.

4. Konfigurasikan badan permintaan:

   • Klik tab Body, pilih radio button raw, pilih JSON dari menu drop-down format di sebelah kanan, lalu tempel konten JSON yang mengikuti -d dari contoh cURL ke dalam kotak input.

     {
         "model": "wan2.5-t2i-preview",
         "input": {
             "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
         },
         "parameters": {
             "size": "1024*1024",
             "n": 1
         }
     }

   • (Opsional) Klik Beautify di sisi kanan halaman untuk memformat JSON agar lebih mudah dibaca.

   

5. Klik Send untuk mengirim permintaan dan mendapatkan task_id. task_id berlaku selama 24 jam. Setelah periode ini, hasil tidak dapat dikueri lagi. Harap segera ambil hasilnya.

   {
       "request_id": "896b2ccd-a0cd-40a8-a557-bb73cee5cf95",
       "output": {
           "task_id": "42442de9-917d-4c41-80a7-37fb7ad25ed2",
           "task_status": "PENDING"
       }
   }

   

Langkah 2: Kueri hasil berdasarkan ID task

Setelah Anda memiliki ID task, panggil endpoint kueri untuk mengambil hasil akhir.

• Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis, dan ganti WorkspaceId dengan Workspace ID Anda yang sebenarnya.

• AS (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

• China (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

1. Konfigurasikan permintaan kueri di Postman:

   1. Buat permintaan HTTP baru.

   2. Atur metode permintaan ke GET.

   3. Berdasarkan wilayah, masukkan URL kueri, dan ganti {task_id} di URL dengan task_id yang sebenarnya yang Anda peroleh di Langkah 1.

   4. Di tab Headers, tambahkan header Authorization, menggunakan Kunci API yang sama dari Langkah 1.

   5. Klik Send.

   

2. Periksa respons. Lakukan polling endpoint ini hingga task_status bernilai SUCCEEDED untuk mendapatkan URL gambar. URL gambar berlaku selama 24 jam. Pastikan Anda mengunduh gambar tersebut dalam periode validitas 24 jam.

   "results": [
               {
                   "orig_prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display",
                   "actual_prompt": "A cozy and elegant flower shop, with an exterior decorated with exquisitely carved windows. The window frames are light-colored wood, set with transparent glass that reveals the soft light inside. The front door is a beautiful solid wood door that retains its natural grain, complemented by a brass handle and a vintage nameplate, giving it a quaint and textured feel. On both sides of the front steps, and on the windowsills and entrance area, various flowers—including roses, lilies, hydrangeas, and tulips—are arranged in a staggered, vibrant display. Some bouquets are wrapped in kraft paper and tied with twine, exuding a fresh, natural scent. The background features a quiet European town streetscape, with stone-paved roads and greenery adding to the charm. The overall image is in a realistic photographic style, with soft lighting and a warm color palette that highlights the shop's exquisite and romantic atmosphere.",
                   "url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/1d/3a/20251203/7a2bee47/42442de9-917d-4c41-80a7-37fb7ad25ed2.png?xxx"
               }
           ]

Prasyarat

Sebelum menjalankan perintah cURL:

• Aktifkan layanan model dan dapatkan Kunci API.

• Pastikan Anda telah menginstal cURL, dan konfigurasikan Kunci API sebagai Variabel lingkungan, sehingga Anda dapat langsung mereferensikan variabel $DASHSCOPE_API_KEY nanti.

  Periksa apakah cURL telah terinstal

  Jalankan perintah berikut untuk memeriksa apakah cURL telah terinstal.

  curl --version

  Jika Anda melihat output yang mirip berikut, artinya cURL telah terinstal:

  curl 8.x.x (x86_64-apple-darwin23.0) libcurl/8.x.x (SecureTransport) LibreSSL/3.3.6 zlib/1.2.12 nghttp2/1.58.0
  Release-Date: 2023-10-11
  Protocols: dict file ftp ftps gopher gophers http https imap imaps ldap ldaps mqtt pop3 pop3s rtsp smb smbs smtp smtps telnet tftp
  Features: alt-svc AsynchDNS GSS-API HSTS HTTP2 HTTPS-proxy IPv6 Kerberos Largefile libz MultiSSL NTLM NTLM_WB SPNEGO SSL threadsafe UnixSockets

  Jika belum terinstal, Anda mungkin akan melihat pesan seperti salah satu berikut:

  • Windows: 'curl' is not recognized as an internal or external command, operable program or batch file.

  • Linux/macOS: command not found: curl.

  Buka halaman unduhan curl untuk menginstalnya.

Langkah 1: Buat task

• Jalankan perintah berikut di terminal Anda:

  URL dasar berikut berlaku untuk wilayah Singapura. Anda harus menggunakan URL dasar yang sesuai dengan wilayah Anda.

  curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
      -H 'X-DashScope-Async: enable' \
      -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
      "model": "wan2.5-t2i-preview",
      "input": {
          "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
      },
      "parameters": {
          "size": "1024*1024",
          "n": 1
      }
  }'

• Permintaan yang berhasil akan mengembalikan task_id. ID ini berlaku selama 24 jam dan tidak dapat digunakan untuk kueri setelah kedaluwarsa. Harap segera ambil hasilnya.

  curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
      -H 'X-DashScope-Async: enable' \
      -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
      "model": "wan2.5-t2i-preview",
      "input": {
          "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
      },
      "parameters": {
          "size": "1024*1024",
          "n": 1
      }
  }'
  {"request_id":"ca3b5224-bc60-4e47-80f4-2790040e9e55","output":{"task_id":"2de3f7e1-52ce-4cf4-a466-f2d318061c43","task_status":"PENDING"}}

  

Langkah 2: Kueri hasil berdasarkan ID Tugas

• Ganti {task_id} dalam perintah berikut dengan ID task yang Anda peroleh di Langkah 1, salin perintah tersebut ke terminal, lalu jalankan.

  URL dasar berikut berlaku untuk wilayah Singapura. Anda harus menggunakan URL dasar yang sesuai dengan wilayah Anda.

  curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

• Ketika task selesai (nilai task_status adalah SUCCEEDED), respons akan berisi URL gambar. URL gambar berlaku selama 24 jam. Unduh segera.

  Karena model memerlukan waktu lama untuk memproses (dari puluhan detik hingga beberapa menit), Anda mungkin perlu melakukan polling API ini. Kami menyarankan Anda mengkueri API setiap 3 hingga 5 detik hingga nilai task_status tidak lagi RUNNING.

  curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/2de3f7e1-52ce-4cf4-a466-f2d3f8061c43 \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"
  {"request_id":"24143559-9964-4898-8f9c-d968bba182b9","output":{"task_id":"2de3f7e1-52ce-4cf4-a466-f2d3f8061c43","task_status":"SUCCEEDED","submit_time":"2025-12-03 10:19:18.293","scheduled_time":"2025-12-03 10:19:18.320","end_time":"2025-12-03 10:19:31.890","results":[{"orig_prompt":"A flower shop with exquisite windows, a beautiful wooden door, and flowers on display","actual_prompt":"A cozy, elegant flower shop. The exterior wall features exquisitely carved windows with dark brown wooden frames, and the glass is clean and bright, revealing the soft light inside. The front door is a beautiful solid wood door that retains its natural grain, complemented by a brass handle and a vintage nameplate that exudes a strong artisanal feel. On both sides of the front steps, and on the windowsills and entrance area, various flowers—including blooming roses, elegant hydrangeas, fresh daisies, and green eucalyptus leaves—are arranged in a staggered yet harmonious display. The background is a quiet European town streetscape, with a stone-paved road and a vine-covered neighboring wall enhancing the romantic atmosphere. The overall image is in a realistic photographic style, with soft, natural lighting that highlights the wood texture and floral details.","url":"https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/1d/59/20251203/7a2bee47/2de3f7e1-52ce-4cf4-a466-f2d3f8061c43.png?Expires=1764814771&OSSAccessKeyId=xxx"}],"task_metrics":{"TOTAL":1,"FAILED":0,"SUCCEEDED":1}},"usage":{"image_count":1}}