鑑權與圖片輸入

在可信環境鑑權

開放 API 請求使用 Authorization: Bearer <API_KEY>。Key 僅在帳戶 → 開發者建立時明文顯示。請放在金鑰儲存中；輪換時先更新呼叫方，再撤銷舊 Key，並避免記錄請求頭。

API 需要已驗證的 AnimGen 帳戶。註冊基礎檔為 1 併發、3 個排隊任務、每分鐘 3 次建立和 60 次其他請求；有效訂閱會提高這些帳戶級限額。通過 GET /account 檢視當前檔位、Key 權限與限額，通過 GET /credits/balance 檢視可用點數。

MCP 使用 OAuth 和更細分的權限，不要把這張 API Key 權限表套用到 MCP。

方案 A：上傳後複用檔案 ID

curl --fail-with-body https://api.animgen.com/v1/files \
  -H "Authorization: Bearer $ANIMGEN_API_KEY" \
  -F "[email protected]"

響應包含 id、MIME 型別、尺寸、位元組數和 SHA-256。使用返回的 ID，不要傳 Studio 的 uploadId、本地路徑或內部任務標識：

{
  "input": {
    "first_frame": {
      "type": "file",
      "file_id": "00000000-0000-4000-8000-000000000001"
    }
  }
}

上面的 UUID 是佔位符。支援 PNG、JPEG 和 WebP；multipart 預設限制為 20 MB，服務還會校驗圖片解碼與尺寸。應處理服務返回的限制錯誤，而不是隻相信副檔名或 MIME 宣告。

方案 B：內聯 Base64

{
  "type": "base64",
  "media_type": "image/png",
  "data": "<PURE_BASE64_IMAGE_BYTES>"
}

傳入純 Base64，不要包含 data:image/...;base64, 字首。解碼後單張上限 10 MB，請求內全部內聯圖片合計上限 20 MB。Base64/JSON 傳輸體積大於原始檔案；較大或反覆使用的圖片優先先上傳。

建立任務被接受前，Base64 內容會先持久化。冪等重試時應保持原始位元組不變。

方案 C：公開 HTTPS 地址

{
  "type": "url",
  "url": "https://your-public-image-host.example/character.png"
}

把示例域名換成實際可訪問的圖片地址。服務端必須能在沒有瀏覽器 Cookie 的情況下取得圖片。要求公開 HTTPS、443 埠，不能有內嵌使用者名稱密碼或 fragment。私網、迴環和鏈路本地地址會被阻止，跳轉目標也會重新校驗。

報價和建立期間，應保持該地址的圖片位元組穩定。不要使用內網地址或返回登入頁的 URL。帶簽名的輸入連結同樣敏感，而且可能過期。

匹配模型能力

每次生成都需要首幀。尾幀和額外參考圖是否可用，取決於即時模型的模式支援；請求 Schema 的總上限不能覆蓋更低的模型專屬上限。

通過 GET /models 獲取合法模式與引數，並對計劃提交的完整請求先報價。透明素材要求見透明動畫，完整呼叫見快速開始。