ars0n API

curl https://your-app.com/api/v1/credits \
  -H "Authorization: Bearer sk_live_a1b2c3d4e5f6..."

# Every language works the same way:
# Just set the Authorization header to "Bearer <your-key>"

curl https://your-app.com/api/v1/credits \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# → {
#   "balance": 450,
#   "tier": "starter",
#   "activeJobs": 1,
#   "limits": { "maxConcurrentJobs": 3, "rateLimitRpm": 60 }
# }

curl https://your-app.com/api/v1/packages \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# → { "packages": [
#     { "name": "API Starter", "credits": 500,  "priceCents": 3900  },
#     { "name": "API Growth",  "credits": 2000, "priceCents": 11900 },
#     { "name": "API Scale",   "credits": 5000, "priceCents": 24900 }
# ] }

# Headers included on every response:
X-RateLimit-Limit: 60          # Your max requests per window
X-RateLimit-Remaining: 42      # Requests left in this window
X-RateLimit-Reset: 1711234567  # Unix timestamp when window resets
X-Request-Id: a1b2c3d4-...    # Unique ID for debugging

import time

def api_call_with_retry(fn, max_retries=3):
    for attempt in range(max_retries):
        resp = fn()
        if resp.status_code != 429:
            return resp

        reset_at = int(resp.headers.get("X-RateLimit-Reset", 0))
        wait = max(reset_at - time.time(), 1)
        print(f"Rate limited. Waiting {wait:.0f}s...")
        time.sleep(wait)

    raise Exception("Max retries exceeded")

{
  "error": "Insufficient credits: 100 required but only 45 available",
  "details": { ... }  // Present on validation errors (400)
}

{
  "error": "Validation failed",
  "details": {
    "fieldErrors": {
      "duration": ["Duration must be 15, 30, or 60"],
      "voiceId": ["Required"]
    },
    "formErrors": []
  }
}

resp = requests.post(f"{BASE_URL}/generate", headers=headers, json=payload)
if not resp.ok:
    request_id = resp.headers.get("X-Request-Id")
    print(f"Failed: {resp.status_code} — Request ID: {request_id}")
    print(resp.json())

import requests, time, os

API_KEY = os.environ["ARS0N_API_KEY"]
BASE    = "https://your-app.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


# ── 1. Upload product image ──────────────────────────────────
with open("product.png", "rb") as f:
    resp = requests.post(
        f"{BASE}/assets",
        headers=HEADERS,
        files={"file": ("product.png", f, "image/png")},
        data={"category": "product_image"},
    )
    resp.raise_for_status()
    image_id = resp.json()["assetId"]
    print(f"Uploaded image: {image_id}")


# ── 2. Upload logo ───────────────────────────────────────────
with open("logo.png", "rb") as f:
    resp = requests.post(
        f"{BASE}/assets",
        headers=HEADERS,
        files={"file": ("logo.png", f, "image/png")},
        data={"category": "logo"},
    )
    resp.raise_for_status()
    logo_id = resp.json()["assetId"]


# ── 3. Upload background music ───────────────────────────────
with open("bg-music.mp3", "rb") as f:
    resp = requests.post(
        f"{BASE}/assets",
        headers=HEADERS,
        files={"file": ("bg-music.mp3", f, "audio/mpeg")},
        data={"category": "music"},
    )
    resp.raise_for_status()
    music_id = resp.json()["assetId"]


# ── 4. Find a voice ──────────────────────────────────────────
resp = requests.get(
    f"{BASE}/voices",
    headers=HEADERS,
    params={"gender": "female", "accent": "american"},
)
resp.raise_for_status()
voices = resp.json()["voices"]
voice_id = voices[0]["voice_id"]
print(f"Using voice: {voices[0]['name']} ({voice_id})")


# ── 5. Generate video with full options ───────────────────────
resp = requests.post(f"{BASE}/generate", headers={
    **HEADERS, "Content-Type": "application/json",
}, json={
    # Required
    "prompt": "Premium noise-canceling headphones. Sleek design, deep bass.",
    "imageAssetIds": [image_id],
    "duration": 30,
    "voiceId": voice_id,

    # Style
    "aspectRatio": "9:16",
    "ctaDesign": "gradient",
    "gradientColor": "#FF5500",
    "companyName": "SoundWave Audio",
    "logoAssetId": logo_id,
    "musicAssetId": music_id,

    # Creative direction
    "voiceStyle": "energetic and confident",
    "musicMood": "upbeat electronic",
    "tone": "premium luxury tech",
    "emotion": "excitement",
    "editStyle": "Product floating in mid-air with dramatic studio lighting, reflections on glossy surface, cinematic depth of field",

    # Pipeline tuning
    "qualityLoopVariants": 3,  # Max quality — 3 variants per scene
})
resp.raise_for_status()
data = resp.json()
version_id = data["versionId"]
print(f"Generation started: {version_id}")
print(f"Credits charged: {data['totalCredits']}")
print(f"Jobs queued: {data['jobCount']}")


