可运行的 API 示例

从「API 与额度」创建个人 Key，只放环境变量。MOTIONGIT_BASE_URL 默认本地 8095，可改为你的实际本地端口或官方服务。每种语言均支持 ACTION=me/search/download/image 四个完整示例。

export MOTIONGIT_BASE_URL=http://127.0.0.1:8095
# 用自己的 Key 配置 MOTIONGIT_API_KEY；不要提交到仓库。
ACTION=me sh docs/api-examples/curl.sh
ACTION=search QUERY=增长 node docs/api-examples/node.mjs
ACTION=download PRESET=growth OUTPUT=sticker.json python3 docs/api-examples/python.py
ACTION=image OUTPUT=generated.png node docs/api-examples/node.mjs

同一个 ACTION 可用于任意语言。Node/Python 的 image 示例成功后继续下载返回的资产 URL；curl image 输出 URL，可用同样 Bearer 头下载。curl download 在终端输出 Lottie JSON，可重定向到文件。库里实际 preset 以 search 返回值为准。生图内测尚未启用时返回 503 not_enabled，不会扣点；这也是本地验收覆盖的正常分支。429 的等待秒数位于 error.retry_after。

完整契约见 OpenAPI。示例不会创建 Key、修改服务配置或自动重试付费请求。

creator.mjs 默认仅报价，设置 MOTIONGIT_TASK_ID 仅查询旧任务。加 --submit 并明确 MOTIONGIT_MAX_CREDITS 才会新建生成操作；网络重试必须复用同一正文与幂等键。