Skip to main content
The agent shows you Leap’s refusals word for word, and most say what to change. These are the ones people meet most.

​
Signing in

Finish signing in in the same browser the app opened. If you open the sign-in email on another device, its link signs that device in instead: type the email’s 6-digit code on the first computer.If you selected Deny, the app has no access. Remove Leap from the app and add it again to see the consent page again.To start over with an app that’s half connected, disconnect it under Connected apps on Leap’s Connect page, remove Leap from the app, and add it again.
It didn’t get a refresh token, because it didn’t ask for offline_access. Remove Leap and add it again. A custom client should ask for workspace:read media:generate offline_access.
Cursor didn’t find LEAP_API_KEY, so it sent no key and Leap asked it to sign in, which Cursor can’t do with Leap. Set the variable where Cursor can read it and restart Cursor, or check the spelling in mcp.json. See Cursor.
A web page on another site called the server from a browser, which Leap refuses. Call it from a server, a desktop app or a CLI.

​
Workspaces and access

New accounts get a workspace when they connect, so this is rare: it means you have none now, for example after leaving your only one. Open the link in the message, app.tryleap.ai, finish setting up, and ask the agent again. You don’t need to reconnect.
Tell the agent which one to use, by the slug in the message, for example “use my acme workspace for Leap”. It passes that slug on each call for the rest of the chat.
Each run belongs to the workspace the agent named on that call. Ask “which Leap workspace did you use?”, or open the other workspace in the studio: its runs are marked Over MCP. From now on, name the workspace you want.
The app connected without media:generate. Remove Leap and add it again, and allow everything the consent page lists. With an API key, the message says the key lacks generations:write: use a key that has it.
A key works only in its own workspace. Leave workspace out, or connect with a key of the workspace you want.

​
Runs

The balance doesn’t cover the run’s price, so nothing started. The message links to where to add credits (in ChatGPT and Codex, to Leap’s prices). Add credits at app.tryleap.ai/go/settings/credits, then ask again. get_account shows the balance and what running jobs hold.
A failed run isn’t charged. Its error says why, and the agent should follow the advice that comes with it: change the prompt or photo after a safety refusal, use another photo or file when one was refused, or try again after a provider error. A retry needs a new idempotency_key, or it returns the same failed run. See When a run fails.
Leap checks every photo before a run that takes it, and refuses one that may show someone under 18 or shows nudity. Nothing is held or charged. Use another photo. See Photos of people.
The result view checks on a running video for about 12 minutes. If it takes longer, or the app was closed, ask “check on run gen_…” and the agent reads it with get_generation. Every run is also in the studio.
Leap answers within 50 seconds, even when the run is still going, and most clients wait 60. If your client allows less, raise its tool timeout, such as tool_timeout_sec in Codex. The run carries on either way: ask the agent to check on it.
Images can be up to 4 MB. Resize the photo, for example to 2048 pixels on its long side, and try again.
Leap fetches only public https links. A link that needs a sign-in, or that opens a viewer page instead of the file, won’t work either: use a direct link to the file, or attach it in ChatGPT.
Leap has 45 seconds to download a link and takes up to 100 MB. For a larger or slower file, upload it with the API’s direct uploads and give the agent the file ID.
The file isn’t a type Leap takes, such as a HEIC photo from an iPhone or a GIF. Convert a picture to JPEG first.
Storing a video or a sound is free but needs some credit on the balance. Add credits and try again.

​
The result view

Only apps that support MCP Apps draw the result view, such as ChatGPT and Claude. Claude Code, Codex and Cursor show the same result as text with links. In ChatGPT or Claude, start a new chat after Leap updates; in ChatGPT, select Refresh on Leap’s plugin page to pick up new tools.
The links may have expired after 24 hours. Ask the agent to check on the run, and the view gets fresh ones.
The app may be holding an old list. In ChatGPT, select Refresh on Leap’s plugin page. In Claude Code, reconnect leap from /mcp. In Codex, restart it.
Still stuck? Email hello@tryleap.ai with the run’s ID (gen_...) or the message the agent showed you.
Last modified on October 6, 2026