Alibaba Cloud Model Studio:Panggil API pembuatan citra dan video menggunakan Postman atau cURL

Contoh panggilan HTTP (text-to-image)

Prasyarat

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

Langkah 1: Buat task

Konfigurasikan Postman berdasarkan perintah cURL berikut.

base_url berikut digunakan untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti base_url dengan https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis.

curl -X POST https://dashscope-intl.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. Pilih HTTP sebagai tipe permintaan.

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

   • Wilayah Internasional (Singapura): https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

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

   

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

   Key	Value	Description
   X-DashScope-Async	enable	Aktifkan pemanggilan asinkron.
   Authorization	Bearer sk-xxx (Ganti sk-xxx dengan Kunci API Model Studio Anda)	Kredensial verifikasi identitas.
   Content-Type	application/json	Nyatakan bahwa badan permintaan dalam format JSON.

4. Konfigurasikan badan permintaan (Body)

   • Klik tab Body, pilih tombol radio raw, lalu pilih JSON dari menu drop-down format di sebelah kanan. Tempel konten JSON yang mengikuti -d pada 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. ID ini berlaku selama 24 jam. Setelah kedaluwarsa, Anda tidak dapat lagi mengkueri task tersebut. Ambil hasilnya sesegera mungkin.

   

Langkah 2: Kueri hasil berdasarkan task_id

Setelah Anda mendapatkan task_id, gunakan API kueri untuk mengambil hasil akhir.

base_url berikut digunakan untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti base_url dengan https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}.

curl -X GET https://dashscope-intl.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. Masukkan URL kueri untuk wilayah Anda. Ganti {task_id} dalam URL dengan task_id aktual yang Anda dapatkan di Langkah 1.

   4. Pada tab Headers, tambahkan kunci Authorization. Gunakan nilai Kunci API yang sama seperti di Langkah 1.

   5. Klik Send untuk mengirim permintaan.

   

2. Periksa hasil yang dikembalikan. Kirim ulang permintaan ini secara berulang (polling) hingga `task_status` berubah menjadi `SUCCEEDED`, lalu ambil URL citra. URL citra berlaku selama 24 jam. Unduh segera.

   

Prasyarat

Sebelum menjalankan perintah cURL:

• Aktifkan Model Studio dan dapatkan Kunci API.

• Pastikan cURL telah diinstal di sistem Anda dan Anda telah mengekspor Kunci API sebagai Variabel lingkungan. Hal ini memungkinkan Anda merujuk langsung ke variabel $DASHSCOPE_API_KEY.

  Periksa apakah cURL telah diinstal

  Jalankan perintah berikut untuk memeriksa apakah cURL telah diinstal.

  curl --version

  Jika Anda menerima output yang mirip dengan berikut, artinya cURL telah diinstal:

  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 diinstal, Anda mungkin melihat pesan seperti berikut:

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

  • Linux/macOS: command not found: curl.

  Kunjungi halaman unduhan cURL untuk menginstalnya.

Langkah 1: Buat task

• Jalankan perintah berikut di terminal Anda:

  base_url berikut digunakan untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti base_url dengan https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis.

  curl -X POST https://dashscope-intl.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. Setelah kedaluwarsa, Anda tidak dapat lagi mengkueri task tersebut. Ambil hasilnya sesegera mungkin.

  

Langkah 2: Kueri hasil berdasarkan task_id

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

  base_url berikut digunakan untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti base_url dengan https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}.

  curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

• Ketika task_status bernilai SUCCEEDED, respons akan berisi URL citra. URL citra berlaku selama 24 jam. Unduh citra sebelum URL kedaluwarsa.

  Pemrosesan task dapat memakan waktu dari puluhan detik hingga beberapa menit. Anda mungkin perlu melakukan polling ke titik akhir ini. Lakukan kueri setiap 3 hingga 5 detik hingga task_status tidak lagi bernilai RUNNING.