Avatar Studio

curl -X POST https://api.percify.io/v1/avatars/percify-yourself \
  -H "Authorization: Bearer $PERCIFY_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "image=@portrait.jpg" \
  -F "style=cyberpunk" \
  -F "prompt=futuristic warrior, neon lights"

const response = await fetch('https://api.percify.io/v1/avatars/publish', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PERCIFY_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    avatarId: 'avatar_123',
    visibility: 'public',
    tags: ['cyberpunk', 'portrait', 'character-design'],
    description: 'Futuristic explorer character concept'
  })
});

// Node.js/JavaScript
const percify = require('@percify/sdk');

const client = new percify.Percify({
  apiKey: process.env.PERCIFY_API_KEY
});

const avatar = await client.avatars.generate({
  prompt: 'ethereal forest guardian, glowing eyes, mystical atmosphere',
  model: 'imagen3',
  aspectRatio: '1:1',
  guidanceScale: 10,
  negativePrompt: 'blurry, low quality'
});

console.log(`Avatar ID: ${avatar.id}, Status: ${avatar.status}`);

# Python
from percify import Percify

client = Percify(api_key=os.environ['PERCIFY_API_KEY'])

avatar = client.avatars.generate(
    prompt='ethereal forest guardian, glowing eyes, mystical atmosphere',
    model='imagen3',
    aspect_ratio='1:1',
    guidance_scale=10,
    negative_prompt='blurry, low quality'
)

print(f"Avatar ID: {avatar.id}, Status: {avatar.status}")

curl -X GET https://api.percify.io/v1/avatars/avatar_123 \
  -H "Authorization: Bearer $PERCIFY_API_KEY"

{
  "id": "avatar_123",
  "status": "completed",
  "imageUrl": "https://cdn.percify.io/avatars/avatar_123.png",
  "thumbnailUrl": "https://cdn.percify.io/avatars/avatar_123_thumb.png",
  "prompt": "ethereal forest guardian...",
  "model": "imagen3",
  "creditCost": 5,
  "createdAt": "2025-11-25T05:30:00Z",
  "completedAt": "2025-11-25T05:30:08Z"
}