ars0n API

# Set both env vars, then use them in requests:
export ARS0N_API_BASE_URL="https://app.ars0n.ai"
export ARS0N_API_KEY="sk_live_a1b2c3d4e5f6..."

curl $ARS0N_API_BASE_URL/api/v1/credits \
  -H "Authorization: Bearer $ARS0N_API_KEY"

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

curl $ARS0N_API_BASE_URL/api/v1/credits \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# → {
#   "balance": 1100,
#   "tier": "starter",
#   "activeGenerations": 1,
#   "limits": { "maxConcurrentGenerations": 1, "rateLimitRpm": 60 }
# }

# Cinematic video estimate
curl -X POST $ARS0N_API_BASE_URL/api/v1/estimate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "adFormat": "video", "imageCount": 3, "duration": 15 }'

# → { "adFormat": "video", "estimatedCredits": 199, "breakdown": [...], "jobCount": 8, "sceneCount": 3 }

# Radio estimate
curl -X POST $ARS0N_API_BASE_URL/api/v1/estimate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "adFormat": "radio", "duration": 30 }'

# → { "adFormat": "radio", "estimatedCredits": 10, "breakdown": [...], "jobCount": 2, "sceneCount": 0 }

curl $ARS0N_API_BASE_URL/api/v1/packages \
  -H "Authorization: Bearer $ARS0N_API_KEY"

# → { "packages": [
#     { "name": "API Starter", "credits": 1100, "priceCents": 3900  },
#     { "name": "API Growth",  "credits": 3500, "priceCents": 11900 },
#     { "name": "API Scale",   "credits": 9000, "priceCents": 29900 }
# ] }

# 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)
  "code": "..."        // Present on 500s — a stable machine code, e.g. "provider_unavailable"
}

{
  "error": "Insufficient API credits",
  "required": 140,
  "available": 45,
  "message": "This generation requires 140 API credits but you only have 45. Purchase API credits at /settings/billing."
}

{
  "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    = os.environ["ARS0N_API_BASE_URL"] + "/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 (29 credits/scene vs 19 for default 2)
})
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['type']}: {j['error_message']}")
        break

    time.sleep(10)

import fs from "fs";

const API_KEY = process.env.ARS0N_API_KEY!;
const BASE = process.env.ARS0N_API_BASE_URL + "/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);

import requests, time, os

API_KEY = os.environ["ARS0N_API_KEY"]
BASE    = os.environ["ARS0N_API_BASE_URL"] + "/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


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


# ── 2. (Optional) 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"]


# ── 3. Generate radio ad ─────────────────────────────────────
resp = requests.post(f"{BASE}/generate", headers={
    **HEADERS, "Content-Type": "application/json",
}, json={
    "adFormat": "radio",          # Audio-only — no images needed
    "prompt": "Premium noise-canceling headphones. Deep bass, sleek design.",
    "duration": 30,
    "voiceId": voice_id,
    "musicAssetId": music_id,     # Optional background music

    # Creative direction
    "voiceStyle": "warm and authoritative",
    "tone": "premium tech",
})
resp.raise_for_status()
data = resp.json()
version_id = data["versionId"]
print(f"Radio ad started: {version_id} ({data['totalCredits']} credits)")


# ── 4. Poll for completion ────────────────────────────────────
while True:
    resp = requests.get(f"{BASE}/jobs/{version_id}", headers=HEADERS)
    status = resp.json()
    print(f"  {status['status']} — {status['progress']}%")

    if status["status"] == "completed":
        print(f"\nAudio ready: {status['audioUrl']}")
        break
    elif status["status"] == "failed":
        print("\nFailed.")
        break

    time.sleep(5)  # Radio ads are faster — poll every 5s

const API_KEY = process.env.ARS0N_API_KEY!;
const BASE = process.env.ARS0N_API_BASE_URL + "/api/v1";
const headers = { Authorization: `Bearer ${API_KEY}` };

// 1. Find a voice
const voicesRes = await fetch(`${BASE}/voices?gender=female`, { headers });
const { voices } = await voicesRes.json();
const voiceId = voices[0].voice_id;

// 2. Generate radio ad (no images needed)
const genRes = await fetch(`${BASE}/generate`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    adFormat: "radio",
    prompt: "Premium noise-canceling headphones — deep bass, sleek design",
    duration: 30,
    voiceId,
    tone: "premium tech",
  }),
});
const { versionId, totalCredits } = await genRes.json();
console.log(`Radio ad started (${totalCredits} credits)`);

// 3. Poll until done
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") {
    console.log(`Audio: ${data.audioUrl}`);
    break;
  } else if (data.status === "failed") {
    console.log("Failed");
    break;
  }
  await new Promise((r) => setTimeout(r, 5_000));
}

# Generate with image URLs — server downloads them for you
curl -X POST $ARS0N_API_BASE_URL/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"
  }'

curl -X POST $ARS0N_API_BASE_URL/api/v1/generate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "adFormat": "radio",
    "prompt": "Organic cold-pressed juice — fresh, healthy, delicious",
    "duration": 15,
    "voiceId": "pNInz6obpgDQGcFmaJgB",
    "voiceStyle": "energetic and friendly",
    "tone": "health-conscious lifestyle"
  }'

# Video estimate
curl -X POST $ARS0N_API_BASE_URL/api/v1/estimate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "adFormat": "video", "imageCount": 3, "duration": 15 }'

