四种语言的完整调用示例

选择完整工作流

每个示例都会发现当前模型、先报价、保存私有状态、轮询同一个任务，并下载实际文件字节。它们是教学示例，不是生产 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 环境编译并审阅。

适配自己的项目时，继续阅读错误与重试及轮询与下载。