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)