Avvio rapido

API di AI Studio

Collega la generazione di video AI alla tua app in pochi passaggi, controlla i progressi in qualsiasi momento e paga con crediti.

Integrazione semplice

Crea video con l'IA

Paga con crediti

Flusso di lavoro semplice

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"
      }
    }
  }'
Avvio rapido

Come funziona

Dalla configurazione dell'account fino a ottenere il risultato finale del video.

1

Accedi o crea un account

2

Crea una chiave API nella dashboard

3

Call the video generation endpoint with your API Key

4

Interroga il risultato della generazione quando un'attività è in coda

5

Leggi i record delle generazioni recenti

6

Controlla il profilo utente, i crediti e lo stato dell'iscrizione

Autenticazione

Usa la tua chiave API

Crea una chiave API dopo il login, quindi includila nell'intestazione di Autorizzazione per ogni richiesta.

Intestazione richiesta obbligatoria

Crea una chiave API dopo il login, quindi includila in ogni richiesta 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.

Richiesta
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Punti finali

Chiamate API disponibili

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.

Intestazioni della richiesta

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Parametri della richiesta

NomeTipoObbligatorioPredefinitoOpzioniDescrizione
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-Se questo risultato può essere mostrato pubblicamente. Il valore predefinito è vero.
payloadobject--Dati di input principali per la generazione. I campi annidati cambiano con il modello selezionato.See Dynamic payload fields by model
Richiesta
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"
      }
    }
  }'
Esempio di risposta
{
  "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": {}
  }
}
Esempio di errore
{
  "success": false,
  "error": "User not authenticated"
}
GET/api/ai-studio/tasks/{taskId}

Controlla il progresso del compito dopo che la creazione restituisce taskId e statusSupported=true.

Intestazioni della richiesta

Authorization: Bearer YOUR_API_KEY

Parametri della richiesta

NomeTipoObbligatorioPredefinitoOpzioniDescrizione
taskIdstring--ID attività restituito dopo l'avvio della generazione.
Richiesta
curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"
Esempio di risposta
{
  "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
  }
}
Esempio di errore
{
  "success": false,
  "error": "Generation record not found"
}
GET/api/ai-studio/video-history?page={page}&limit={limit}&status={status}&q={q}

Ottieni la cronologia delle generazioni suddivisa in pagine con filtri per stato e parola chiave.

Intestazioni della richiesta

Authorization: Bearer YOUR_API_KEY

Parametri della richiesta

NomeTipoObbligatorioPredefinitoOpzioniDescrizione
pagenumberNo1-Numero di pagina della storia.
limitnumberNo12-Dimensione della pagina per l'elenco della cronologia (1-50).
statusstringNoallall, pending, success, failedFiltro di stato per l'elenco della cronologia.
qstringNo""-Parola chiave opzionale per cercare nella tua cronologia.
Richiesta
curl -X GET "https://freesoragenerator.com/api/ai-studio/video-history?page=1&limit=12&status=all" \
  -H "Authorization: Bearer YOUR_API_KEY"
Esempio di risposta
{
  "success": true,
  "data": {
    "records": [],
    "total": 0,
    "totalPages": 1,
    "page": 1
  }
}
Esempio di errore
{
  "success": false,
  "error": "Failed to load AI Studio generation history"
}
GET/api/auth/user

Ottieni il profilo del tuo account, i crediti rimanenti e il riepilogo dell'abbonamento.

Intestazioni della richiesta

Authorization: Bearer YOUR_API_KEY

Parametri della richiesta

Nessun parametro di richiesta.

Richiesta
curl -X GET "https://freesoragenerator.com/api/auth/user" \
  -H "Authorization: Bearer YOUR_API_KEY"
Esempio di risposta
{
  "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
    }
  }
}
Esempio di errore
{
  "success": false,
  "error": "User not authenticated"
}
Modelli

ID modello disponibili

Scegli un ID modello che corrisponda al risultato desiderato.

FamigliaVersionemodelId
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
Stati del compito

Stati di avanzamento dei compiti

Questi stati ti dicono se la tua generazione sta aspettando, è in esecuzione, è terminata o è fallita.

queued
running
succeeded
failed
Schema del Modello

Dynamic payload fields by model

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

Seleziona modello
Documenti del campo di input
Nessun documento sul campo di input è stato trovato per questo modello.
Prezzi

Fatturazione API basata sui crediti

Le richieste di generazione riservano e regolano i crediti tramite il flusso di generazione esistente di AI Studio.

L'utilizzo dell'API viene fatturato con crediti.

Ogni generazione può consumare crediti in base al modello selezionato, alla durata, alla qualità, alla risoluzione e alla fascia di prezzo.

Gli utenti possono controllare i crediti rimanenti dall'account o da /api/auth/user.

La generazione è bloccata quando il conto ha crediti insufficienti.

FAQ

FAQ dell'API di AI Studio

Risposte rapide per configurazione, fatturazione e avanzamento della generazione.

Come faccio a ottenere una chiave API?

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

Come autentico le richieste API?

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

Come viene fatturato l'utilizzo dell'API?

Le chiamate di generazione utilizzano i crediti dell'account. La quantità consumata dipende dal modello e dalle opzioni di prezzo selezionate.

Come faccio a controllare lo stato della generazione del video?

Dopo che l'endpoint di esecuzione restituisce taskId e statusSupported è vero, eseguire il polling su /api/ai-studio/tasks/{taskId}?modelId={modelId}.

Dove posso visualizzare la cronologia delle mie generazioni?

Usa /api/ai-studio/video-history per la cronologia delle generazioni paginata.

Cosa succede se finisco i crediti?

Le richieste di nuova generazione non possono continuare quando l'account non ha abbastanza crediti.

Posso usare l'API per progetti commerciali?

L'API può essere integrata nei flussi di lavoro di produzione, soggetta al piano del tuo account e ai termini del servizio.

L'API supporta diversi modelli video?

Sì. Gli ID dei modelli disponibili sono i modelli configurati in config/ai-video-studio.ts.

Inizia a usare l'API di AI Studio

Crea la tua chiave API, esegui la tua prima richiesta e monitora i progressi in tempo reale.