Skip to content

entroute/describe-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

describe-image

Describe images via verified x402 vision endpoints. No OpenAI/Claude key, pay per image in USDC.

A tiny example that takes an image URL and returns a description. EntRoute discovers the best-ranked vision endpoint; x402 handles payment.

Why this exists: One-off image descriptions don't justify a Vision API account. Pay $0.001–$0.005 per call instead — no signup, no key.


Quickstart — Claude Code (recommended, zero config)

claude mcp add entroute -- npx @entroute/mcp-server

Then ask Claude: "Describe the image at https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg" — it discovers a verified vision endpoint, pays in USDC on Base, and returns the description. No API keys, no wallet setup, no env vars.

About the MCP server →


Use it from your own code

npm install @entroute/sdk-agent-ts

Inspect the top-ranked endpoint:

import { EntRouteClient } from '@entroute/sdk-agent-ts';

const client = new EntRouteClient({ baseUrl: 'https://api.entroute.com' });
const result = await client.discover({ capability_id: 'image.describe' });
console.log(result.ranked_endpoints[0]);

To actually call it (and have the SDK handle the x402 402 → pay → retry dance), pass a Base wallet via client.discoverAndCall(). See the SDK docs.


Try the demo

Discovery only — prints the top 3 endpoints with score, latency, success rate, and price. No payment, no wallet needed.

git clone https://github.com/entroute/describe-image && cd describe-image
pnpm install
pnpm start

Source: src/index.ts.


Why EntRoute

The only x402 directory that pays real USDC to verify each endpoint actually works. Probes run every 10 minutes; failed endpoints get demoted automatically.

x402 is the open pay-per-request protocol behind it (Coinbase + Linux Foundation). Server returns 402, client pays in USDC on Base, retries with payment header.


Related skills

License

MIT

About

Generate alt text or a description for any image via a verified x402 endpoint. No API key, pay-per-image in USDC.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors