執行 AI 文字生成圖片任務。

请求

AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 success 或 error 通知後，使用收到的 task_id 查詢任務結果。設定與驗證細節請見 webhook 整合指南。

若您的整合不支援 webhook 或無法使用 webhook，請實作輪詢。送出 AI 任務後，以固定間隔（例如每 10 秒）輪詢狀態端點，直到任務狀態為 success 或 error。

安全

BearerAuthenticationV2

正文application/json必需

promptstring必需

用於生成影像的提示

示例:"A little cat"

negative_promptstring

提示不想要的內容

示例:"dog"

template_idstring必需

範本的 ID。請先列出預先定義的範本，然後使用某個範本的 id。

示例:"good_template_001"

stepsinteger

Steps 會影響影像品質與處理時間。
建議的 Steps 數量
10-15 Steps：最適合快速測試提示與做大幅調整。
15–20 Steps：社群公認的最佳區間。多數模型在此範圍達到理想的品質與時間比例。
20–30 Steps：最適合生成高度細節的主體，例如臉部、毛髮或建築元素。

示例:10

cfg_scalenumber

CFG（Classifier-Free Guidance）尺度是一個數學設定，決定 AI 模型遵循您文字提示的嚴格程度。
低 CFG（1 – 4）：AI 有很高的創作自由度。它會寬鬆地解讀您的提示，可能產生抽象、繪畫感的結果，或完全偏離主題的影像。
中等 CFG（5 – 10）：理想的最佳區間。生成器緊隨您的文字，同時維持自然且高品質的視覺效果。
高 CFG（11+）：AI 會嚴格遵守提示中的每個字。細節會更鮮明、更照字面呈現，但尺度過高常導致過度飽和的色彩、雜訊與不自然的偽影。

示例:4

seedArray of integers

每張影像都以唯一的 seed 生成。使用相同的 seed 可重現同一張影像。僅接受 1 個 seed。

示例:

[
  3843718472198472
]

width_ratiointeger

影像比例的寬度。

示例:3

height_ratiointeger

影像比例的高度。

示例:4

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/text-to-image \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A little cat",
    "negative_prompt": "dog",
    "template_id": "good_template_001",
    "steps": 10,
    "cfg_scale": 4,
    "seed": [
      3843718472198472
    ],
    "width_ratio": 3,
    "height_ratio": 4
  }'

响应

任務執行成功

正文application/json

statusinteger

回應狀態

示例:200

dataobject

响应

{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}

執行 AI 文字生成圖片任務。

请求

响应

这有帮助吗？