Developers
finalgen API で構築する
動画と画像の生成をひとつの REST API で。credits はモデルごとに課金——カタログに各モデルの正確なコストを掲載しています。
モデル
ライブカタログは GET /api/v1/models から——アプリ内ジェネレーターと同じソースです。
料金
credits はモデルごとに課金——各モデルの正確なコストは上のカタログに記載(サーバー側の単一ソース、GET /api/v1/models と同じ)。
Playground
インタラクティブな Playground は準備中——今はターミナルで以下のサンプルから API をお試しください。
⚡ Playground — 公開 API キーのリリースとともに提供予定
サンプル
curl
curl -X POST https://finalgen.ai/api/v1/generations \
-H "Content-Type: application/json" \
-b "finalgen_session=<your session cookie>" \
-d '{
"modality": "video",
"mode": "text",
"prompt": "A drone shot over neon city rooftops at dusk",
"model": "glm-5.3",
"params": { "resolution": "720p", "duration": 5, "aspectRatio": "16:9", "seed": 42 }
}'TypeScript
const res = await fetch("https://finalgen.ai/api/v1/generations", {
method: "POST",
credentials: "include",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
modality: "video",
mode: "text",
prompt: "A drone shot over neon city rooftops at dusk",
model: "glm-5.3",
params: { resolution: "720p", duration: 5, aspectRatio: "16:9", seed: 42 },
}),
});
const { jobId } = await res.json(); // 202 -> poll /api/v1/generations/:idエンドポイント
- POST
/api/v1/auth/register— アカウント作成、セッション cookie を返します - GET
/api/v1/models— モデルカタログ - POST
/api/v1/generations— ジョブを投入(202 + jobId) - GET
/api/v1/generations/:id— ジョブステータスをポーリング - GET
/api/v1/generations/:id/download— 生成結果をダウンロード - POST
/api/v1/topup/checkout— Stripe Checkout で credits を購入(session-id + リダイレクト URL)