빠른 시작

AI 스튜디오 API

몇 단계만으로 AI 영상 생성을 앱에 연결하고, 언제든 진행 상황을 확인하며, 크레딧으로 결제하세요.

쉬운 통합

AI 동영상 만들기

크레딧으로 결제하기

간단한 작업 흐름

curl -X POST "https://freesoragenerator.com/api/ai-studio/execute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "video:sora2-text-to-video-standard",
    "isPublic": true,
    "payload": {
      "model": "video:sora2-text-to-video-standard",
      "input": {
        "prompt": "A cinematic video of a cat walking in the rain"
      }
    }
  }'
빠른 시작

작동 원리

계정 설정부터 최종 비디오 결과를 얻기까지.

1

로그인하거나 계정을 만드세요

2

대시보드에서 API 키를 생성하세요

3

Call the video generation endpoint with your API Key

4

작업이 대기열에 추가될 때 생성 결과를 조회합니다

5

최근 세대 기록을 읽으세요

6

사용자 프로필, 크레딧 및 회원 상태를 확인하세요

인증

API 키를 사용하세요

로그인 후 API 키를 생성한 다음, 모든 요청의 Authorization 헤더에 포함하세요.

필수 요청 헤더

로그인 후 API 키를 생성한 다음, 모든 API 요청에 그것을 포함하세요.

Authorization: Bearer YOUR_API_KEY

The example domain is automatically resolved from NEXT_PUBLIC_SITE_URL. Replace only YOUR_API_KEY with the key generated in your account.

요청
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
엔드포인트

사용 가능한 API 호출

These are the live endpoints currently used by AI Video Studio.

POST/api/ai-studio/execute

Start a new generation task. The request uses modelId, isPublic, and payload.

요청 헤더

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

요청 매개변수

