开发者

基于 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 + 跳转链接）