# ── 6. Poll for completion ────────────────────────────────────
while True:
    resp = requests.get(f"{BASE}/jobs/{version_id}", headers=HEADERS)
    resp.raise_for_status()
    status = resp.json()

    pct = status["progress"]
    jobs = status["jobs"]
    print(f"  {status['status']} — {pct}% "
          f"({jobs['completed']}/{jobs['total']} jobs)")

    if status["status"] == "completed":
        print(f"\nVideo ready: {status['videoUrl']}")
        break
    elif status["status"] == "failed":
        print(f"\nFailed. Check job details:")
        for j in jobs["details"]:
            if j["status"] == "failed":
                print(f"  {j['job_type']}: {j['error_message']}")
        break

    time.sleep(10)

import fs from "fs";

const API_KEY = process.env.ARS0N_API_KEY!;
const BASE = "https://your-app.com/api/v1";
const headers = { Authorization: `Bearer ${API_KEY}` };


// ── Helper: upload a file ────────────────────────────────────
async function uploadAsset(
  filePath: string,
  category: string,
): Promise<string> {
  const file = fs.readFileSync(filePath);
  const form = new FormData();
  form.append("file", new Blob([file]), filePath.split("/").pop()!);
  form.append("category", category);

  const res = await fetch(`${BASE}/assets`, {
    method: "POST",
    headers,
    body: form,
  });
  if (!res.ok) throw new Error(`Upload failed: ${await res.text()}`);
  return (await res.json()).assetId;
}


// ── Helper: poll until done ──────────────────────────────────
async function pollUntilDone(versionId: string): Promise<{
  status: string;
  videoUrl: string | null;
}> {
  while (true) {
    const res = await fetch(`${BASE}/jobs/${versionId}`, { headers });
    const data = await res.json();
    console.log(`  ${data.status} — ${data.progress}%`);

    if (data.status === "completed" || data.status === "failed") {
      return data;
    }
    await new Promise((r) => setTimeout(r, 10_000));
  }
}


// ── Main ─────────────────────────────────────────────────────
async function main() {
  // 1. Upload assets
  const imageId = await uploadAsset("./product.png", "product_image");
  const logoId  = await uploadAsset("./logo.png", "logo");
  const musicId = await uploadAsset("./music.mp3", "music");
  console.log("Assets uploaded");

  // 2. Find a voice
  const voicesRes = await fetch(
    `${BASE}/voices?gender=male&q=narrator`,
    { headers },
  );
  const { voices } = await voicesRes.json();
  const voiceId = voices[0].voice_id;
  console.log(`Using voice: ${voices[0].name}`);

  // 3. Generate
  const genRes = await fetch(`${BASE}/generate`, {
    method: "POST",
    headers: { ...headers, "Content-Type": "application/json" },
    body: JSON.stringify({
      prompt: "Premium headphones — immersive sound, modern design",
      imageAssetIds: [imageId],
      duration: 15,
      voiceId,
      aspectRatio: "9:16",
      logoAssetId: logoId,
      musicAssetId: musicId,
      companyName: "SoundWave",
      ctaDesign: "bold",
      tone: "premium tech",
    }),
  });

  if (!genRes.ok) throw new Error(await genRes.text());
  const { versionId, totalCredits } = await genRes.json();
  console.log(`Started (${totalCredits} credits)`);

  // 4. Poll
  const result = await pollUntilDone(versionId);
  if (result.videoUrl) {
    console.log(`Video: ${result.videoUrl}`);
  }
}

main().catch(console.error);

# Generate with image URLs — server downloads them for you
curl -X POST https://your-app.com/api/v1/generate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury skincare product — clean, minimal, elegant",
    "imageUrls": [
      "https://example.com/product-front.png",
      "https://example.com/product-side.png"
    ],
    "duration": 15,
    "voiceId": "pNInz6obpgDQGcFmaJgB",
    "aspectRatio": "16:9",
    "companyName": "Glow Labs",
    "ctaDesign": "minimal"
  }'

# List all voices
curl https://your-app.com/api/v1/voices \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# Filter by gender + accent
curl "https://your-app.com/api/v1/voices?gender=female&accent=british" \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# Search by name or description
curl "https://your-app.com/api/v1/voices?q=narrator" \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# Each voice has a voice_id — use it in the generate call:
# → { "voices": [{ "voice_id": "abc...", "name": "Charlotte", ... }] }