이름타입필수기본값옵션설명
modelIdstring-video:grok-imagine-text-to-video, video:grok-imagine-image-to-video, video:grok-imagine-video-upscale, video:grok-imagine-video-extend, video:grok-imagine-video-1-5-preview, video:fal-xai-grok-imagine-video-text-to-video, video:fal-xai-grok-imagine-video-image-to-video, video:fal-xai-grok-imagine-video-v1-5-image-to-video, video:fal-xai-grok-imagine-video-reference-to-video, video:fal-xai-grok-imagine-video-edit-video, video:am-omni-flash-ext, video:gemini-omni-video, video:gemini-omni-character, video:gemini-omni-audio, video:bytedance-seedance-2, video:bytedance-seedance-2-0-fast, video:bytedance-seedance-2-0-mini, video:fal-bytedance-seedance-2-0-text-to-video, video:fal-bytedance-seedance-2-0-fast-text-to-video, video:fal-bytedance-seedance-2-0-image-to-video, video:fal-bytedance-seedance-2-0-fast-image-to-video, video:fal-bytedance-seedance-2-0-reference-to-video, video:fal-bytedance-seedance-2-0-fast-reference-to-video, video:fal-bytedance-seedance-2-0-mini-text-to-video, video:fal-bytedance-seedance-2-0-mini-image-to-video, video:fal-bytedance-seedance-2-0-mini-reference-to-video, video:bytedance-seedance-1-5-pro, video:fal-fal-ai-bytedance-seedance-v1-5-pro-text-to-video, video:fal-fal-ai-bytedance-seedance-v1-5-pro-image-to-video, video:bytedance-v1-pro-text-to-video, video:bytedance-v1-pro-image-to-video, video:bytedance-v1-lite-text-to-video, video:bytedance-v1-lite-image-to-video, video:bytedance-v1-pro-fast-image-to-video, video:veo-3.1-lite, video:veo-3.1-fast, video:veo-3.1-quality, video:extend-veo3-1-video, video:get-veo3-1-1080p-video, video:get-veo3-1-4k-video, video:fal-fal-ai-veo3-1, video:fal-fal-ai-veo3-1-fast, video:fal-fal-ai-veo3-1-image-to-video, video:fal-fal-ai-veo3-1-fast-image-to-video, video:fal-fal-ai-veo3, video:fal-fal-ai-veo3-fast, video:sora2-text-to-video-standard, video:sora2-image-to-video-standard, video:sora2-pro-text-to-video, video:sora2-pro-image-to-video, video:sora2-pro-storyboard, video:sora2-official, video:fal-fal-ai-sora-2-text-to-video, video:fal-fal-ai-sora-2-image-to-video, video:fal-fal-ai-sora-2-text-to-video-pro, video:fal-fal-ai-sora-2-image-to-video-pro, video:fal-fal-ai-sora-2-video-to-video-remix, video:kling-3-0, video:kling-3-0-motion-control, video:kling-v3-turbo-text-to-video, video:kling-v3-turbo-image-to-video, video:kling-2-6-text-to-video, video:kling-2-6-image-to-video, video:kling-2-6-motion-control, video:kling-v2-5-turbo-text-to-video-pro, video:kling-v2-5-turbo-image-to-video-pro, video:kling-v2-1-master-text-to-video, video:kling-v2-1-master-image-to-video, video:kling-v2-1-pro, video:kling-v2-1-standard, video:kling-ai-avatar-standard, video:kling-ai-avatar-pro, video:fal-fal-ai-kling-video-v3-pro-text-to-video, video:fal-fal-ai-kling-video-v3-standard-text-to-video, video:fal-fal-ai-kling-video-v3-pro-image-to-video, video:fal-fal-ai-kling-video-v3-standard-image-to-video, video:fal-fal-ai-kling-video-v3-4k-image-to-video, video:fal-fal-ai-kling-video-v3-4k-text-to-video, video:fal-fal-ai-kling-video-o1-image-to-video, video:fal-fal-ai-kling-video-v2-6-pro-text-to-video, video:fal-fal-ai-kling-video-v2-6-pro-image-to-video, video:fal-fal-ai-kling-video-v2-6-standard-motion-control, video:wan-2-7-text-to-video, video:wan-2-7-image-to-video, video:wan-2-7-video-edit, video:wan-2-7-reference-to-video, video:wan-2-6-text-to-video, video:wan-2-6-image-to-video, video:wan-2-6-video-to-video, video:wan-2-5-text-to-video, video:wan-2-5-image-to-video, video:wan-text-to-video, video:wan-image-to-video, video:wan-2-2-a14b-speech-to-video-turbo, video:wan-animate-move, video:wan-animate-replace, video:fal-fal-ai-wan-v2-7-text-to-video, video:fal-fal-ai-wan-v2-7-image-to-video, video:fal-fal-ai-wan-v2-7-reference-to-video, video:happyhorse-text-to-video, video:happyhorse-image-to-video, video:happyhorse-reference-to-video, video:happyhorse-1-1-text-to-video, video:happyhorse-1-1-image-to-video, video:happyhorse-1-1-reference-to-video, video:fal-alibaba-happy-horse-text-to-video, video:fal-alibaba-happy-horse-image-to-video, video:fal-alibaba-happy-horse-reference-to-video, video:fal-alibaba-happy-horse-v1-1-text-to-video, video:fal-alibaba-happy-horse-v1-1-image-to-video, video:fal-alibaba-happy-horse-v1-1-reference-to-video, video:hailuo-standard-text-to-video, video:hailuo-standard-image-to-video, video:hailuo-pro-text-to-video, video:hailuo-pro-image-to-video, video:hailuo-2-3-standard-image-to-video, video:hailuo-2-3-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-02-standard-text-to-video, video:fal-fal-ai-minimax-hailuo-02-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-02-pro-text-to-video, video:fal-fal-ai-minimax-hailuo-02-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-02-fast-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-standard-text-to-video, video:fal-fal-ai-minimax-hailuo-2-3-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-pro-text-to-video, video:fal-fal-ai-minimax-hailuo-2-3-pro-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-fast-standard-image-to-video, video:fal-fal-ai-minimax-hailuo-2-3-fast-pro-image-to-video, video:generate-ai-video, video:generate-aleph-video, image:google-nano-banana-pro, image:google-nano-banana-2, image:google-nano-banana-2-lite, image:fal-fal-ai-gemini-3-1-flash-image-preview, image:fal-fal-ai-gemini-3-1-flash-image-preview-edit, image:fal-fal-ai-gemini-3-pro-image-preview, image:fal-fal-ai-gemini-3-pro-image-preview-edit, image:fal-fal-ai-nano-banana, image:fal-fal-ai-nano-banana-edit, image:fal-google-nano-banana-2-lite, image:gpt-image-2-text-to-image, image:gpt-image-2-image-to-image, image:ama-gpt-image-2, image:fal-openai-gpt-image-2, image:fal-openai-gpt-image-2-edit, image:fal-fal-ai-gpt-image-1-5, image:fal-fal-ai-gpt-image-1-5-edit, image:seedream5-0-lite-text-to-image, image:seedream5-0-lite-image-to-image, image:seedream5-0-pro-text-to-image, image:seedream5-0-pro-image-to-image, image:seedream4-5-text-to-image, image:seedream4-5-edit, image:fal-fal-ai-bytedance-seedream-v5-lite-text-to-image, image:fal-fal-ai-bytedance-seedream-v5-lite-edit, image:fal-bytedance-seedream-v5-pro-text-to-image, image:fal-bytedance-seedream-v5-pro-edit, image:fal-fal-ai-bytedance-seedream-v4-5-text-to-image, image:fal-fal-ai-bytedance-seedream-v4-5-edit, image:qwen2-text-to-image, image:qwen2-image-edit, image:fal-fal-ai-qwen-image-2-text-to-image, image:fal-fal-ai-qwen-image-2-edit, image:grok-imagine-text-to-image, image:grok-imagine-image-to-image, image:fal-xai-grok-imagine-image, image:fal-xai-grok-imagine-image-edit, image:fal-xai-grok-imagine-image-quality-text-to-image, image:fal-xai-grok-imagine-image-quality-edit, image:wan-2-7-image, image:wan-2-7-image-pro, image:fal-fal-ai-wan-v2-7-text-to-image, image:fal-fal-ai-wan-v2-7-edit, image:fal-fal-ai-wan-v2-7-pro-text-to-image, image:fal-fal-ai-wan-v2-7-pro-editModel ID for the video style/version you choose.
isPublicboolean아니요true-이 결과를 공개적으로 보여줄 수 있는지 여부입니다. 기본값은 참입니다.
payloadobject--생성을 위한 주요 입력 데이터입니다. 선택한 모델에 따라 중첩된 필드가 변경됩니다.See Dynamic payload fields by model
요청
curl -X POST "https://freesoragenerator.com/api/ai-studio/execute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "video:sora2-text-to-video-standard",
    "isPublic": true,
    "payload": {
      "model": "video:sora2-text-to-video-standard",
      "input": {
        "prompt": "A cinematic video of a cat walking in the rain"
      }
    }
  }'
