Fal.ai
fal_aiThe generative media platform for developers with 600+ AI models for image, video, voice, and audio generation
Acciones disponibles (9)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Cancel Queue RequestFAL_AI_CANCEL_QUEUE_REQUESTAcciónTool to cancel a queued or in-progress request in fal.ai's queue system. Use when you need to stop a request before it completes. Note that cancellation only succeeds if the request hasn't started processing; if already completed, returns an error status. Even with successful cancellation, the request may still execute if it was near the front of the queue.
FAL_AI_CANCEL_QUEUE_REQUESTAcciónTool to cancel a queued or in-progress request in fal.ai's queue system. Use when you need to stop a request before it completes. Note that cancellation only succeeds if the request hasn't started processing; if already completed, returns an error status. Even with successful cancellation, the request may still execute if it was near the front of the queue.
Parámetros de entrada
model_idstringObligatorioThe model identifier in namespace/name format (e.g., 'fal-ai/flux', 'fal-ai/fast-sdxl')
request_idstringObligatorioThe unique identifier of the queued request to cancel
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Estimate PricingFAL_AI_ESTIMATE_PRICINGAcciónTool to estimate pricing for fal.ai model endpoints. Use when you need to calculate expected costs for API calls or unit-based usage across one or more endpoints.
FAL_AI_ESTIMATE_PRICINGAcciónTool to estimate pricing for fal.ai model endpoints. Use when you need to calculate expected costs for API calls or unit-based usage across one or more endpoints.
Parámetros de entrada
endpointsobjectObligatorioMap of endpoint IDs (e.g., 'fal-ai/flux/dev') to their quantity specifications. Use call_quantity for historical_api_price or unit_quantity for unit_price
estimate_typestringObligatorioenumEstimation method: 'historical_api_price' for call-based estimates or 'unit_price' for unit-based estimates
historical_api_priceunit_price
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get JWKS for Webhook VerificationFAL_AI_GET_JWKSAcciónTool to retrieve public keys for webhook signature verification. Returns a JSON Web Key Set containing ED25519 public keys. Use when you need to verify webhook signatures from fal.ai. The keys are cacheable but should be refreshed at least every 24 hours.
FAL_AI_GET_JWKSAcciónTool to retrieve public keys for webhook signature verification. Returns a JSON Web Key Set containing ED25519 public keys. Use when you need to verify webhook signatures from fal.ai. The keys are cacheable but should be refreshed at least every 24 hours.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get ModelsFAL_AI_GET_MODELSAcciónTool to discover and search fal.ai model endpoints. Use when you need to list all models, find specific models by ID, or search by category/query. Supports pagination and optional expansion of OpenAPI schemas.
FAL_AI_GET_MODELSAcciónTool to discover and search fal.ai model endpoints. Use when you need to list all models, find specific models by ID, or search by category/query. Supports pagination and optional expansion of OpenAPI schemas.
Parámetros de entrada
qstringFree-text search query. Filters models by name, description, or category. Use for broad text-based searches.
limitintegerMaximum number of items to return. Actual maximum depends on query type.
cursorstringPagination cursor from previous response. Encodes page number for fetching next page.
expandanyFields to expand in response. Supports 'openapi-3.0' to include full OpenAPI schema for each model.
statusstringenumFilter models by status. Use 'active' for currently supported models or 'deprecated' for outdated ones. Omit to include all statuses.
activedeprecatedcategorystringFilter models by specific category. Use exact category names like 'text-to-image', 'image-to-video', etc.
endpoint_idanySpecific endpoint ID(s) to retrieve. Accepts a single string or array of strings (1-50 models). Use to filter models by their unique identifiers.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Model PricingFAL_AI_GET_PRICINGAcciónTool to retrieve unit pricing for model endpoints. Returns pricing information including unit price, billing unit, and currency. Use when you need to check costs for specific fal.ai models.
FAL_AI_GET_PRICINGAcciónTool to retrieve unit pricing for model endpoints. Returns pricing information including unit price, billing unit, and currency. Use when you need to check costs for specific fal.ai models.
Parámetros de entrada
endpoint_idanyObligatorioFilter by specific endpoint ID(s). Accepts 1-50 endpoint IDs. Can be a single endpoint ID string or a list of endpoint IDs. Examples: 'fal-ai/flux/dev' or ['fal-ai/flux/dev', 'fal-ai/flux/pro']
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Queue Request ResultFAL_AI_GET_QUEUE_REQUEST_RESULTAcciónTool to retrieve the final result of a completed queue request. Use when you need to get the output of a model request that was submitted to the queue and has finished processing. Only works after request status transitions to COMPLETED.
FAL_AI_GET_QUEUE_REQUEST_RESULTAcciónTool to retrieve the final result of a completed queue request. Use when you need to get the output of a model request that was submitted to the queue and has finished processing. Only works after request status transitions to COMPLETED.
Parámetros de entrada
model_idstringObligatorioThe model identifier in namespace/name format (e.g., 'fal-ai/flux', 'fal-ai/fast-sdxl')
request_idstringObligatorioThe unique identifier of the queued request to retrieve results for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Queue Request Status With LogsFAL_AI_GET_QUEUE_REQUEST_STATUS_WITH_LOGSAcciónTool to retrieve the current status of a queued request with detailed logging information. Use when you need to monitor a queued request's progress and access execution logs for debugging or tracking purposes. Logs include timestamps, severity levels, and detailed messages about request processing.
FAL_AI_GET_QUEUE_REQUEST_STATUS_WITH_LOGSAcciónTool to retrieve the current status of a queued request with detailed logging information. Use when you need to monitor a queued request's progress and access execution logs for debugging or tracking purposes. Logs include timestamps, severity levels, and detailed messages about request processing.
Parámetros de entrada
model_idstringObligatorioModel identifier in namespace/name format (e.g., 'fal-ai/flux', 'fal-ai/fast-sdxl')
request_idstringObligatorioUnique identifier of the queued request, returned when submitting the request
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Check Queue Request StatusFAL_AI_QUEUE_GET_STATUSAcciónTool to check the status of a queued request in fal.ai. Use when you need to monitor the progress of an async request. Returns different information based on status: queue position when IN_QUEUE, logs when IN_PROGRESS or COMPLETED.
FAL_AI_QUEUE_GET_STATUSAcciónTool to check the status of a queued request in fal.ai. Use when you need to monitor the progress of an async request. Returns different information based on status: queue position when IN_QUEUE, logs when IN_PROGRESS or COMPLETED.
Parámetros de entrada
logsintegerSet to 1 to enable log retrieval in the response; disabled by default for performance
model_idstringObligatorioModel identifier in namespace/name format (e.g., 'fal-ai/fast-sdxl')
request_idstringObligatorioUnique identifier returned after submitting a request
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Stream Request Status UpdatesFAL_AI_QUEUE_GET_STATUS_STREAMAcciónTool to stream request status updates via SSE. Use when you need real-time updates on a queued request's processing state.
FAL_AI_QUEUE_GET_STATUS_STREAMAcciónTool to stream request status updates via SSE. Use when you need real-time updates on a queued request's processing state.
Parámetros de entrada
logsintegerSet to 1 to include detailed logging information in the stream, 0 or omit to exclude logs
model_idstringObligatorioThe model identifier (e.g., 'fal-ai/fast-lightning-sdxl')
request_idstringObligatorioThe unique identifier returned when submitting a request
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not