Inicio rápido

API de estudio de IA

Conecte la generación de videos con IA a su aplicación en unos pocos pasos, verifique el progreso en cualquier momento y pague con créditos.

Fácil integración

Crea vídeos de IA

pagar con creditos

Flujo de trabajo sencillo

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"
      }
    }
  }'
Inicio rápido

como funciona

Desde la configuración de la cuenta hasta la obtención del resultado final del vídeo.

1

Inicia sesión o crea una cuenta

2

Cree una clave API en el panel

3

Call the video generation endpoint with your API Key

4

Sondear el resultado de la generación cuando una tarea está en cola

5

Leer registros de última generación

6

Verifique el perfil de usuario, los créditos y el estado de membresía

Autenticación

Utilice su clave API

Cree una clave API después de iniciar sesión y luego inclúyala en el encabezado de Autorización para cada solicitud.

Encabezado de solicitud requerido

Cree una clave API después de iniciar sesión y luego inclúyala en cada solicitud 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.

Pedido
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Puntos finales

Llamadas API disponibles

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.

Encabezados de solicitud

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Solicitar parámetros

NombreTipoRequeridoPor defectoOpcionesDescripción
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.
isPublicbooleanNotrue-Si este resultado se puede mostrar públicamente. El valor predeterminado es verdadero.
payloadobject--Principales datos de entrada para la generación. Los campos anidados cambian con el modelo seleccionado.See Dynamic payload fields by model
Pedido
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"
      }
    }
  }'
Ejemplo de respuesta
{
  "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": {}
  }
}
Ejemplo de error
{
  "success": false,
  "error": "User not authenticated"
}
GET/api/ai-studio/tasks/{taskId}

Verifique el progreso de la tarea después de que la creación devuelva taskId y statusSupported=true.

Encabezados de solicitud

Authorization: Bearer YOUR_API_KEY

Solicitar parámetros

NombreTipoRequeridoPor defectoOpcionesDescripción
taskIdstring--ID de tarea devuelto después de iniciar la generación.
Pedido
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "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
  }
}
Ejemplo de error
{
  "success": false,
  "error": "Generation record not found"
}
GET/api/ai-studio/video-history?page={page}&limit={limit}&status={status}&q={q}

Obtenga un historial de generación paginado con filtros de estado y palabras clave.

Encabezados de solicitud

Authorization: Bearer YOUR_API_KEY

Solicitar parámetros

NombreTipoRequeridoPor defectoOpcionesDescripción
pagenumberNo1-Número de página de historia.
limitnumberNo12-Tamaño de página para la lista del historial (1-50).
statusstringNoallall, pending, success, failedFiltro de estado para la lista del historial.
qstringNo""-Palabra clave opcional para buscar en su historial.
Pedido
curl -X GET "https://freesoragenerator.com/api/ai-studio/video-history?page=1&limit=12&status=all" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "success": true,
  "data": {
    "records": [],
    "total": 0,
    "totalPages": 1,
    "page": 1
  }
}
Ejemplo de error
{
  "success": false,
  "error": "Failed to load AI Studio generation history"
}
GET/api/auth/user

Obtenga el perfil de su cuenta, los créditos restantes y el resumen de membresía.

Encabezados de solicitud

Authorization: Bearer YOUR_API_KEY

Solicitar parámetros

Sin parámetros de solicitud.

Pedido
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta
{
  "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
    }
  }
}
Ejemplo de error
{
  "success": false,
  "error": "User not authenticated"
}
Modelos

ID de modelo disponibles

Elija una ID de modelo que coincida con el resultado deseado.

FamiliaVersiónmodelId
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 de tarea

Estados de progreso de la tarea

Estos estados le indican si su generación está esperando, ejecutándose, finalizada o falló.

queued
running
succeeded
failed
Esquema del modelo

Dynamic payload fields by model

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

Seleccionar modelo
Documentos de campo de entrada
No se encontraron documentos de campo de entrada para este modelo.
Precios

Facturación API basada en créditos

Las solicitudes de generación reservan y liquidan créditos a través del flujo de generación existente de AI Studio.

El uso de API se factura con créditos.

Cada generación puede consumir créditos según el modelo seleccionado, la duración, la calidad, la resolución y la fila de precios.

Los usuarios pueden verificar los créditos restantes de la cuenta o /api/auth/user.

La generación se bloquea cuando la cuenta no tiene créditos suficientes.

FAQ

Preguntas frecuentes sobre la API de AI Studio

Respuestas rápidas para el progreso de configuración, facturación y generación.

¿Cómo obtengo una clave API?

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

¿Cómo autentico solicitudes de API?

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

¿Cómo se factura el uso de API?

Las llamadas de generación utilizan créditos de cuenta. La cantidad consumida depende del modelo y de las opciones de precios seleccionadas.

¿Cómo verifico el estado de generación de video?

Después de que el punto final de ejecución devuelva taskId y statusSupported sea verdadero, sondee /api/ai-studio/tasks/{taskId}?modelId={modelId}.

¿Dónde puedo ver mi historial generacional?

Utilice /api/ai-studio/video-history para su historial de generación paginado.

¿Qué pasa si me quedo sin créditos?

Las solicitudes de nueva generación no pueden continuar cuando la cuenta no tiene suficientes créditos.

¿Puedo utilizar la API para proyectos comerciales?

La API se puede integrar en los flujos de trabajo de producción, sujeto a su plan de cuenta y a los términos del servicio.

¿La API admite diferentes modelos de vídeo?

Sí. Los ID de modelo disponibles son los modelos configurados en config/ai-video-studio.ts.

Comience a usar la API de AI Studio

Cree su clave API, ejecute su primera solicitud y realice un seguimiento del progreso en tiempo real.