응답 예시
{
  "success": true,
  "data": {
    "modelId": "video:sora2-text-to-video-standard",
    "generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
    "reservedCredits": 20,
    "taskId": "provider-task-id",
    "state": "queued",
    "raw": {},
    "selectedPricing": {}
  }
}
오류 예시
{
  "success": false,
  "error": "User not authenticated"
}
GET/api/ai-studio/tasks/{taskId}

작업 생성 후 taskId와 statusSupported=true가 반환되면 작업 진행 상황을 확인하십시오.

요청 헤더

Authorization: Bearer YOUR_API_KEY

요청 매개변수

이름타입필수기본값옵션설명
taskIdstring--생성을 시작한 후 반환된 작업 ID.
요청
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
응답 예시
{
  "success": true,
  "data": {
    "generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
    "taskId": "provider-task-id",
    "modelId": "video:sora2-text-to-video-standard",
    "state": "running",
    "mediaUrls": [],
    "raw": {},
    "reservedCredits": 20,
    "refundedCredits": 0
  }
}
오류 예시
{
  "success": false,
  "error": "Generation record not found"
}
GET/api/ai-studio/video-history?page={page}&limit={limit}&status={status}&q={q}

상태 및 키워드 필터로 페이지별 생성 기록을 가져옵니다.

요청 헤더

Authorization: Bearer YOUR_API_KEY

요청 매개변수

이름타입필수기본값옵션설명
pagenumber아니요1-기록 페이지 번호.
limitnumber아니요12-히스토리 목록 페이지 크기 (1-50).
statusstring아니요allall, pending, success, failed히스토리 리스트용 상태 필터.
qstring아니요""-히스토리를 검색하기 위한 선택적 키워드.
요청
curl -X GET "https://freesoragenerator.com/api/ai-studio/video-history?page=1&limit=12&status=all" \
  -H "Authorization: Bearer YOUR_API_KEY"
