Quickstart: Aion API

Upload a file and get a shareable link in one request. Perfect for AI agents, bots, and automation.

Prerequisites

You need an API key. Get one from your dashboard after connecting your wallet or signing in with Google.

Need an API key?

Dashboard with upload history
API keys for automation
No passwords
No gas fees to sign in

Create account & get API key

Upload in 3 steps

Get an API key

Create one from your dashboard

Upload your file

Send a POST with your file as multipart/form-data

Get download URL

The response contains a downloadUrl you can share immediately

Try it now

Option A: Upload a file

curl -X POST https://payaion-api.fly.dev/v1/aion/upload \
  -H "X-Aion-Key: YOUR_API_KEY" \
  -F "file=@document.pdf"

Option B: Upload from a URL

If your bot receives a temporary file URL (Discord, Slack, webhooks), skip the download — let Payaion fetch it for you:

curl -X POST https://payaion-api.fly.dev/v1/aion/upload-url \
  -H "X-Aion-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://cdn.example.com/photo123.jpg"}'

Response (both endpoints)

{
  "uploadId": "up_a1b2c3d4e5f6g7h8",
  "status": "PENDING_UPLOAD",
  "statusUrl": "/v1/upload/up_a1b2c3d4e5f6g7h8/status",
  "downloadUrl": "https://payaion.com/d/abc123xyz789",
  "expiresAt": "2026-02-22T12:00:00.000Z"
}

Share the downloadUrl with anyone. It stays valid until expiresAt — 30 days on Basic, while your subscription stays active on Pro.

Prefer MCP? Skip the HTTP code

If you're using Cursor, Claude Desktop, or another MCP-compatible client, you can skip writing HTTP requests entirely. The Payaion MCP server gives your AI agent direct access to upload, marketplace, and download tools.

Set up MCP in 2 minutes →

Using with AI agents (custom integration)

Payaion is a standard REST API — just HTTP requests. If you're writing code yourself, you don't need anything special; use fetch, requests, or any HTTP client.

If you're using an AI agent platform (OpenAI Agents, LangChain, AutoGPT, etc.), how you integrate depends on what the platform supports:

Platform has HTTP tool — just configure it to call POST /v1/aion/upload with your API key
Platform lacks HTTP tool — you'll need to provide one: either run an MCP server that exposes an upload tool, or register a custom function in your agent framework

Your API key goes in your tool/server config, not in the conversation with the agent.

Prefer to read working code?

github.com/defdone/payaion-examples has runnable Node.js and Python quickstarts covering the whole flow — upload, price, list on the marketplace, and buy.