{"uid":"cap_nJB6jnbzL1PhtgR59jfdT","slug":"tanship-payai-console-storage-presign-2d7e05cf","name":"Tanship PayAI Console — Storage Presign","description":"Payment-gated AI and browser automation API using the x402 protocol. All /v1/* endpoints require USDC payment on Base (eip155:8453) via x402 v2 exact scheme.","url":"https://x402.tanship.dev/v1/storage/presign?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Fo1uuN5dPXkcqVJAZBYQV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a pre-signed URL for uploading or accessing stored objects, gated by a USDC micropayment on Base via the x402 protocol.","exampleAgentPrompt":"Generate a presigned upload URL for my file using the Tanship storage endpoint — I need a signed link so I can upload directly to object storage, and I'm happy to pay the $0.003 USDC fee via x402 on Base.","exampleUseCases":[{"title":"Agent file upload pipeline","prompt":"I need a short-lived presigned URL so my AI agent can upload a generated report directly to cloud storage without exposing long-lived credentials — can you get one from Tanship's storage presign endpoint?"},{"title":"Pay-per-upload media storage","prompt":"My app needs to let users upload images to object storage one at a time, paying a tiny crypto fee each time instead of managing a subscription — can you get me a presigned upload URL via the Tanship x402 storage API?"},{"title":"Temporary secure access link","prompt":"I need to grant my workflow a short-lived authorized upload link for object storage that expires after use — use the Tanship PayAI storage presign endpoint to generate one now."}],"resultDescription":"Returns a presigned URL (and possibly associated metadata such as expiry time and upload parameters) that authorizes a direct upload or access operation to an object storage backend, valid for a limited time window.","failureModes":["Payment not included or invalid x402 USDC payment header — returns 402 Payment Required","Malformed input body or missing required fields (type, method, bodyType, body) — returns 400 Bad Request","Expired or already-used presigned URL — subsequent upload attempt fails with 403","Network or backend storage error — returns 500 Internal Server Error","Insufficient USDC balance or wrong chain (not Base eip155:8453) — payment rejected with 402"],"whenToPreferThis":"Choose this endpoint when you need a payment-gated presigned storage URL and are operating in an x402-compatible agent environment with USDC on Base. Ideal for autonomous agents that need to upload files without long-lived credentials, pay per operation rather than by subscription, and integrate blockchain micropayments natively into their workflow. Prefer over traditional S3 presign APIs when your architecture already uses x402 for access control.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T20:56:21.641Z","isFirstParty":false,"canonicalSlug":"tanship-payai-console-storage-presign-2d7e05cf"}