응답 예시
{
  "success": true,
  "data": {
    "records": [],
    "total": 0,
    "totalPages": 1,
    "page": 1
  }
}
오류 예시
{
  "success": false,
  "error": "Failed to load AI Studio generation history"
}
GET/api/auth/user

계정 프로필, 남은 크레딧 및 멤버십 요약을 확인하세요.

요청 헤더

Authorization: Bearer YOUR_API_KEY

요청 매개변수

요청 매개변수가 없습니다.

요청
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
응답 예시
{
  "success": true,
  "data": {
    "user": {
      "id": "user-id",
      "email": "developer@example.com",
      "role": "user",
      "name": "Developer",
      "image": null,
      "authType": "apikey"
    },
    "credits": 120,
    "membership": {
      "isVip": false,
      "level": "none",
      "planTitle": null
    }
  }
}
오류 예시
{
  "success": false,
  "error": "User not authenticated"
}
모델들

사용 가능한 모델 ID

원하는 출력에 맞는 모델 ID를 선택하세요.

가족버전modelId
Grok ImagineGrok Imagine Text to Videovideo:grok-imagine-text-to-video
Grok ImagineGrok Imagine Image to Videovideo:grok-imagine-image-to-video
Grok ImagineGrok Imagine Video Upscalevideo:grok-imagine-video-upscale
Grok ImagineGrok Imagine Video Extendvideo:grok-imagine-video-extend
Grok ImagineGrok Imagine Video 1.5 Previewvideo:grok-imagine-video-1-5-preview
Grok ImagineGrok Imagine Text to Videovideo:fal-xai-grok-imagine-video-text-to-video
Grok ImagineGrok Imagine Image to Videovideo:fal-xai-grok-imagine-video-image-to-video
Grok ImagineGrok Imagine 1.5 Image to Videovideo:fal-xai-grok-imagine-video-v1-5-image-to-video
Grok ImagineGrok Imagine Reference to Videovideo:fal-xai-grok-imagine-video-reference-to-video
Grok ImagineGrok Imagine Video Editvideo:fal-xai-grok-imagine-video-edit-video
Gemini OmniGemini Omni Flash Litevideo:am-omni-flash-ext
Gemini OmniGemini Omni Videovideo:gemini-omni-video
Gemini OmniGemini Omni Charactervideo:gemini-omni-character
Gemini OmniGemini Omni Audiovideo:gemini-omni-audio
Seedance 2.0Seedance 2.0video:bytedance-seedance-2
Seedance 2.0Seedance 2.0 Fastvideo:bytedance-seedance-2-0-fast
Seedance 2.0Seedance 2.0 Minivideo:bytedance-seedance-2-0-mini
Seedance 2.0Seedance 2.0 Text to Videovideo:fal-bytedance-seedance-2-0-text-to-video
Seedance 2.0Seedance 2.0 Fast Text to Videovideo:fal-bytedance-seedance-2-0-fast-text-to-video
Seedance 2.0Seedance 2.0 Image to Videovideo:fal-bytedance-seedance-2-0-image-to-video
Seedance 2.0Seedance 2.0 Fast Image to Videovideo:fal-bytedance-seedance-2-0-fast-image-to-video
Seedance 2.0Seedance 2.0 Reference to Videovideo:fal-bytedance-seedance-2-0-reference-to-video
Seedance 2.0Seedance 2.0 Fast Reference to Videovideo:fal-bytedance-seedance-2-0-fast-reference-to-video
Seedance 2.0Seedance 2.0 Mini Text to Videovideo:fal-bytedance-seedance-2-0-mini-text-to-video
Seedance 2.0Seedance 2.0 Mini Image to Videovideo:fal-bytedance-seedance-2-0-mini-image-to-video
Seedance 2.0Seedance 2.0 Mini Reference to Videovideo:fal-bytedance-seedance-2-0-mini-reference-to-video
Seedance 1.5 ProSeedance 1.5 Provideo:bytedance-seedance-1-5-pro
Seedance 1.5 ProSeedance 1.5 Pro Text to Videovideo:fal-fal-ai-bytedance-seedance-v1-5-pro-text-to-video
Seedance 1.5 ProSeedance 1.5 Pro Image to Videovideo:fal-fal-ai-bytedance-seedance-v1-5-pro-image-to-video
Seedance 1.0V1 Pro Text To Videovideo:bytedance-v1-pro-text-to-video
Seedance 1.0V1 Pro Image To Videovideo:bytedance-v1-pro-image-to-video
Seedance 1.0V1 Lite Text To Videovideo:bytedance-v1-lite-text-to-video
Seedance 1.0V1 Lite Image To Videovideo:bytedance-v1-lite-image-to-video
Seedance 1.0V1 Pro Fast Image To Videovideo:bytedance-v1-pro-fast-image-to-video
Veo 3.1Veo 3.1 Litevideo:veo-3.1-lite
Veo 3.1Veo 3.1 Fastvideo:veo-3.1-fast
Veo 3.1Veo 3.1 Qualityvideo:veo-3.1-quality
Veo 3.1Veo 3.1 Extendvideo:extend-veo3-1-video
Veo 3.1Veo 3.1 Get 1080Pvideo:get-veo3-1-1080p-video
Veo 3.1Veo 3.1 Get 4Kvideo:get-veo3-1-4k-video
Veo 3.1Veo 3.1video:fal-fal-ai-veo3-1
Veo 3.1Veo 3.1 Fastvideo:fal-fal-ai-veo3-1-fast
Veo 3.1Veo 3.1 Image to Videovideo:fal-fal-ai-veo3-1-image-to-video
Veo 3.1Veo 3.1 Fast Image to Videovideo:fal-fal-ai-veo3-1-fast-image-to-video
Veo 3.1Veo 3video:fal-fal-ai-veo3
Veo 3.1Veo 3 Fastvideo:fal-fal-ai-veo3-fast
Sora 2Sora 2 Text to Videovideo:sora2-text-to-video-standard
Sora 2Sora 2 Image to Videovideo:sora2-image-to-video-standard
Sora 2Sora 2 Pro Text to Videovideo:sora2-pro-text-to-video
Sora 2Sora 2 Pro Image to Videovideo:sora2-pro-image-to-video
Sora 2Sora 2 Pro Storyboardvideo:sora2-pro-storyboard
Sora 2Sora 2 Officialvideo:sora2-official
Sora 2Sora 2 Text to Videovideo:fal-fal-ai-sora-2-text-to-video
Sora 2Sora 2 Image to Videovideo:fal-fal-ai-sora-2-image-to-video
Sora 2Sora 2 Pro Text to Videovideo:fal-fal-ai-sora-2-text-to-video-pro
Sora 2Sora 2 Pro Image to Videovideo:fal-fal-ai-sora-2-image-to-video-pro
Sora 2Sora 2 Video Remixvideo:fal-fal-ai-sora-2-video-to-video-remix
KlingKling 3.0video:kling-3-0
KlingKling 3.0 Motion Controlvideo:kling-3-0-motion-control
KlingKling V3 Turbo Text to Videovideo:kling-v3-turbo-text-to-video
KlingKling V3 Turbo Image to Videovideo:kling-v3-turbo-image-to-video
KlingKling 2.6 Text to Videovideo:kling-2-6-text-to-video
KlingKling 2.6 Image to Videovideo:kling-2-6-image-to-video
KlingKling 2.6 Motion Controlvideo:kling-2-6-motion-control
KlingKling 2.5 Turbo Text to Video Provideo:kling-v2-5-turbo-text-to-video-pro
KlingKling 2.5 Turbo Image to Video Provideo:kling-v2-5-turbo-image-to-video-pro
KlingKling V2.1 Master Text to Videovideo:kling-v2-1-master-text-to-video
KlingKling V2.1 Master Image to Videovideo:kling-v2-1-master-image-to-video
KlingKling V2.1 Provideo:kling-v2-1-pro
KlingKling V2.1 Standardvideo:kling-v2-1-standard
KlingKling AI Avatar Standardvideo:kling-ai-avatar-standard
KlingKling AI Avatar Provideo:kling-ai-avatar-pro
KlingKling v3 Pro Text to Videovideo:fal-fal-ai-kling-video-v3-pro-text-to-video
KlingKling v3 Standard Text to Videovideo:fal-fal-ai-kling-video-v3-standard-text-to-video
KlingKling v3 Pro Image to Videovideo:fal-fal-ai-kling-video-v3-pro-image-to-video
KlingKling v3 Standard Image to Videovideo:fal-fal-ai-kling-video-v3-standard-image-to-video
KlingKling v3 4K Image to Videovideo:fal-fal-ai-kling-video-v3-4k-image-to-video
KlingKling v3 4K Text to Videovideo:fal-fal-ai-kling-video-v3-4k-text-to-video
KlingKling O1 Image to Videovideo:fal-fal-ai-kling-video-o1-image-to-video
KlingKling v2.6 Pro Text to Videovideo:fal-fal-ai-kling-video-v2-6-pro-text-to-video
KlingKling v2.6 Pro Image to Videovideo:fal-fal-ai-kling-video-v2-6-pro-image-to-video
KlingKling v2.6 Motion Controlvideo:fal-fal-ai-kling-video-v2-6-standard-motion-control
WanWan 2.7 Text to Videovideo:wan-2-7-text-to-video
WanWan 2.7 Image to Videovideo:wan-2-7-image-to-video
WanWan 2.7 Video Editvideo:wan-2-7-video-edit
WanWan 2.7 Reference to Videovideo:wan-2-7-reference-to-video
WanWan 2.6 Text to Videovideo:wan-2-6-text-to-video
WanWan 2.6 Image to Videovideo:wan-2-6-image-to-video
WanWan 2.6 Video to Videovideo:wan-2-6-video-to-video
WanWan 2.5 Text to Videovideo:wan-2-5-text-to-video
WanWan 2.5 Image to Videovideo:wan-2-5-image-to-video
WanWan Text to Videovideo:wan-text-to-video
WanWan Image to Videovideo:wan-image-to-video
WanWan 2.2 A14B Speech to Video Turbovideo:wan-2-2-a14b-speech-to-video-turbo
WanWan Animate Movevideo:wan-animate-move
WanWan Animate Replacevideo:wan-animate-replace
WanWan 2.7 Text to Videovideo:fal-fal-ai-wan-v2-7-text-to-video
WanWan 2.7 Image to Videovideo:fal-fal-ai-wan-v2-7-image-to-video
WanWan 2.7 Reference to Videovideo:fal-fal-ai-wan-v2-7-reference-to-video
HappyHorseHappyHorse Text to Videovideo:happyhorse-text-to-video
HappyHorseHappyHorse Image to Videovideo:happyhorse-image-to-video
HappyHorseHappyHorse Reference to Videovideo:happyhorse-reference-to-video
HappyHorseHappyHorse 1.1 Text to Videovideo:happyhorse-1-1-text-to-video
HappyHorseHappyHorse 1.1 Image to Videovideo:happyhorse-1-1-image-to-video
HappyHorseHappyHorse 1.1 Reference to Videovideo:happyhorse-1-1-reference-to-video
HappyHorseHappy Horse Text to Videovideo:fal-alibaba-happy-horse-text-to-video
HappyHorseHappy Horse Image to Videovideo:fal-alibaba-happy-horse-image-to-video
HappyHorseHappy Horse Reference to Videovideo:fal-alibaba-happy-horse-reference-to-video
HappyHorseHappy Horse 1.1 Text to Videovideo:fal-alibaba-happy-horse-v1-1-text-to-video
HappyHorseHappy Horse 1.1 Image to Videovideo:fal-alibaba-happy-horse-v1-1-image-to-video
HappyHorseHappy Horse 1.1 Reference to Videovideo:fal-alibaba-happy-horse-v1-1-reference-to-video
HailuoHailuo Standard Text to Videovideo:hailuo-standard-text-to-video
HailuoHailuo Standard Image to Videovideo:hailuo-standard-image-to-video
HailuoHailuo Pro Text to Videovideo:hailuo-pro-text-to-video
HailuoHailuo Pro Image to Videovideo:hailuo-pro-image-to-video
HailuoHailuo 2.3 Standard Image to Videovideo:hailuo-2-3-standard-image-to-video
HailuoHailuo 2.3 Pro Image to Videovideo:hailuo-2-3-pro-image-to-video
HailuoHailuo 02 Standard Text to Videovideo:fal-fal-ai-minimax-hailuo-02-standard-text-to-video
HailuoHailuo 02 Standard Image to Videovideo:fal-fal-ai-minimax-hailuo-02-standard-image-to-video
HailuoHailuo 02 Pro Text to Videovideo:fal-fal-ai-minimax-hailuo-02-pro-text-to-video
HailuoHailuo 02 Pro Image to Videovideo:fal-fal-ai-minimax-hailuo-02-pro-image-to-video
HailuoHailuo 02 Fast Image to Videovideo:fal-fal-ai-minimax-hailuo-02-fast-image-to-video
HailuoHailuo 2.3 Standard Text to Videovideo:fal-fal-ai-minimax-hailuo-2-3-standard-text-to-video
HailuoHailuo 2.3 Standard Image to Videovideo:fal-fal-ai-minimax-hailuo-2-3-standard-image-to-video
HailuoHailuo 2.3 Pro Text to Videovideo:fal-fal-ai-minimax-hailuo-2-3-pro-text-to-video
HailuoHailuo 2.3 Pro Image to Videovideo:fal-fal-ai-minimax-hailuo-2-3-pro-image-to-video
HailuoHailuo 2.3 Fast Standard Image to Videovideo:fal-fal-ai-minimax-hailuo-2-3-fast-standard-image-to-video
HailuoHailuo 2.3 Fast Pro Image to Videovideo:fal-fal-ai-minimax-hailuo-2-3-fast-pro-image-to-video
RunwayRunway Generate AI Videovideo:generate-ai-video
RunwayRunway Generate Aleph Videovideo:generate-aleph-video
Nano BananaNano Banana Proimage:google-nano-banana-pro
Nano BananaNano Banana 2image:google-nano-banana-2
Nano BananaNano Banana 2 Liteimage:google-nano-banana-2-lite
Nano BananaGemini 3.1 Flash Image Previewimage:fal-fal-ai-gemini-3-1-flash-image-preview
Nano BananaGemini 3.1 Flash Image Preview Editimage:fal-fal-ai-gemini-3-1-flash-image-preview-edit
Nano BananaGemini 3 Pro Image Previewimage:fal-fal-ai-gemini-3-pro-image-preview
Nano BananaGemini 3 Pro Image Preview Editimage:fal-fal-ai-gemini-3-pro-image-preview-edit
Nano BananaNano Bananaimage:fal-fal-ai-nano-banana
Nano BananaNano Banana Editimage:fal-fal-ai-nano-banana-edit
Nano BananaNano Banana 2 Liteimage:fal-google-nano-banana-2-lite
GPT Image 2Text to Imageimage:gpt-image-2-text-to-image
GPT Image 2Image to Imageimage:gpt-image-2-image-to-image
GPT Image 2Gpt image 2 Special offerimage:ama-gpt-image-2
GPT Image 2Gpt image 2image:fal-openai-gpt-image-2
GPT Image 2Gpt image 2 editimage:fal-openai-gpt-image-2-edit
GPT Image 2GPT Image 1.5image:fal-fal-ai-gpt-image-1-5
GPT Image 2GPT Image 1.5 Editimage:fal-fal-ai-gpt-image-1-5-edit
SeedreamSeedream5.0 Lite - Text to Imageimage:seedream5-0-lite-text-to-image
SeedreamSeedream5.0 Lite - Image to Imageimage:seedream5-0-lite-image-to-image
SeedreamSeedream5.0 Pro - Text to Imageimage:seedream5-0-pro-text-to-image
SeedreamSeedream5.0 Pro - Image to Imageimage:seedream5-0-pro-image-to-image
SeedreamSeedream4.5 - Text to Imageimage:seedream4-5-text-to-image
SeedreamSeedream4.5 - Editimage:seedream4-5-edit
SeedreamSeedream 5.0 Lite Text to Imageimage:fal-fal-ai-bytedance-seedream-v5-lite-text-to-image
SeedreamSeedream 5.0 Lite Editimage:fal-fal-ai-bytedance-seedream-v5-lite-edit
SeedreamSeedream 5.0 Pro Text to Imageimage:fal-bytedance-seedream-v5-pro-text-to-image
SeedreamSeedream 5.0 Pro Editimage:fal-bytedance-seedream-v5-pro-edit
SeedreamSeedream 4.5 Text to Imageimage:fal-fal-ai-bytedance-seedream-v4-5-text-to-image
SeedreamSeedream 4.5 Editimage:fal-fal-ai-bytedance-seedream-v4-5-edit
Qwen2Qwen2 - Text To Imageimage:qwen2-text-to-image
Qwen2Qwen2 - Image Editimage:qwen2-image-edit
Qwen2Qwen2 - Text To Imageimage:fal-fal-ai-qwen-image-2-text-to-image
Qwen2Qwen2 - Image Editimage:fal-fal-ai-qwen-image-2-edit
Grok ImagineGrok Imagine - Text to Imageimage:grok-imagine-text-to-image
Grok ImagineGrok Imagine - image to imageimage:grok-imagine-image-to-image
Grok ImagineGrok Imagine Text to Imageimage:fal-xai-grok-imagine-image
Grok ImagineGrok Imagine Image Editimage:fal-xai-grok-imagine-image-edit
Grok ImagineGrok Imagine Quality Text to Imageimage:fal-xai-grok-imagine-image-quality-text-to-image
Grok ImagineGrok Imagine Quality Image Editimage:fal-xai-grok-imagine-image-quality-edit
Wan ImageWan 2.7 Imageimage:wan-2-7-image
Wan ImageWan 2.7 Image Proimage:wan-2-7-image-pro
Wan ImageWan 2.7 Text to Imageimage:fal-fal-ai-wan-v2-7-text-to-image
Wan ImageWan 2.7 Editimage:fal-fal-ai-wan-v2-7-edit
Wan ImageWan 2.7 Pro Text to Imageimage:fal-fal-ai-wan-v2-7-pro-text-to-image
Wan ImageWan 2.7 Pro Editimage:fal-fal-ai-wan-v2-7-pro-edit
작업 상태

