# Apiframe — how to use (mcp.ai)

Connect your Apiframe account and use 7 tools for AI content generation straight from your AI agent. Connect with your own API key. Apiframe provides one API for generating and managing AI images, videos, music, uploads, assets, jobs, and custom LoRAs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_apiframe?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `apiframe_generate_image`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/apiframe`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/apiframe/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/apiframe/generate/image` — Submit a paid image generation job that consumes Apiframe credits based on the selected model and controls. Call List Models for pricing and controls, then Get Job with the returned job_id to retrieve
  - body: { generation: object, idempotency_key?: string }
- `POST https://api.mcp.ai/api/apiframe/generate/music` — Submit a paid music generation job that consumes Apiframe credits, with cost and output count varying by model. Call List Models for pricing and controls, then Get Job with the returned job_id to retr
  - body: { generation: object, idempotency_key?: string }
- `POST https://api.mcp.ai/api/apiframe/generate/video` — Submit a paid video generation job that consumes Apiframe credits based on the selected model and controls. Call List Models for pricing and controls, then Get Job with the returned job_id to retrieve
  - body: { generation: object, idempotency_key?: string }
- `POST https://api.mcp.ai/api/apiframe/get/account` — Return the authenticated Apiframe user, team plan and credit balance, role, and active API-key metadata.
- `POST https://api.mcp.ai/api/apiframe/get/job` — Get the current status, progress, provider-specific result, cost, and error details for one Apiframe generation job.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/apiframe/list/jobs` — Return one page of generation jobs, optionally filtered by status, model, job ID, or ownership scope.
  - body: { limit?: integer, model?: string, scope?: string, search?: string, status?: string, next_cursor?: string, include_models?: boolean }
- `POST https://api.mcp.ai/api/apiframe/list/models` — List Apiframe's current image, video, or music models with pricing and the complete live model-specific control metadata needed to construct generation requests.
  - body: { modality?: string }

## Example prompts
- "What can I do in Apiframe?"
- "Show me a summary of my Apiframe account"

## More
- Page: https://mcp.ai/apiframe
- Agent spec (llms.txt): https://mcp.ai/apiframe/llms.txt
- Postman collection: https://mcp.ai/apiframe/postman.json