mousou.ai API

プログラムから mousou.ai の動画生成エンジンを呼び出すためのREST APIです。v1（ベータ）。仕様変更の可能性あり。

認証

マイページ →「アカウント管理」→「APIキー」から発行したキーを Authorization: Bearer mk_live_xxx ヘッダで送ってください。キーは1ユーザーにつき最大5個まで。発行時のみ全文が表示されます。

POST /api/v1/videos

動画生成ジョブをキュー投入します。即時に id を返却。完成までは GET /api/v1/videos/{id} をポーリングしてください。

リクエスト例

curl -X POST https://mousou.ai/api/v1/videos \ -H "Authorization: Bearer mk_live_xxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "prompt": "海辺を走る犬。スローモーション、夕日。", "model": "seedance", "duration": 5, "aspect_ratio": "16:9", "resolution": "720p" }'

パラメータ

名前	型	必須	説明
`prompt`	string	○	4000文字以内
`model`	string		`seedance` / `veo3` / `runway` / `luma` / `kling` / `hailuo02` / `minimax` / `hunyuan` / `mochi`。デフォルト `seedance`
`duration`	integer		5 / 10 / 15。デフォルト 5
`aspect_ratio`	string		`16:9` / `9:16` / `1:1` など
`resolution`	string		`720p` / `1080p`（モデルにより対応有無）
`image_url`	string		参照画像のURL（image-to-video対応モデルのみ）
`seedance_variant`	string		`fast` でSeedance Fast モード（コスト約20%減）

レスポンス例

{ "id": "req_abc123...", "status": "queued", "model": "seedance", "credits_used": 4500, "credits_remaining": 95500 }

GET /api/v1/videos/{id}

ジョブの状態を取得します。完了すると video_url が返ります。

curl https://mousou.ai/api/v1/videos/req_abc123 \ -H "Authorization: Bearer mk_live_xxxxxxxxxxxxxxxx" { "id": "req_abc123...", "status": "completed", "video_url": "https://fal.media/files/...mp4", "model": "seedance", "credits_used": 4500, "created_at": "2026-04-20T08:00:00Z", "updated_at": "2026-04-20T08:01:30Z" }

status は queued / processing / completed / failed。失敗時は消費クレジットが自動返還されます。

レート制限

APIキーごとに 20リクエスト/分。超過すると 429 Too Many Requests と Retry-After ヘッダを返します。

エラー形式

{ "error": { "code": "insufficient_credits", "message": "Need 9000C, have 1500C" } }

主要コード: unauthorized / bad_request / insufficient_credits (402) / not_found / provider_error (502)

料金

Webサービスと共通のクレジットプールから消費されます。料金はマイページの料金表参照。Web経由とAPI経由で単価は同じです。

サポート

バグ報告・質問はお問い合わせフォームまたは info@appx-net.com まで。法人向けの専用プラン・SLA・Webhook通知が必要な場合もご相談ください。