작업 진행 상태

이 상태들은 당신의 세대가 대기 중인지, 실행 중인지, 완료되었는지, 실패했는지를 알려줍니다.

queued
running
succeeded
failed
모델 스키마

Dynamic payload fields by model

Pick a model to view the exact input fields supported by /api/ai-studio/models/{modelId}.

모델 선택
입력 필드 문서
이 모델에 대한 입력 필드 문서를 찾을 수 없습니다.
가격

크레딧 기반 API 요금제

세대 요청은 기존 AI Studio 생성 흐름을 통해 크레딧을 예약하고 정산합니다.

API 사용은 크레딧으로 청구됩니다.

각 세대는 선택한 모델, 기간, 품질, 해상도 및 가격 행을 기반으로 크레딧을 사용할 수 있습니다.

사용자는 계정 또는 /api/auth/user에서 남은 크레딧을 확인할 수 있습니다.

계정에 크레딧이 부족하면 생성이 차단됩니다.

FAQ

AI 스튜디오 API FAQ

설정, 청구, 생성 진행 상황에 대한 빠른 답변.

API 키를 어떻게 받나요?

Log in, open the API Keys dashboard, and create an active key. Use it as Authorization: Bearer YOUR_API_KEY.

API 요청을 어떻게 인증하나요?

