これは便宜上提供される翻訳です。技術的に正式なリファレンスは英語版であり、相違がある場合は英語の本文が優先されます。
認証
すべてのリクエストにはAPIキーが必要で、次のいずれかのヘッダーで送信します：
ダッシュボードの「APIキー」パネルからキーを作成します。平文のキーは作成時に一度だけ表示されます — 紛失した場合は、失効させて新しいものを生成してください。有効なキーは同時に最大10個まで持てます。すべてが1つのクレジット残高を共有します。
クレジットと料金
各ファイルの料金は処理された長さ1秒あたり1クレジット、最低3クレジットです — 2秒のクリップでも3クレジットの下限がかかり、10秒のクリップは10かかります。クレジットは、ジョブの送信時（処理開始前）に、ファイル自体の長さに基づいて差し引かれます。ファイルごとの一律料金ではありません。バッチリクエストは、バッチ内のすべてのファイルに対して前もって課金されます — 残高がバッチ全体をカバーできない場合、その中には何も作成されません。ファイルが読み取り不能であることが判明した場合、そのファイルのクレジットは自動的に返金されます。
| プラン | クレジット | 価格 |
|---|---|---|
| クレジットパック — マイクロ | 15（無期限） | $1.99 |
| クレジットパック — ライト | 150（無期限） | $9.99 |
| クレジットパック — ヘビー | 900（無期限） | $39.99 |
| Plus 四半期 | 2,700 / 四半期 | $79.99/四半期 |
| Pro 月額 | 3,000 / 月 | $79.99/月 |
| Pro 年額 | 36,000 / 年 | $799.99/年 |
クレジットは個々のキーではなくアカウントに紐づいています — 作成したすべてのキーが同じプールから引き出します。GET /api/account でいつでも残高を確認できます（APIキー認証ではなく、ダッシュボードセッション認証）。
ファイルの送信 — POST /api/v1/jobs
Multipart フォームデータ：
| フィールド | 値 | 備考 |
|---|---|---|
file | 必須 | .gif, .mp4, .mov, .webm |
method | auto (デフォルト) · fast · rembg | fast はAIセグメンテーションの代わりにフラッドフィルを使用します — 高速で、単色背景で最も効果的です |
tolerance | 8–32 (デフォルト 16) | method=fast でのみ使用されます |
crop | true (デフォルト) · false | 被写体のバウンディングボックスに自動でトリミングします |
pad | 0–50 px (デフォルト 12) | トリミングの周囲に残す余白 |
canvasW / canvasH | px | 出力キャンバスサイズ。省略すると元のサイズを維持します |
anchor | center (デフォルト) · bottom | キャンバスに合わせて拡大縮小する際の被写体の配置 |
outputFormat | gif (デフォルト) · apng · webm · mp4 | mp4 に関する下記の注記を参照 |
bgColor | transparent (デフォルト) · #rrggbb | mp4 には必須 |
trim | true · false (デフォルト) | 先頭/末尾のアイドルフレームを自動でトリミングします — GIFソースのみ |
mp4 出力にはアルファチャンネルがないため、単色の bgColor と組み合わせた場合にのみ意味があります — 透明な背景で mp4 を要求すると、自動的に gif にフォールバックします。
レスポンス 202：
ステータスの取得 — GET /api/v1/jobs/:id
previewUrl はプレビューが利用可能になると表示されます。downloadUrl は status が done になったときのみ表示されます。ジョブはそれを作成したAPIキーにのみ表示されます — 他のすべてのキーは 404 を受け取ります。
プレビューとダウンロード
GET /api/v1/jobs/:id/preview と GET /api/v1/jobs/:id/download は、他のすべての呼び出しと同じ方法で認証され、ファイルを直接ストリーミングします — 別途のダウンロードトークンは不要です。
バッチ — POST /api/v1/batches
POST /api/v1/jobs と同じフィールドですが、file フィールドをファイルごとに1回繰り返します（1リクエストあたり最大 20ファイル）。1つのオプションセットがバッチ内のすべてのファイルに適用されます。
GET /api/v1/batches/:id は { "id", "status": "processing | partial | done", "jobs": [...] } を返し、各エントリは GET /api/v1/jobs/:id と同じ形式です。
エラー
| ステータス | ボディ | 意味 |
|---|---|---|
401 | { "error": "unauthorized" } | APIキーが欠落、無効、または失効している |
402 | { "error": "insufficient_credits", "creditsRemaining" } | クレジット不足 — ジョブは作成されませんでした |
400 | { "error": "bad_request" } | 有効なファイルがない、または不正な形式のmultipartボディ |
422 | { "error": "unreadable_file" } | ファイルを解析できませんでした — クレジットは請求されません |
404 | { "error": "not_found" } | ジョブ/バッチが存在しない、または別のキーに属している |
429 | { "error": "rate_limited" } | リクエストが多すぎます — Retry-After ヘッダーを参照 |
レート制限
リクエストはAPIキーごとにレート制限されます。レート制限された場合、レスポンスに Retry-After ヘッダー（秒）が含まれます — その時間だけ待ってから再試行してください。本番統合でより高い制限が必要ですか？ダッシュボードからお問い合わせください。