get_account_credits
Check Filtrix credit balance before queuing work or retrying failed tasks.
LABSCO SUMMARY
A balance tool and idempotency keys are the two things a credit-metered generation API owes an agent.
Generation costs money and agents retry. Without an idempotency key a retried video request is a second charge for the same output; without a balance check the agent finds out it is broke by failing mid-workflow. Filtrix documents both, and the credit tool's description explicitly frames it as something to call before queuing or retrying — which is guidance the model will actually read.
What it is
Filtrix's endpoint. Six tools described as the core set most agents need first: image generation and editing, two video paths, a status poller and a balance check.
What you get
- generate_image_text — text to image, with quality and speed modes
- edit_image_text — edit an existing image by instruction, in the same workflow
- generate_video_text — asynchronous text to video, returning a request id
- generate_video_image — image to video, with a choice of models
- get_video_status — poll the job and download the finished asset
- get_account_credits — check the balance before queuing work or retrying
Requirements
A bearer MCP key, generated once billing is set up. Async jobs support idempotency keys so a retry does not double-charge.
Setup effort
Paste a URL with a key — add the endpoint to your client
USE CASES
01
Generating an image and refining it
Produce it, then edit by instruction in the same conversation rather than regenerating.
02
Making a video without blocking
Launch the job, take the request id, and poll for the finished asset.
03
Not paying twice for a retry
Check the balance first and use an idempotency key on the request.
6 tools
Listed in project docs. Your client may show a different list.
generate_image_text
Text-to-image generation. Modes: gpt-image-1 (default quality), nano-banana (fast), nano-banana-2 (resolution/search/enhance controls).
edit_image_text
Edit an existing image with text instructions in the same MCP workflow.
generate_video_text
Async text-to-video; returns request_id for polling.
generate_video_image
Image-to-video task launch. Supports grok-imagine and seedance-1-5-pro.
get_video_status
Poll long-running video jobs until completed; supports download of final asset.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- an MCP client that can reach a remote endpoint
- A bearer MCP key generated at app.filtrix.ai/mcp-keys; billing must be set up before the generation tools work
INSTALLATION
Connect your client
Add the endpoint to your client.
Server setup
ENDPOINT URL
https://mcp.filtrix.ai/mcpRequirements
- A bearer MCP key generated at app.filtrix.ai/mcp-keys; billing must be set up before the generation tools work