Send the API key in the Authorization header using the Bearer format on every request.

API 사용 요금은 어떻게 청구되나요?

생성 호출은 계정 크레딧을 사용합니다. 사용된 금액은 모델과 선택된 가격 옵션에 따라 달라집니다.

비디오 생성 상태를 어떻게 확인하나요?

execute 엔드포인트가 taskId를 반환하고 statusSupported가 true일 경우, /api/ai-studio/tasks/{taskId}?modelId={modelId} 를 폴링하세요.

내 생성 기록을 어디에서 볼 수 있나요?

페이지가 구분된 생성 기록은 /api/ai-studio/video-history를 사용하세요.

크레딧이 다 떨어지면 어떻게 되나요?

계정에 충분한 크레딧이 없으면 새로운 생성 요청을 계속할 수 없습니다.

API를 상업적 프로젝트에 사용할 수 있나요?

API는 계정 요금제 및 서비스 약관에 따라 생산 워크플로우에 통합될 수 있습니다.

API가 다양한 비디오 모델을 지원하나요?

네. 사용 가능한 모델 ID는 config/ai-video-studio.ts에서 설정된 모델입니다.

AI 스튜디오 API 사용 시작

API 키를 생성하고, 첫 번째 요청을 실행하며, 실시간으로 진행 상황을 추적하세요.