# → { "adFormat": "video", "estimatedCredits": 199, "breakdown": [...], "jobCount": 8 }

# Radio estimate
curl -X POST $ARS0N_API_BASE_URL/api/v1/estimate \
  -H "Authorization: Bearer $ARS0N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "adFormat": "radio", "duration": 30 }'

# → { "adFormat": "radio", "estimatedCredits": 10, "breakdown": [...], "jobCount": 2 }

import requests, os

API_KEY = os.environ["ARS0N_API_KEY"]
BASE    = os.environ["ARS0N_API_BASE_URL"] + "/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Video estimate
resp = requests.post(f"{BASE}/estimate", headers=HEADERS, json={
    "adFormat": "video",
    "imageCount": 3,
    "duration": 15,
})
resp.raise_for_status()
video_est = resp.json()
print(f"Video: {video_est['estimatedCredits']} credits, {video_est['jobCount']} jobs")

# Radio estimate
resp = requests.post(f"{BASE}/estimate", headers=HEADERS, json={
    "adFormat": "radio",
    "duration": 30,
})
resp.raise_for_status()
radio_est = resp.json()
print(f"Radio: {radio_est['estimatedCredits']} credits, {radio_est['jobCount']} jobs")

const API_KEY = process.env.ARS0N_API_KEY!;
const BASE = process.env.ARS0N_API_BASE_URL + "/api/v1";
const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// Video estimate
const videoRes = await fetch(`${BASE}/estimate`, {
  method: "POST",
  headers,
  body: JSON.stringify({ adFormat: "video", imageCount: 3, duration: 15 }),
});
const videoEst = await videoRes.json();
console.log(`Video: ${videoEst.estimatedCredits} credits, ${videoEst.jobCount} jobs`);

// Radio estimate
const radioRes = await fetch(`${BASE}/estimate`, {
  method: "POST",
  headers,
  body: JSON.stringify({ adFormat: "radio", duration: 30 }),
});
const radioEst = await radioRes.json();
console.log(`Radio: ${radioEst.estimatedCredits} credits, ${radioEst.jobCount} jobs`);

import requests

BASE = "https://ars0n.ai"
headers = {"Authorization": "Bearer sk_live_YOUR_KEY"}

# 1. Generate plan
plan_res = requests.post(f"{BASE}/api/v1/plan", headers=headers, json={
    "prompt": "Premium skincare serum with vitamin C",
    "adFormat": "video",
    "duration": 30,
    "voiceId": "voice_id",
    "imageAssetIds": ["asset-1", "asset-2"]
})
plan_data = plan_res.json()

# 2. Edit the script
plan = plan_data["plan"]
plan["voiceover_segments"][0]["text"] = "Discover radiant skin."
plan["voiceover_script"] = " ".join(s["text"] for s in plan["voiceover_segments"])

# 3. Preview voice
preview = requests.post(f"{BASE}/api/v1/preview-voice", headers=headers, json={
    "text": plan["voiceover_script"],
    "voiceId": "voice_id"
})
print(f"Duration: {preview.json()['durationSeconds']}s")

# 4. Generate with modified plan. quotedCredits is required with a plan —
#    if your edits changed the price, the API responds 409 PRICE_CHANGED
#    with newTotal instead of charging more than you were quoted.
gen = requests.post(f"{BASE}/api/v1/generate", headers=headers, json={
    "prompt": "Premium skincare serum",
    "adFormat": "video",
    "duration": 30,
    "voiceId": "voice_id",
    "imageAssetIds": ["asset-1", "asset-2"],
    "plan": plan,
    "quotedCredits": plan_data["estimatedCredits"]
})
version_id = gen.json()["versionId"]

const BASE = "https://ars0n.ai";
const headers = { Authorization: "Bearer sk_live_YOUR_KEY", "Content-Type": "application/json" };

// 1. Generate plan
const planRes = await fetch(`${BASE}/api/v1/plan`, {
  method: "POST", headers,
  body: JSON.stringify({ prompt: "Premium skincare", adFormat: "video", duration: 30, voiceId: "voice_id", imageAssetIds: ["asset-1"] })
});
const { plan, estimatedCredits } = await planRes.json();

// 2. Edit script
plan.voiceover_segments[0].text = "Discover radiant skin.";
plan.voiceover_script = plan.voiceover_segments.map(s => s.text).join(" ");

// 3. Generate with modified plan + custom clip. quotedCredits is required
//    with a plan — a 409 PRICE_CHANGED response means your edits changed
//    the price; re-confirm with the returned newTotal.
const genRes = await fetch(`${BASE}/api/v1/generate`, {
  method: "POST", headers,
  body: JSON.stringify({
    prompt: "Premium skincare", adFormat: "video", duration: 30,
    voiceId: "voice_id", imageAssetIds: ["asset-1"],
    plan,
    quotedCredits: estimatedCredits,
    customClips: [{ position: 1, asset_id: "clip-asset-id", voiceover_text: "See results.", duration_seconds: 8 }]
  })
});

# List all voices
curl $ARS0N_API_BASE_URL/api/v1/voices \
  -H "Authorization: Bearer $ARS0N_API_KEY"

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

# Search by name or description
curl "$ARS0N_API_BASE_URL/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", ... }] }