Alibaba Cloud Model Studio：Teks-ke-gambar

Contoh permintaan

from http import HTTPStatus
from urllib.parse import urlparse, unquote
from pathlib import PurePosixPath
import requests
from dashscope import ImageSynthesis
import os
import dashscope

# URL berikut untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/api/v1
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

prompt = "Poster bergambar tangan bergaya penyembuhan yang menampilkan tiga anak anjing bermain bola di atas rumput hijau subur, dihiasi elemen dekoratif seperti burung dan bintang. Judul utama “Come Play Ball!” ditampilkan mencolok di bagian atas dengan font kartun biru tebal. Di bawahnya, subjudul “Come [Show Off Your Skills]!” muncul dalam font hijau. Gelembung ucapan menambah daya tarik bermain dengan teks: “Hehe, watch me amaze my little friends next!” Di bagian bawah, teks tambahan berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau dan biru segar, diaksen dengan nada pink dan kuning cerah untuk menonjolkan suasana ceria dan kekanak-kanakan."

# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan kunci API Model Studio Anda: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

print('----panggilan sinkron, harap tunggu sebentar----')
rsp = ImageSynthesis.call(api_key=api_key,
                          model="qwen-image-plus", # Saat ini, hanya model qwen-image-plus dan qwen-image yang mendukung panggilan API asinkron.
                          prompt=prompt,
                          negative_prompt=" ",
                          n=1,
                          size='1664*928',
                          prompt_extend=True,
                          watermark=False)
print(f'respons: {rsp}')
if rsp.status_code == HTTPStatus.OK:
    # Simpan citra ke direktori saat ini.
    for result in rsp.output.results:
        file_name = PurePosixPath(unquote(urlparse(result.url).path)).parts[-1]
        with open('./%s' % file_name, 'wb+') as f:
            f.write(requests.get(result.url).content)
else:
    print(f'panggilan_sinkron Gagal, status_code: {rsp.status_code}, kode: {rsp.code}, pesan: {rsp.message}')

Contoh respons

URL berlaku selama 24 jam. Unduh citra segera.

{
    "status_code": 200,
    "request_id": "a47b1a65-7041-4565-9068-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "91093132-475e-43cf-b94e-xxxxxx",
        "task_status": "SUCCEEDED",
        "results": [
            {
                "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxxxx",
                "orig_prompt": "Poster bergambar tangan bergaya penyembuhan yang menampilkan tiga anak anjing bermain bola di atas rumput hijau subur, dihiasi elemen dekoratif seperti burung dan bintang. Judul utama “Come Play Ball!” ditampilkan mencolok di bagian atas dengan font kartun biru tebal. Di bawahnya, subjudul “Come [Show Off Your Skills]!” muncul dalam font hijau. Gelembung ucapan menambah daya tarik bermain dengan teks: “Hehe, watch me amaze my little friends next!” Di bagian bawah, teks tambahan berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau dan biru segar, diaksen dengan nada pink dan kuning cerah untuk menonjolkan suasana ceria dan kekanak-kanakan.",
                "actual_prompt": "Desain poster bergambar tangan bergaya masa kecil: Tiga anak anjing bermain dengan riang berinteraksi dengan bola berwarna-warni di atas hamparan rumput hijau subur. Elemen dekoratif halus termasuk burung yang beterbangan dan bintang berkelap-kelip tersebar di seluruh area. Di tengah atas, judul tebal bergaya kartun biru “Come Play Ball!” menonjol mencolok. Tepat di bawahnya, subjudul “Come [Show Off Your Skills]!” ditulis dengan huruf hijau ceria. Gelembung ucapan whimsical di dekat salah satu anak anjing berisi teks bermain: “Hehe, watch me amaze my little friends next!” Di tepi bawah, teks tambahan yang lebih kecil berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau segar dan biru langit, diaksen dengan sentuhan pink cerah dan kuning cerah, meningkatkan suasana ceria dan kekanak-kanakan. Gaya mengevokasi ilustrasi tinta tangan nostalgia dengan tekstur lembut, garis halus, dan komposisi seperti buku cerita whimsical."
            }
        ],
        "submit_time": "2025-09-09 13:39:20.659",
        "scheduled_time": "2025-09-09 13:39:20.717",
        "end_time": "2025-09-09 13:39:45.233"
    },
    "usage": {
        "image_count": 1
    }
}

