# Sideload Image to Avatar

> Sideload Image to Avatar is a paid API for AI agents from sideload.gg, paid per call via x402, $2/call, status unknown (last checked 2026-09-15).

Generates an AI avatar from an input image, returning a job ID and status URL for async retrieval

## Facts

- Endpoint: POST https://sideload.gg/api/agent/generate
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Success rate: 0% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sideload-image-to-avatar-bddb3539
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UMA2O47r6K1GEQLj9tEfU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sideload-image-to-avatar-bddb3539 -d '<json body>'
```

Example prompt: Use Sideload to turn this photo of me into an AI avatar — here's the image URL: https://example.com/my-photo.jpg

## When to prefer this

Choose this endpoint when you need to generate a stylized AI avatar from a user-supplied image, especially when integrating with x402 micropayment workflows. Best suited for async avatar creation where you can poll for results via the returned statusUrl.

## Known failure modes

- Invalid or inaccessible image URL returns an error
- Payment of $2 USDC not completed results in 402 rejection
- Image format not supported causes processing failure
- Polling statusUrl may return 'processing' for an extended time before completion
- Job ID not found if status checked before job is created

## How this service works

Sideload AI Avatar Generation

## Output

Returns a JSON object with a jobId (e.g. 'avt-example'), a status field ('processing'), a success boolean, and a statusUrl path (e.g. '/api/agent/generate/avt-example/status') which the agent can poll to retrieve the completed avatar.

## Request schema (JSON Schema)

```json
{
 "input": {
  "type": "object",
  "required": [
   "type"
  ],
  "properties": {
   "type": {
    "enum": [
     "text",
     "image"
    ],
    "type": "string",
    "description": "Generation mode"
   },
   "prompt": {
    "type": "string",
    "description": "Text description (when type is 'text')"
   },
   "imageUrl": {
    "type": "string",
    "description": "Image URL (when type is 'image')"
   }
  }
 },
 "output": {
  "type": "object",
  "properties": {
   "jobId": {
    "type": "string"
   },
   "status": {
    "type": "string"
   },
   "success": {
    "type": "boolean"
   },
   "statusUrl": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "jobId": "avt-example",
 "status": "processing",
 "success": true,
 "statusUrl": "/api/agent/generate/avt-example/status"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sideload-image-to-avatar-bddb3539/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sideload.gg](https://www.zero.xyz/host/sideload.gg/llms.txt)