agent-media Help
Troubleshooting
Start with the symptom, recover the existing work, and avoid duplicate payments.
On this page
The agent cannot see the tools
Confirm the Agent Media connector is enabled for that conversation and complete sign-in. Refresh or reconnect the connector if the client keeps an old catalog, then start a fresh conversation. Installing only the public skill is not enough.
The upload panel is missing
Ask the agent to call upload_image with an empty object if open_upload_panel is absent. Use the returned browser link when the client cannot embed the panel. Do not build a replacement uploader.
The uploaded image is ignored
Have the agent retrieve the uploaded URLs and pass them as refs or first_frame. Check that the chosen model supports that input mode. Uploading an image does not automatically attach it to every later request.
An image reference expired
Temporary images expire with their upload session, 24 hours after the session was created. Open a new panel or follow the current session’s instructions, re-upload the image, and use the new URL.
Credits seem missing
Run get_account or the account check included in list_models. A temporarily unavailable lookup is not a zero balance. Check billing before paying again; keep the payment reference private when contacting support.
Generation timed out or status failed
Keep the original job ID and retry get_run_status. A status outage does not mean the generation failed. Do not submit a second paid request to check the first.
What to include in a support request
Include the client, tool name, approximate time, job or upload-session ID, and the visible error code. Never post API keys, login codes, upload-panel tokens, restricted image URLs or customer-private images in a public issue.