{"uid":"cap_XDwYxPLzoTyn7dFXIwdqF","slug":"stablestudio-file-upload-session-generator-c5608b5f","name":"StableStudio File Upload Session Generator","description":"Get a client token for direct upload to Vercel Blob","url":"https://stable-studio-git-mason-migrate-off-prices-map-merit-systems.vercel.app/api/upload?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"size":{"type":"number","description":"File size in bytes (optional)"},"filename":{"type":"string","description":"Name of the file to upload"},"contentType":{"enum":["image/jpeg","image/jpg","image/png","image/gif","image/webp","video/mp4","video/webm","video/quicktime","audio/mpeg","audio/mp3","audio/wav","audio/x-wav","audio/mp4","audio/aac","audio/ogg"],"type":"string","description":"MIME type of the file"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i-ADbBl4trErfNph5VsCp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a signed upload session for a file, returning a Vercel Blob client token, pathname, expiry, and a curl upload example.","exampleAgentPrompt":"Can you generate a signed upload session for my file so I get a Vercel Blob client token, the destination pathname, and the expiry — and show me the curl command to complete the upload?","exampleUseCases":[{"title":"Secure media asset uploads for content platform","prompt":"I need to let users upload their profile pictures and cover images to our platform. Can you create signed upload sessions for each file so they get the authentication token and exact destination path, plus show them how to complete the upload with curl?"},{"title":"Batch file processing with temporary credentials","prompt":"We're building a document processing pipeline where users submit PDFs in bulk. Generate signed upload sessions for each file they need to upload, give us the tokens and expiry times, and include the curl examples so our backend can handle the uploads securely."},{"title":"Mobile app file upload without API keys","prompt":"Our mobile app needs to upload user-generated videos to cloud storage, but we don't want to embed API keys in the app. Can you create a signed session with a short-lived token and pathname for each video upload, then show us the curl command our frontend should execute?"}],"resultDescription":"Returns a Vercel Blob client token for authenticating the upload, the destination pathname for the file, an expiry timestamp for the session, and an example curl command demonstrating how to perform the actual file upload.","failureModes":["Invalid or missing file metadata causes session creation failure","Expired session token if the upload is not completed before expiry","Payment failure (insufficient USDC balance) returns 402 error","Vercel Blob service unavailability results in 5xx error","Malformed request body returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need to upload a file to Vercel Blob storage and require a short-lived signed session token to authorize the upload securely, especially within workflows already using StableStudio or x402 payment-gated APIs on Vercel infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T20:56:21.589Z","isFirstParty":false,"canonicalSlug":"stablestudio-file-upload-session-generator-c5608b5f"}