{
  "paymentId": "abc123",
  "prompt": "A futuristic city at sunset",
  "modelId": 2,                          // Optional: defaults to best
  "imageBase64": "..."                   // Optional: base64 image for img2img
}

Supports file attachments (send extracted text as fileContext) and image analysis (send base64 as imageBase64).

{
  "paymentId": "abc123",
  "prompt": "Review this code for bugs",
  "modelId": 6,                                  // Optional: defaults to best
  "systemPrompt": "You are a helpful assistant",  // Optional
  "fileContext": "function add(a, b) { ... }",   // Optional: extracted file text
  "fileName": "utils.js",                         // Optional: file name
  "imageBase64": "data:image/png;base64,..."      // Optional: vision-capable models only
}

{
  "paymentId": "abc123",
  "prompt": "A rocket launching into space",
  "modelId": 25,           // Optional: defaults to best
  "duration": 5,           // 3-15 seconds
  "mode": "pro",           // "standard" or "pro"
  "generate_audio": false  // Include audio track
}
// Pricing (per second): standard 300 (no audio) / 400 (audio), pro 450 / 550
// Must provide duration, mode, generate_audio at create_payment time

{
  "paymentId": "abc123",
  "imageBase64": "<base64 encoded image>",
  "prompt": "The scene comes to life",    // Optional motion guidance
  "modelId": 24,                           // Optional: defaults to best
  "duration": 5                            // 3-15 seconds, 100 sats/sec
}
// Must provide duration at create_payment time

{
  "paymentId": "abc123",
  "prompt": "E minor, 90 BPM, acoustic guitar ballad, male vocal",
  "lyrics": "[Verse]\nYour lyrics here...\n[Chorus]\nThe hook...",
  "is_instrumental": false,   // true for instrumental-only
  "lyrics_optimizer": false,  // true to auto-generate lyrics
  "sample_rate": 44100,
  "bitrate": 256000,
  "audio_format": "mp3"
}

{
  "paymentId": "abc123",
  "text": "Hello, this is a test of the speech synthesis.",
  "modelId": 3,       // Optional: defaults to best
  "voice": "default"  // Optional: voice ID
}

{
  "paymentId": "abc123",
  "audioBase64": "<base64-encoded-audio>",  // mp3, wav, flac, ogg, webm, mp4, m4a, aac, wma
  "language": "en",              // Optional: "detect", "en", "es", "fr", "de", "it", "pt", "nl", "ja", "ko", "zh", "ar", "hi"
  "timestamps": "segment",      // Optional: "none" (default), "segment", or "word"
  "diarize": true                // Optional: identify different speakers (default: false)
}

Returns requestId. Poll with check_job_status(jobType="transcription"), then get_job_result. 10 sats/minute.

{
  "paymentId": "abc123",
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "What objects are in this image?",
  "modelId": 5    // Optional: defaults to best
}

{
  "paymentId": "abc123",
  "imageUrl": "https://example.com/object.jpg",
  "modelId": 17    // Optional: defaults to best
}

{
  "paymentId": "abc123",
  "phoneNumber": "+14155550100",    // Same as in create_payment
  "message": "Hello from Sats4AI!" // Max 120 chars
}

A 40-character disclaimer is auto-appended to every SMS.

// Option A: Text-to-Speech
{
  "paymentId": "abc123",
  "phoneNumber": "+14155550100",
  "message": "Hello, this is your reminder for tomorrow at 3 PM."
}

// Option B: Play audio file
{
  "paymentId": "abc123",
  "phoneNumber": "+14155550100",
  "audioUrl": "https://example.com/my-audio.mp3",
  "durationMinutes": 2
}

Provide message (max 500 chars) OR audioUrl + durationMinutes (1–30). Pricing scales with duration and destination. Generate audio with text_to_speech first for custom voices.

{
  "paymentId": "abc123",
  "phoneNumber": "+14155550100",
  "task": "Call this restaurant and book a table for 2 at 7pm tonight",
  "durationMinutes": 3,            // Optional: 1-10 (default: 3)
  "voice": "Myra",                  // Optional: Adrian, Myra, Paola, Chris, Marissa, Nathan, Cimo, Drew, Olivia
  "language": "en-US",              // Optional: en-US, en-GB, es-ES, fr-FR, de-DE, ja-JP, zh-CN, multi
  "beginMessage": "Hi, I'd like..." // Optional: opening line for the agent
}

Returns call_id and poll_url. Poll with check_job_status(jobType="ai-call") for transcript + analysis. ~150-250 sats for a 3-min US call.

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>"
}

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>",
  "scale": 4,              // Optional: 2 or 4 (default: 4)
  "face_enhance": false    // Optional: enhance faces during upscale
}

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>",
  "fidelity": 0.5,              // Optional: 0.0 (max quality) to 1.0 (max identity), default 0.5
  "background_enhance": false,  // Optional: also enhance background
  "face_upsample": false,       // Optional: upsample restored faces
  "upscale": 1                  // Optional: overall upscale factor
}

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>"
}

Returns { classification, is_nsfw }. 2 Sats.

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>",
  "query": "cat, dog, person",
  "box_threshold": 0.25,    // Optional: detection confidence (0-1)
  "text_threshold": 0.25    // Optional: text matching confidence (0-1)
}

Returns { detections: [{ label, confidence, bbox }] }. 5 Sats.

{
  "paymentId": "abc123",
  "imageBase64": "<base64-encoded-image>",
  "query": "person"
}

Describe what to remove (e.g. "person", "car", "watermark"). Returns cleaned image as base64. 15 Sats.

{
  "paymentId": "abc123",
  "imageBase64": "<base64-grayscale-image>",
  "model_size": "large"   // Optional: "large" (best) or "tiny" (faster)
}

Returns colorized image as base64. 5 Sats.

{
  "paymentId": "abc123",
  "imageBase64": "<base64-blurry-image>",
  "task_type": "Image Debluring"   // Optional: or "Image Denoising"
}

Returns restored image as base64. ~2 min processing. 20 Sats.

{
  "paymentId": "abc123",
  "document": "data:application/pdf;base64,...",  // PDF or image as data URI
  "model": "OCR"
}

Returns Markdown with tables, headers, and formatting preserved. 10 Sats/page.

{
  "paymentId": "abc123",
  "fileBase64": "...",            // Base64-encoded file
  "fileName": "document.docx",
  "extensionFrom": "docx",
  "extensionTo": "pdf"
}