四種語言的完整呼叫示例

選擇完整工作流

每個示例都會發現當前模型、先報價、儲存私有狀態、輪詢同一個任務，並下載實際檔案位元組。它們是教學示例，不是生產 SDK。下載後先審閱程式碼再執行。

先閱讀示例完整說明和 API 快速開始。準確引數以自動生成的 API 參考為準。

準備請求，不啟動付費任務

私密提供 ANIMGEN_API_KEY，把 IMAGE_PATH 設為原圖路徑，ANIMGEN_MODEL 設為 GET /v1/models 返回的模型 ID。第一次執行 TypeScript、cURL 或 C# 時，不要設定 ANIMGEN_APPROVE_CREDITS。帳戶需要完成郵箱驗證，正式生成還需點數充足。

根據所選語言，只執行對應命令：

# TypeScript
node --experimental-strip-types typescript.ts

# cURL
bash curl.sh

# C#：把两个下载文件放入同一个独立目录
dotnet build AnimGenPublicApiExample.csproj
dotnet run --project AnimGenPublicApiExample.csproj

Python 使用快速開始中分開的 prepare 和 run 命令。其他語言會在顯示報價後停止；核對報價後，明確設定接受的 ANIMGEN_APPROVE_CREDITS，再使用原狀態重跑同一命令。

保護狀態，並恢復同一個操作

TypeScript 和 C# 使用 ANIMGEN_STATE（預設 animgen-state.json）；cURL 使用 ANIMGEN_STATE_DIR（預設 animgen-curl-state）；Python 使用 --state。狀態格式不同，不要切換語言來重試同一個操作。每份狀態只執行一個程序。

狀態包含原圖與提示詞，應放在版本控制之外的私有目錄。它儲存帳戶與 API Key 的 ID，但不儲存金鑰。Windows 下請自行限制目錄 ACL。TypeScript/C#/cURL 可通過 ANIMGEN_OUTPUT 選擇輸出目錄，Python 使用 --output。

建立響應不明確時，保留原狀態、帳戶、原 API Key 身份、請求體及冪等鍵。切換 Key 會改變服務端冪等作用域。示例對超過 24 小時仍未知的建立停止自動恢復。本地超時不等於遠端任務取消。

已儲存任務 ID 後，重跑只輪詢該任務，不再建立。失敗或取消的任務仍可能有資產，示例會儲存它們，再以非零退出碼報告結果不完整。簽名下載不攜帶 API Authorization 請求頭；連結過期後通過資產後設資料獲取新連結。

驗收範圍

Python、TypeScript、cURL 通過 Mock 驗證只報價、受控建立、狀態複用、輪詢及部分資產下載。Python/TypeScript 還模擬建立響應丟失，並核對重試沿用原冪等鍵。文件驗收不呼叫付費供應商。C# 目前僅通過語法檢查；實際使用前請在 .NET 8 環境編譯並審閱。

適配自己的專案時，繼續閱讀錯誤與重試及輪詢與下載。