4言語で実行できるAPIサンプル

ワークフローを選ぶ

各例は現在のモデル取得、作成前の見積もり、非公開状態の保存、同一タスクの確認、実際のバイトの保存を行います。学習用であり本番SDKではありません。実行前にコードを読んでください。

サンプルREADMEと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キーのIDが含まれますが秘密キーは含まれません。バージョン管理外の私的な場所に置き、WindowsのACLも自分で制限してください。TypeScript／C#／cURLの保存先は任意のANIMGEN_OUTPUT、Pythonは--outputです。

作成結果が不明なら状態、アカウント、元のAPIキー主体、本文、冪等性キーを保ちます。キーを変えると重複排除の範囲も変わります。例は未解決の作成の自動復旧を24時間後に停止します。ローカルタイムアウトはリモート中止ではありません。タスクIDがあれば再実行はそのタスクの確認から再開します。失敗・中止でも素材があれば保存してから非ゼロで終了します。署名付きURLへBearerヘッダーは付けず、期限切れなら素材情報から更新します。

検証された範囲

Python、TypeScript、cURLでは見積もりのみの準備、承認を要する作成、状態保持、確認、部分結果の保存をモックで検証しています。PythonとTypeScriptでは作成応答喪失後の元キーでの再試行も模擬しています。文書試験に有料の提供元呼び出しは含まれません。C#は構文だけ検証済みで、実利用前に.NET 8でビルドとレビューが必要です。エラーと再試行、状態確認とダウンロードも参照してください。