Get a client token for direct upload to Vercel Blob

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x07F067959297767c887dbfA3C72379c66E82a045",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "HqpEDUY3kV423fSAv7iaY3cQiz8qN8qEuGqLsG4s6h2c",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "contentType": "image/jpeg",
          "filename": "photo.jpg",
          "size": 1524605
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "clientToken": "vercel_blob_client_token_example_redacted",
          "curlExample": "curl -X PUT \"https://vercel.com/api/blob/?pathname=uploads%2F8eecdb7b-bd76-4054-94f9-94c9abb57eab%2Fphoto.jpg\" -H \"authorization: Bearer <client-token>\" -H \"x-content-type: image/jpeg\" -H \"x-api-version: 11\" --data-binary @photo.jpg",
          "expiresAt": "2026-05-18T20:11:05.273Z",
          "pathname": "uploads/8eecdb7b-bd76-4054-94f9-94c9abb57eab/photo.jpg",
          "uploadId": "8eecdb7b-bd76-4054-94f9-94c9abb57eab"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "$schema": "https://json-schema.org/draft/2020-12/schema",
              "additionalProperties": false,
              "properties": {
                "contentType": {
                  "description": "MIME type of the file",
                  "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"
                },
                "filename": {
                  "description": "Name of the file to upload",
                  "type": "string"
                },
                "size": {
                  "description": "File size in bytes (optional)",
                  "type": "number"
                }
              },
              "required": [
                "filename",
                "contentType"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "$schema": "https://json-schema.org/draft/2020-12/schema",
              "additionalProperties": false,
              "properties": {
                "clientToken": {
                  "type": "string"
                },
                "curlExample": {
                  "type": "string"
                },
                "expiresAt": {
                  "type": "string"
                },
                "pathname": {
                  "type": "string"
                },
                "uploadId": {
                  "type": "string"
                }
              },
              "required": [
                "uploadId",
                "clientToken",
                "pathname",
                "expiresAt",
                "curlExample"
              ],
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://stablestudio.io/api/upload"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://stablestudio.io/api/upload");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://stablestudio.io/api/upload")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header