ClipMixAI デベロッパー API 正式公開 — 動画翻訳・AI 音楽・アバターをコードで自動化

本日、ClipMixAI ウェブアプリを支えるエンジンを、その上で何かを構築したいすべての人に公開します。api.clipmixai.com/api/v1 の新しいデベロッパー API は、動画翻訳・メモリービデオ・フェイススワップ＆アバター・AI 音楽の 4 つのサービスを、単一の Bearer トークン REST インターフェースで提供します。同じモデル、同じ品質、同じクレジット。サブスクリプション不要。最低利用額なし。

詳細を読む前に確認したい方は：マーケティング概要、リファレンス、キーの作成。

なぜ作ったのか

この 1 年、有料ユーザーが同じ操作を繰り返すのを目の当たりにしてきました――ダッシュボードを開き、30 枚の写真をアップロードし、作成ボタンを押し、楽曲ができるのを待ち、手動で結果を別の編集ツールへ移す。クリエイターのコンテンツを 10 言語に翻訳する起業家、週に 100 本のブランド動画を制作するエージェンシー、プロトタイプ向けの仮音楽を生成するインディーゲームスタジオ。誰もが最終的に同じ質問をしていました――「API はありますか？」

答えは「あります」。それらのワークフローをすべて支えてきた 4 つのサービスが、コードから直接呼び出せるようになりました――ダッシュボードを経由することなく、各プロバイダーの独自仕様を習得することなく、ウェブアプリで既に理解しているのと同じクレジット単価で。1 人がこなすのに 1 時間かかったワークフローが、バックグラウンドの CRON ジョブで完結できるようになる――それが目指す成果です。

クイックスタート

ダッシュボードからキーを生成し、以下を実行してください：

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

即座に job-id と status: "processing" が返されます。GET /v1/music/{id} をポーリングしてステータスが completed に変わるのを待つか――より良い方法として――キー作成時に Webhook を設定しておけば、完了した結果をあなたのエンドポイントへ POST します。送信元が私たちであることを検証できるよう、HMAC-SHA256 で署名されています。

以前は未提供だった、デベロッパーからの 3 つの要望

1. サンドボックスキー

すべての API キーにはモードがあります：sk_live_ はクレジットを消費して実際のプロバイダーを呼び出し、sk_test_ は一切課金せず、プロバイダーも呼び出さず、ボディに test: true を含む合成 completed ジョブを返します。CI でサンドボックスキーを使えば、クレジットを消費せずに統合を検証でき、実際の出力が必要になったらライブキーに切り替えられます。

サンドボックスキーは全員無料で使えます――無料プランのアカウントも含めて。ライブキーを使う唯一の条件は、クレジットを 1 回以上購入済みであること。ウェブアプリと同じ支払い確認でアクセスを制御しています。

2. すべての POST に Idempotency-Key

ネットワークリトライは、課金が絡む API における最大の悩みです。私たちは Stripe のソリューションを採用しました：作成リクエストに Idempotency-Key: <文字列> を付与すると、サーバーは 24 時間レスポンスをキャッシュします。同じキー＋同じボディでリトライすると元のレスポンスが返され、二重請求は発生しません。同じキーで異なるボディを送ると 422 idempotency_key_reuse が返り、誤ったジョブを黙って生成する代わりにバグを発見できます。

公式 SDK ではどちらも単一のキーワード引数として利用できます：

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. テスト送信ボタン付き Webhook

キーにコールバック URL を設定すると、ジョブが完了するたびに job.completed / job.failed イベントを POST します。各配信には X-ClipMix-Signature: sha256=<hex> に HMAC 署名が含まれており、どちらの SDK のヘルパーでも 1 行で検証できます。配信失敗時は指数バックオフでリトライされます（0 秒 → 30 秒 → 5 分 → 1 時間、計 4 回）。

ダッシュボードにはテスト送信ボタンがあり、実際のジョブを待たずにエンドポイントの署名・パース処理を検証できるよう、合成 webhook.test イベントを送信します。同じパネルにキーごとの配信ログが 100 件表示されるので、問題が起きてもどこで失敗したかを推測する必要はありません。

すでに見られている 3 つのユースケース

クリエイター向け一括動画翻訳

動画を 1 本アップロードすると、オプションで話者のトーンを保持したボイスクローニングを使い、10 言語に吹き替えた 10 バージョンを取得できます。ある YouTube クリエイターが毎週のポッドキャストを 9 言語に自動翻訳しています――API コールは既存の公開フックから発火され、Webhook が吹き替え済みファイルを CMS に投入します。

顧客ごとのブランド動画

写真からメモリービデオを生成できるため、EC サイトが顧客の商品写真を元に、その出品に最適化した短い映像広告を生成できます。family-videos エンドポイントはコンシューマー UI 向けに作った 4 つのモード（Moment、Story、Album、Chronicle）を公開しており、エージェンシーがホワイトラベルツールの内部エンジンとして活用しています。

ゲームオーディオのプロトタイピング

インディースタジオが社内アセットパイプラインから /v1/music エンドポイントを呼び出しています。ゲームデザイナーがムードと仮歌詞を入力すると、10 分後に 60 秒のトラックがプロジェクトの音声フォルダに届きます。バリエーションのたびにサウンドデザイナーを待つのではなく、数秒で仮音楽をイテレーションできます。

バージョニングと私たちのコミットメント

v1 は安定版です。/api/v1/ 内に破壊的変更を加えることはありません――新しいフィールドと新しいエンドポイントは追加のみで、既存の仕様はそのまま維持されます。やむを得ず変更が必要な場合（まれ）は、移行期間を告知した上で /api/v2/ 以下でリリースします。changelog が信頼できる唯一の情報源です。

稼働状況は /api/status でリアルタイムに確認できます――直近 5 分間の実トラフィックから導出されたサービスごとのヘルス状況で、60 秒ごとに更新され、オンコール担当者が見るものと同じビューです。

料金

ウェブアプリと同じウォレットです。$1 = 100 クレジット、トップアップ時の既存ボリュームボーナスも適用されます。60 秒の楽曲は 60 クレジット（$0.60）。バランスドティアのトーキングヘッドアバター 30 秒は 450 クレジット。1 分の動画をプレミアムティアで翻訳すると約 190 クレジット。サンドボックスキーは無料です。

ティア制 API プラン（Pro / Business / Enterprise）と大量割引・優先ワーカーは近日提供予定です。今すぐ利用を検討している方は こちらのフォームにメールアドレスをご登録ください。リリース時にお知らせします。

試してみる

• 5 分でわかる概要
• リファレンス（認証・冪等性・Webhook・サンドボックス・エラー・SDK）
• サービスのリアルタイム稼働状況
• リリース済み機能と今後の予定
• 最初のキーを作成する

バグ報告・機能リクエスト：GitHub Issues。その他のお問い合わせ：support@clipmixai.com。