服務說明

由于產品業務和安全合規調整，文生圖服務將于2025年01月20日起停止提供服務，后續不再支持新老用戶開通接入及調用服務。用戶提前切換去調用通義萬相服務。如果對文生圖API服務使用有疑問，可通過搜索釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

功能描述

依托達摩院自研文生圖大模型，通過知識重組與可變維度擴散模型加速收斂并提升最終生成圖片, 輸入描述文本，即可返回符合文本描述的2D圖像，支持中英雙語輸入，您可以通過API實現服務調用。

應用場景

• 圖片設計：根據特定prompt輸入，為設計師提供素材和創作靈感，提升設計成圖的效率。
• 內容創作：根據內容工作者的文字內容快速生成人物、背景、封面、動漫、游戲等創意內容。

特色優勢

• 場景支持廣：分辨率支持較為靈活，支持主流設計場景的分辨率設置。
• 適用范圍廣：能基于任意中英文文本描述進行推理，生成圖像。
• 生成效果佳：在非現實、朋克機甲等類型的圖片生成效果領先。

計費說明

關于文生圖的計費方式及報價，請參見計費介紹。

調用步驟

該能力為異步能力，需分兩步進行調用。

第一步調用GenerateImageWithText接口提交任務，請求成功后，得到一個任務ID。

第二步調用GetAsyncJobResult接口查詢結果，根據任務ID查詢任務執行狀態和結果。如果任務還在處理中，可稍等一段時間后再進行查詢。

請求參數

返回數據

查詢結果

該接口為異步接口，當前并未返回真實的請求結果，您需要通過返回的RequestId調用GetAsyncJobResult接口來獲取該接口的真實請求結果。詳情請參見GetAsyncJobResult。

SDK參考

阿里云視覺AI圖像生產類目下的文生圖能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為圖像生產（imageenhan）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例

請求示例

http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=GenerateImageWithText      //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&Text=一只戴著太陽鏡的小松鼠在演奏吉他
&Resolution=1024*1024
&Number=1
&公共請求參數

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GenerateImageWithTextResponse>
    <RequestId>7574ee8f-38a3-4b1e-9280-11c33ab46e51</RequestId>
    <Message>該調用為異步調用，任務已提交成功，請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。</Message>
</GenerateImageWithTextResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "Message" : "該調用為異步調用，任務已提交成功，請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。"
}

返回示例補充說明

//查詢結果：請求示例
http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共請求參數>

//查詢結果：返回示例
{
  "RequestId" : "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
    "Result" : "{\"ImageUrls\":[\"http://vibktprfx-prod-prod-gen-model-cn-shanghai.oss-cn-shanghai.aliyuncs.com/text2image/cv_diffusion_text-to-image-synthesis_results/images/42d57dec8fe011ed9f3dde652e7536a6_1.jpg?Expires=1673244687&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=JxAFHGKJbyIq9EUxa6BZzWj1hw****\"]}"
  }
}

//Result反序列化
{
  "ImageUrls" : ["http://vibktprfx-prod-prod-gen-model-cn-shanghai.oss-cn-shanghai.aliyuncs.com/text2image/cv_diffusion_text-to-image-synthesis_results/images/42d57dec8fe011ed9f3dde652e7536a6_1.jpg?Expires=1673244687&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=JxAFHGKJbyIq9EUxa6BZzWj1hw****"]
}

錯誤碼

關于文生圖的錯誤碼，詳情請參見常見錯誤碼。

版權說明

• ?成圖?歸屬于誰？

  我們為您提供的是圖??成技術服務，在您購買產品并?付調?API技術服務費后，?成圖?的著作

  權將永久歸您所有。您可?于商業?途，并??負責?成圖?的使??險及合規問題，我們對此不承

  擔任何法律責任。

• 圖?是如何?成的？

  圖?與您輸?的內容有關，并通過深度合成算法?動?成，本服務算法是根據開源數據集及互聯?的

  公開信息積累訓練?成。因此，我們對?成圖?的準確性、完整性和功能性不做任何保證，亦不承擔

  任何法律責任。

• 圖?引發不適該怎么辦？

  本服務?成的所有內容均由AI模型?動?成，我們在訓練過程中已通過將訓練數據持續過濾來提升

  內容理解和?成的準確性，但仍不排除其中有部分信息存在?定的敏感性、不合理或導致理解歧義的

  問題存在，可能會引發您的不適。

  您可以通過釘釘群（23109592）聯系我們，我們將及時聯系您并采取合理有效的處理措施。

安全聲明

• 請確保上傳的圖片或文件來源符合相應的法律法規。
• 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。