Quick Start

FSG API

Connect AI video and image generation to your app with stable API access, credit-based billing, and current AI Studio endpoints.

Easy integration

AI video and image generation

Credit-based billing

Stable workflow

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"
      }
    }
  }'
Quick Start

How it works

From account setup to getting your final generation result.

1

Log in or create an account

2

Create an API Key in the dashboard

3

Call the generation endpoint with your API Key

4

Poll the task result when a task is queued

5

Read recent generation records

6

Check user profile, credits, and membership status

Authentication

Use your API key

Create an API key after login, then include it in the Authorization header for every request.

Required request header

Create an API Key after login, then include it in every API request.

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.

Request
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Endpoints

Available API calls

These are the live endpoints currently used by FSG AI Studio. Do not assume extra endpoints beyond the documented routes.

POST/api/ai-studio/execute

Start a new AI Studio generation task. The request uses modelId, isPublic, and payload. Supported video or image behavior depends on the selected model schema.

Request Headers

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Request Parameters

NameTypeRequiredDefaultOptionsDescription
modelIdstringYes-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.
isPublicbooleanNotrue-Whether this result can be shown publicly. Default is true.
payloadobjectYes--Main input data for generation. Nested fields change with the selected model.See Dynamic payload fields by model
Request
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"
      }
    }
  }'
Response Example
{
  "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": {}
  }
}
Error Example
{
  "success": false,
  "error": "User not authenticated"
}
GET/api/ai-studio/tasks/{taskId}

Check task progress after create returns taskId and statusSupported=true.

Request Headers

Authorization: Bearer YOUR_API_KEY

Request Parameters

NameTypeRequiredDefaultOptionsDescription
taskIdstringYes--Task ID returned after starting generation.
Request
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
  "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
  }
}
Error Example
{
  "success": false,
  "error": "Generation record not found"
}
GET/api/ai-studio/video-history?page={page}&limit={limit}&status={status}&q={q}

Get paginated generation history with status and keyword filters for generated assets.

Request Headers

Authorization: Bearer YOUR_API_KEY

Request Parameters

NameTypeRequiredDefaultOptionsDescription
pagenumberNo1-History page number.
limitnumberNo12-Page size for history list (1-50).
statusstringNoallall, pending, success, failedStatus filter for history list.
qstringNo""-Optional keyword for searching your history.
Request
curl -X GET "https://freesoragenerator.com/api/ai-studio/video-history?page=1&limit=12&status=all" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
  "success": true,
  "data": {
    "records": [],
    "total": 0,
    "totalPages": 1,
    "page": 1
  }
}
Error Example
{
  "success": false,
  "error": "Failed to load AI Studio generation history"
}
GET/api/auth/user

Get your account profile, remaining credits, and membership summary.

Request Headers

Authorization: Bearer YOUR_API_KEY

Request Parameters

No request parameters.

Request
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
  "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
    }
  }
}
Error Example
{
  "success": false,
  "error": "User not authenticated"
}
Models

Available model IDs

Choose a model ID that matches your desired video or image output.

FamilyVersionmodelId
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
Task States

Task progress states

These states tell you whether your generation is waiting, running, done, or failed.

queued
running
succeeded
failed
Model Schema

Dynamic payload fields by model

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

Select model
Input field docs
No input field docs were found for this model.
Pricing

Credits-based API billing

FSG generation requests reserve and settle credits through the existing AI Studio generation flow.

API usage is billed with credits.

Each generation can consume credits based on the selected model, output type, duration, quality, resolution, and pricing row.

Users can check remaining credits from the account or /api/auth/user.

Generation is blocked when the account has insufficient credits.

FAQ

FSG API FAQ

Quick answers for setup, billing, video generation, image generation, and progress tracking.

How do I get an API key?

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

How do I authenticate API requests?

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

How is API usage billed?

Generation calls use account credits. The consumed amount depends on the model and selected pricing options.

Does the API support AI video generation?

Yes. Current AI Studio endpoints can create generation tasks for configured video models. Check each model schema before sending payload fields.

Does the API support AI image generation?

FSG is positioned for image API workflows, but you should only use image generation fields and models that are exposed by the current model schema.

How do I check generation status?

After the execute endpoint returns taskId and statusSupported is true, poll /api/ai-studio/tasks/{taskId}?modelId={modelId}.

Where can I view generation history?

Use /api/ai-studio/video-history for paginated generation history.

What happens if I run out of credits?

New generation requests cannot continue when the account does not have enough credits.

Start using FSG API

Create your API key, run your first generation request, and track progress in real time.