Use Tryr with your AI agent
Give your agent a product URL. It can start a shoot and bring you the finished frames. Your account and credits stay the same.
1. Create a key
- Open your dashboard and sign in.
- Under Agent access, select Create API key. The key (
tryr_sk_…) is displayed only once. - Keep it private. If it is exposed, revoke it in the same section.
2. Connect your agent
Claude Code
claude mcp add --transport http tryr https://tryr.app/mcp \ --header "Authorization: Bearer tryr_sk_..."
Cursor / Windsurf / other MCP clients (mcp.json)
{
"mcpServers": {
"tryr": {
"url": "https://tryr.app/mcp",
"headers": { "Authorization": "Bearer tryr_sk_..." }
}
}
}
Gemini CLI (~/.gemini/settings.json)
{
"mcpServers": {
"tryr": {
"httpUrl": "https://tryr.app/mcp",
"headers": { "Authorization": "Bearer tryr_sk_..." }
}
}
}
ChatGPT (Custom GPT Actions): Import https://tryr.app/agent/v1/openapi.json as the schema. For authentication, choose API Key → Bearer and enter your key.
claude.ai and ChatGPT connectors (account sign-in via OAuth): coming soon.
How your agent sends a request
Your agent does not forward a short request as is. It reads the product page and the questions, writes a concrete brief covering setting, light, framing and what to avoid, shows it to you briefly, and sends the version you approve or edit. You always have the final say; nothing the product does not have is added.
3. Terminal (CLI)
The CLI package has not been published to npm yet. Until then, use MCP or the REST API.
CLI commands support --json for machine-readable output and can read your key from the TRYR_API_KEY environment variable.
4. REST API
curl -X POST https://tryr.app/agent/v1/shoots \
-H "Authorization: Bearer tryr_sk_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://store.example/product"}'
| Endpoint | Purpose |
|---|---|
GET /agent/v1/me | Account, credits, and pricing |
POST /agent/v1/shoots | Start a shoot from a product URL |
GET /agent/v1/shoots/{id} | Status, questions, frames, and next step |
POST /agent/v1/shoots/{id}/answers | Answer questions (empty body uses defaults) |
POST /agent/v1/shoots/{id}/approve | Generate the remaining planned scenes |
GET /agent/v1/shoots/{id}/frames/{n}/preview | Free watermarked preview |
GET /agent/v1/shoots/{id}/frames/{n} | Download a full-resolution frame (uses credits) |
GET /agent/v1/plans | Credit packages and prices |
POST /agent/v1/checkout | Create a package checkout link |
Full schema: /agent/v1/openapi.json. Write endpoints accept the Idempotency-Key header.
Buying credits
When credits run out, your agent can list packages and give you a Stripe checkout link. You complete payment yourself. The agent never sees your card details or charges you directly. Credits are added to your account after payment.
- MCP:
tryr_paketler→tryr_kredi_al(package and term) → open the link →tryr_hesap - CLI:
tryr plans,tryr buy baslangic --term aylik --open - REST:
GET /agent/v1/plans,POST /agent/v1/checkout {"package":"baslangic","term":"aylik"}→checkout_url
Packages are subscriptions and renew until canceled; unused credits do not expire. To cancel, contact info@agentized.io. Details: Terms of Service.
Costs and limits
- Starting a shoot, answering questions, and generating frames are free.
- Downloading a full-resolution frame uses credits. Downloading the same frame again does not charge you twice. Current pricing is included in
GET /agent/v1/me. - An agent key can start up to 10 shoots per hour and 40 per day.
Contact
For bulk use and integrations: info@agentized.io