Contoh permintaan

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisListResult;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import java.util.HashMap;
import java.util.Map;

public class Text2Image {
    static {
        // URL berikut untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/api/v1
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }

    // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan kunci API Model Studio Anda: static String apiKey = "sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException {
        String prompt = "Poster bergambar tangan bergaya penyembuhan yang menampilkan tiga anak anjing bermain bola di atas rumput hijau subur, dihiasi elemen dekoratif seperti burung dan bintang. Judul utama “Come Play Ball!” ditampilkan mencolok di bagian atas dengan font kartun biru tebal. Di bawahnya, subjudul “Come [Show Off Your Skills]!” muncul dalam font hijau. Gelembung ucapan menambah daya tarik bermain dengan teks: “Hehe, watch me amaze my little friends next!” Di bagian bawah, teks tambahan berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau dan biru segar, diaksen dengan nada pink dan kuning cerah untuk menonjolkan suasana ceria dan kekanak-kanakan.";
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        ImageSynthesisParam param =
                ImageSynthesisParam.builder()
                        .apiKey(apiKey)
                        // Saat ini, hanya model qwen-image-plus dan qwen-image yang mendukung panggilan API asinkron.
                        .model("qwen-image-plus")
                        .prompt(prompt)
                        .n(1)
                        .size("1664*928")
                        .parameters(parameters)
                        .build();

        ImageSynthesis imageSynthesis = new ImageSynthesis();
        ImageSynthesisResult result = null;
        try {
            System.out.println("---panggilan sinkron, harap tunggu sebentar----");
            result = imageSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args){
        try{
            basicCall();
        }catch(ApiException|NoApiKeyException e){
            System.out.println(e.getMessage());
        }
    }
}

Contoh respons

URL berlaku selama 24 jam. Unduh citra segera.

{
    "request_id": "9f3044ba-528f-4606-8830-xxxxxx",
    "output": {
        "task_id": "fecf4c7f-3508-45f4-8454-xxxxxx",
        "task_status": "SUCCEEDED",
        "results": [
            {
                "orig_prompt": "Poster bergambar tangan bergaya penyembuhan yang menampilkan tiga anak anjing bermain bola di atas rumput hijau subur, dihiasi elemen dekoratif seperti burung dan bintang. Judul utama “Come Play Ball!” ditampilkan mencolok di bagian atas dengan font kartun biru tebal. Di bawahnya, subjudul “Come [Show Off Your Skills]!” muncul dalam font hijau. Gelembung ucapan menambah daya tarik bermain dengan teks: “Hehe, watch me amaze my little friends next!” Di bagian bawah, teks tambahan berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau dan biru segar, diaksen dengan nada pink dan kuning cerah untuk menonjolkan suasana ceria dan kekanak-kanakan.",
                "actual_prompt": "Desain poster bergambar tangan bergaya masa kecil: Tiga anak anjing bermain dengan riang berinteraksi dengan bola berwarna-warni di atas hamparan rumput hijau subur. Elemen dekoratif halus termasuk burung yang beterbangan dan bintang berkelap-kelip tersebar di seluruh area. Di tengah atas, judul tebal bergaya kartun biru “Come Play Ball!” menonjol mencolok. Tepat di bawahnya, subjudul “Come [Show Off Your Skills]!” ditulis dengan huruf hijau ceria. Gelembung ucapan whimsical di dekat salah satu anak anjing berisi teks bermain: “Hehe, watch me amaze my little friends next!” Di tepi bawah, teks tambahan yang lebih kecil berbunyi: “We get to play ball with our friends again!” Palet warna berpusat pada hijau segar dan biru langit, diaksen dengan sentuhan pink cerah dan kuning cerah, meningkatkan suasana ceria dan kekanak-kanakan. Gaya mengevokasi ilustrasi tinta tangan nostalgia dengan tekstur lembut, garis halus, dan komposisi seperti buku cerita whimsical.",
                "url": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxxx"
            }
        ]
    },
    "usage": {
        "image_count": 1
    }
}

Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan ID tugas aktual.

Kunci API bersifat spesifik wilayah. Dapatkan kunci API.

Untuk model di wilayah Beijing, ganti base_url dengan https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"