模型版本概括:

前提條件

在開始調(diào)用通義萬相的 API 之前,必須完成一些前期準備工作:

  1. API Key 獲取:您需要訪問阿里云控制臺獲取 API Key,并將其配置到環(huán)境變量中。
  2. SDK 安裝:如需通過 SDK 進行調(diào)用,請先安裝 DashScope SDK,支持 Python 和 Java 語言。

HTTP 調(diào)用簡介

調(diào)用通義萬相 API 可以通過 HTTP 協(xié)議進行異步操作,以下是調(diào)用過程的基本步驟。

創(chuàng)建任務(wù)

使用 HTTP POST 方法創(chuàng)建任務(wù),發(fā)送請求并獲取任務(wù) ID。

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": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "一間有著精致窗戶的花店,漂亮的木質(zhì)門,擺放著花朵"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

查詢?nèi)蝿?wù)結(jié)果

一旦任務(wù)創(chuàng)建成功,您可以通過任務(wù) ID 查詢生成的圖像結(jié)果。

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

使用 SDK 調(diào)用

DashScope SDK 提供了更高層次的封裝,支持同步和異步兩種方式調(diào)用。

Python SDK 調(diào)用

Python SDK 提供了便捷的接口,以下是一個簡單的同步調(diào)用示例:

from dashscope import ImageSynthesis
import os

prompt = "一間有著精致窗戶的花店,漂亮的木質(zhì)門,擺放著花朵"

rsp = ImageSynthesis.call(api_key=os.getenv("DASHSCOPE_API_KEY"),
                          model="wanx2.1-t2i-turbo",
                          prompt=prompt,
                          n=1,
                          size='1024*1024')

for result in rsp.output.results:
    print('Image URL:', result.url)

Java SDK 調(diào)用

Java SDK 提供了類似的功能,以下是一個異步調(diào)用示例:

import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;

public class Main {
    public void asyncCall() {
        ImageSynthesisParam param = ImageSynthesisParam.builder()
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model("wanx2.1-t2i-turbo")
                .prompt("一間有著精致窗戶的花店,漂亮的木質(zhì)門,擺放著花朵")
                .n(1)
                .size("1024*1024")
                .build();

        ImageSynthesis imageSynthesis = new ImageSynthesis();
        imageSynthesis.asyncCall(param);
    }
}

常見問題 (FAQ)

FAQ

  1. 問:如何獲取 API Key?

  2. 問:通義萬相 API 支持同步調(diào)用嗎?

  3. 問:調(diào)用 API 時出現(xiàn)超時錯誤怎么辦?

  4. 問:如何解決“Invalid API-key provided”錯誤?

  5. 問:生成的圖像鏈接如何訪問?

通過本文的詳細介紹,您現(xiàn)在應(yīng)該對如何使用通義萬相的 API 有了清晰的理解,并能夠在您的項目中有效地集成和調(diào)用這些功能。

上一篇:

Sora API Key 獲取:完整指南

下一篇:

RunwayML Agent 開發(fā):探索最新的生成式AI應(yīng)用
#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊

多API并行試用

數(shù)據(jù)驅(qū)動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費