Início Rápido

API do AI Studio

Conecte a geração de vídeo por IA ao seu aplicativo em alguns passos, verifique o progresso a qualquer momento e pague com créditos.

Integração fácil

Criar vídeos com IA

Pagar com créditos

Fluxo de trabalho simples

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"
      }
    }
  }'
Início Rápido

Como funciona

Desde a configuração da conta até obter o resultado final do seu vídeo.

1

Entrar ou criar uma conta

2

Crie uma chave de API no painel

3

Call the video generation endpoint with your API Key

4

Verificar periodicamente o resultado da geração quando uma tarefa é enfileirada

5

Ler registros de geração recentes

6

Verificar perfil do usuário, créditos e status de assinatura

Autenticação

Use sua chave de API

Crie uma chave de API após o login, então inclua-a no cabeçalho de Autorização para cada requisição.

Cabeçalho de solicitação obrigatório

Crie uma chave de API após o login e, em seguida, inclua-a em cada solicitação de 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.

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

Chamadas de API disponíveis

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.

Cabeçalhos da Requisição

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Parâmetros da Requisição

NomeTipoObrigatórioPadrãoOpçõesDescrição
modelIdstringSim-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.
isPublicbooleanNãotrue-Se este resultado pode ser exibido publicamente. O padrão é verdadeiro.
payloadobjectSim--Dados de entrada principais para geração. Campos aninhados mudam com o modelo selecionado.See Dynamic payload fields by model
Solicitação
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"
      }
    }
  }'
Exemplo de Resposta
{
  "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": {}
  }
}
Exemplo de Erro
{
  "success": false,
  "error": "User not authenticated"
}
GET/api/ai-studio/tasks/{taskId}

Verifique o progresso da tarefa depois que a criação retornar taskId e statusSupported=true.

Cabeçalhos da Requisição

Authorization: Bearer YOUR_API_KEY

Parâmetros da Requisição

NomeTipoObrigatórioPadrãoOpçõesDescrição
taskIdstringSim--ID da tarefa retornada após iniciar a geração.
Solicitação
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de Resposta
{
  "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
  }
}
Exemplo de Erro
{
  "success": false,
  "error": "Generation record not found"
}
GET/api/ai-studio/video-history?page={page}&limit={limit}&status={status}&q={q}

Obtenha o histórico de geração paginado com filtros de status e palavras-chave.

Cabeçalhos da Requisição

Authorization: Bearer YOUR_API_KEY

Parâmetros da Requisição

NomeTipoObrigatórioPadrãoOpçõesDescrição
pagenumberNão1-Número da página de histórico.
limitnumberNão12-Tamanho da página para a lista de histórico (1-50).
statusstringNãoallall, pending, success, failedFiltro de status para lista de histórico.
qstringNão""-Palavra-chave opcional para pesquisar seu histórico.
Solicitação
curl -X GET "https://freesoragenerator.com/api/ai-studio/video-history?page=1&limit=12&status=all" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de Resposta
{
  "success": true,
  "data": {
    "records": [],
    "total": 0,
    "totalPages": 1,
    "page": 1
  }
}
Exemplo de Erro
{
  "success": false,
  "error": "Failed to load AI Studio generation history"
}
GET/api/auth/user

Obtenha o perfil da sua conta, créditos restantes e resumo da associação.

Cabeçalhos da Requisição

Authorization: Bearer YOUR_API_KEY

Parâmetros da Requisição

Sem parâmetros de solicitação.

Solicitação
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Exemplo de Resposta
{
  "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
    }
  }
}
Exemplo de Erro
{
  "success": false,
  "error": "User not authenticated"
}
Modelos

IDs de modelos disponíveis

Escolha um ID de modelo que corresponda ao resultado desejado.

FamíliaVersãomodelId
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
Estados da Tarefa

Estados de progresso da tarefa

Esses estados informam se a sua geração está aguardando, em execução, concluída ou falhou.

queued
running
succeeded
failed
Esquema do Modelo

Dynamic payload fields by model

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

Selecionar modelo
Documentos do campo de entrada
Nenhum campo de entrada de documentos foi encontrado para este modelo.
Precificação

Faturamento de API baseado em créditos

A geração solicita, reserva e liquida créditos através do fluxo de geração existente do AI Studio.

O uso da API é cobrado com créditos.

Cada geração pode consumir créditos com base no modelo selecionado, duração, qualidade, resolução e faixa de preço.

Os usuários podem verificar os créditos restantes na conta ou em /api/auth/user.

A geração é bloqueada quando a conta não possui créditos suficientes.

FAQ

Perguntas Frequentes sobre a API do AI Studio

Respostas rápidas para configuração, faturamento e progresso de geração.

Como faço para obter uma chave de API?

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

Como faço para autenticar solicitações de API?

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

Como é cobrado o uso da API?

As chamadas de geração usam créditos de conta. O valor consumido depende do modelo e das opções de preço selecionadas.

Como faço para verificar o status da geração de vídeo?

Após o endpoint de execução retornar taskId e statusSupported for true, faça polling em /api/ai-studio/tasks/{taskId}?modelId={modelId}.

Onde posso ver meu histórico de geração?

Use /api/ai-studio/video-history para o seu histórico de geração paginada.

O que acontece se eu ficar sem créditos?

Solicitações de nova geração não podem continuar quando a conta não tem créditos suficientes.

Posso usar a API para projetos comerciais?

A API pode ser integrada em fluxos de trabalho de produção, sujeito ao seu plano de conta e aos termos de serviço.

A API suporta diferentes modelos de vídeo?

Sim. Os IDs de modelos disponíveis são os modelos configurados em config/ai-video-studio.ts.

Comece a usar a API do AI Studio

Crie sua chave de API, execute sua primeira solicitação e acompanhe o progresso em tempo real.