文件 · API參考

API 參考

端點、金鑰、限制。AI圖像端點的參考文件 — 生成、移除、擴展 — 包含驗證、CORS及速率限制。

Morph在api.morph.cool提供一組AI圖像API端點。這些端點支援Artboard的AI功能，開發者亦可透過API建置整合。

基礎網址： https://api.morph.cool
所有請求使用 HTTPS。HTTP 請求將被拒絕。

驗證

AI 圖像端點（產生、移除、擴展）基本使用不需驗證。它們會根據 IP 位址進行速率限制。修改使用者資料的端點（轉換、鈴聲、排行榜）需要傳遞 JWT 權杖作為 Bearer 權杖在 Authorization 標頭中。

Authorization: Bearer <jwt_token>

所有端點均設有速率限制以防止濫用。超過限制會返回 429 狀態碼及 JSON 錯誤。

文字轉圖像生成與修補。將畫布圖像與遮罩傳送以根據文字提示填補選定區域。也支援描述模式，可返回圖像的文字描述。

欄位	類型	描述
提示	string	生成內容的文字描述。在描述模式下不需要。
canvasImage必要	string	畫布內容的Base64編碼PNG。
maskImage	string	選取範圍的 Base64 編碼 PNG。白色 = 填充區域。用於 inpainting 時必需，描述時不需要。
模式	string	設定為`"describe"`以啟用圖像描述模式。省略以進行生成。

生成回應：

{
  "result": "<base64_png_string>"
}

描述回應：

{
  "result": "A detailed text description of the image content."
}

驗證： 在描述模式下，PNG 必須至少為 64×64 像素。較小的圖像會返回 REGION_TOO_SMALL 錯誤。

AI-powered object removal. Paint over an object in the mask and the model fills the area with contextually appropriate content.

欄位	類型	描述
canvasImage必要	string	Base64-encoded PNG of the canvas.
maskImagerequired	string	Base64 編碼的 PNG 掩碼。白色 = 需移除的區域。

回應：

{
  "result": "<base64_png_string>"
}

在指定方向擴展畫布。AI 會以符合現有圖像的內容填滿新區域。使用邊緣像素延伸以取得上下文。

欄位	類型	描述
canvasImage必要	string	Canvas的Base64編碼PNG，尺寸必須為64–4096像素每邊。
方向必要	string	其中一個： `left`, `right`, `top`, `bottom`, `all`。
expandPxrequired	數字	像素擴展範圍：64–512。
提示	string	用於引導生成內容的可選文字提示。

回應：

{
  "result": "<base64_png_string>"
}

驗證： 來源圖像的每邊必須在 64–4096px 之間。擴展後的畫布尺寸不得超過 4096px。違反規則將返回 REGION_TOO_SMALL 或 CANVAS_TOO_LARGE 錯誤。

所有端點都會回傳帶有 error 欄位的 JSON 錯誤回應：

{
  "error": "RATE_LIMITED"
}

常見錯誤代碼：

AI模型 — 所有 inpainting 端點均透過 Cloudflare Workers AI 使用 Stable Diffusion v1.5。推斷步驟上限為 20。
圖像格式 — 所有圖像必須為base64編碼的PNG。
隱私 — 圖像在記憶體中處理，不會儲存、記錄或用於模型訓練。
CORS — 端點接受來自 morph.cool、www.morph.cool 和 localhost:5173 的請求。
逾時 — 客戶端應設定30秒逾時。伺服器端處理通常不超過15秒。