認証と画像入力
APIキーをサーバー側で守り、必要な権限を選び、画像をファイルID、Base64、公開HTTPS URLで渡します。
このページの目次
信頼できる環境から認証する
公開APIにはAuthorization: Bearer <API_KEY>を使います。キーの平文はアカウント → 開発者で作成時だけ表示されます。秘密管理に保存し、新キーへの切り替え後に旧キーを失効させ、ヘッダーを記録しないでください。
認証済みアカウントが必要です。登録直後の基準上限は同時ジョブ1、待機キュー3、作成3回/分、その他60回/分です。有効な購読はアカウント単位の上限を上げます。現在のプラン、スコープ、上限はGET /account、残高はGET /credits/balanceで確認します。
| 公開APIキーのスコープ | 操作 |
|---|---|
animations:read |
アカウント、残高、モデル、タスク取得・一覧、素材検索 |
animations:write |
ファイルアップロード、見積もり、タスク作成、中止要求 |
MCPは別の細かなOAuthスコープを使うため、この表を流用しないでください。
方法A:一度アップロードしてファイルIDを再利用する
curl --fail-with-body https://api.animgen.com/v1/files \
-H "Authorization: Bearer $ANIMGEN_API_KEY" \
-F "file=@character.png"
応答にはid、MIME、寸法、バイト数、SHA-256が含まれます。StudioのuploadId、ローカルパス、内部ジョブIDではなく返されたIDを使います。
{
"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>"
}
data:image/...;base64,を付けず純粋なBase64を送ります。復号後の上限は1画像10 MB、1リクエスト中のインライン画像合計20 MBです。JSON/Base64は生ファイルより転送量が増えます。大きい画像や反復利用はアップロードを選びます。作成受理前に内容は保存されるため、冪等な再試行では同じバイト列を保ちます。
方法C:公開HTTPS URL
{
"type": "url",
"url": "https://your-public-image-host.example/character.png"
}
例のホスト名を実在し、サーバーからブラウザーCookieなしで取得できる画像URLに置き換えます。公開HTTPSの443番ポートが必要で、埋め込み認証情報やフラグメントは使えません。プライベート、ループバック、リンクローカル宛ては拒否され、リダイレクト先も検査されます。見積もりから作成まで内容を変えず、ログインページを返すURLは使わないでください。署名付き入力URLは機密で期限切れにもなります。
選択モデルに合わせる
すべての生成に開始フレームが必要です。終了フレームや追加参照画像は現在のモデルが対応する場合だけ使えます。スキーマ全体の上限より小さいモデル固有上限が優先されます。GET /modelsでモードと設定を確認し、意図した全内容で見積もってから作成します。透過元画像は透過アニメーション、実行順序はクイックスタートを参照してください。
動作参照動画
supports_reference_video=true のモデルを選び、reference_video の制限を確認します。filename、mime_type、byte_size で POST /v1/video-uploads を呼び、返されたURLとヘッダーでバイトをPUTします(API/OAuth認証情報は付けません)。続いて POST /v1/video-uploads/{upload_id}/complete でfile_idを取得します。非公開MP4/MOV/WebMは最大100 MiB、2–30秒です。所有する動画素材はsource.type=assetとasset_idで再利用できます。動画とキャラクター画像は同じワークスペースに置きます。
動画生成またはワンクリック生成の input.reference_video に参照を渡します。選択区間は2–5秒で、モデル側のより短い上限にも従います。開始と長さは四捨五入で1/24秒に正規化され、見積もりと生成で共有されます。processing の既定値はoriginalで、元の映像の外観や効果も参照します。必要な場合はdepthを明示的に選択できますが、深度変換には追加の処理時間がかかります。画像はキャラクター参照となり、固定先頭フレームではありません。last_frameとは併用できません。動画見積もりのrequest.reference_videoにはsourceを除いた同じ区間を渡します。アップロードや見積もりは深度処理を開始せず、有効にした場合のみ送信後の生成Workerが処理します。
{
"input": {
"first_frame": {
"type": "file",
"file_id": "00000000-0000-4000-8000-000000000001"
},
"reference_video": {
"source": {
"type": "file",
"file_id": "00000000-0000-4000-8000-000000000008"
},
"start_seconds": 1,
"duration_seconds": 2,
"processing": "original"
}
}
}
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー