ارزان‌ترین ارائه‌دهنده‌ی API
هوش مصنوعی در تمام اینترنت.

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "flux-dev",
      "prompt": "یک فنجان چای روی میز چوبی کنار پنجره، نور ملایم صبح"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break
    if r.get("progress"):
        print(r["progress"]["percent"], "%")   # درصد واقعی ساخت

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "flux-dev",
        "prompt": "یک فنجان چای روی میز چوبی کنار پنجره، نور ملایم صبح"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "z-image",
      "prompt": "پرتره‌ی یک گربه‌ی ایرانی سفید روی پس‌زمینه‌ی آبی"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break
    if r.get("progress"):
        print(r["progress"]["percent"], "%")   # درصد واقعی ساخت

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "z-image",
        "prompt": "پرتره‌ی یک گربه‌ی ایرانی سفید روی پس‌زمینه‌ی آبی"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "cartoon-create",
      "prompt": "یک روباه بامزه با کلاه قرمز در جنگل پاییزی"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break
    if r.get("progress"):
        print(r["progress"]["percent"], "%")   # درصد واقعی ساخت

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "cartoon-create",
        "prompt": "یک روباه بامزه با کلاه قرمز در جنگل پاییزی"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "qwen-image-edit",
      "prompt": "پس‌زمینه را به ساحل غروب تغییر بده",
      "image": "https://example.com/photo.jpg"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break
    if r.get("progress"):
        print(r["progress"]["percent"], "%")   # درصد واقعی ساخت

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "qwen-image-edit",
        "prompt": "پس‌زمینه را به ساحل غروب تغییر بده",
        "image": "https://example.com/photo.jpg"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "image-expand",
      "image": "https://example.com/photo.jpg",
      "directions": [
        "left",
        "right"
      ],
      "size": "1024x1024",
      "prompt": "ادامه‌ی ساحل و آسمان ابری"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "image-expand",
        "image": "https://example.com/photo.jpg",
        "directions": [
          "left",
          "right"
        ],
        "size": "1024x1024",
        "prompt": "ادامه‌ی ساحل و آسمان ابری"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "video-wan22",
      "image": "https://example.com/photo.jpg",
      "prompt": "دوربین آرام به سوژه نزدیک می‌شود"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break
    if r.get("progress"):
        print(r["progress"]["percent"], "%")   # درصد واقعی ساخت

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "video-wan22",
        "image": "https://example.com/photo.jpg",
        "prompt": "دوربین آرام به سوژه نزدیک می‌شود"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "alpha-tts",
      "text": "هی، گوش کن! یه راز دارم که فقط به تو می‌گم.",
      "speaker": "shahab",
      "tone": "با لحنی مرموز، شیطنت‌آمیز و نجواگونه"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "alpha-tts",
        "text": "هی، گوش کن! یه راز دارم که فقط به تو می‌گم.",
        "speaker": "shahab",
        "tone": "با لحنی مرموز، شیطنت‌آمیز و نجواگونه"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "alpha-change-voice",
      "source_audio": "https://example.com/voice.mp3",
      "reference_audio": "https://example.com/voice.mp3"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "alpha-change-voice",
        "source_audio": "https://example.com/voice.mp3",
        "reference_audio": "https://example.com/voice.mp3"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "voice-enhance",
      "audio": "https://example.com/voice.mp3"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "voice-enhance",
        "audio": "https://example.com/voice.mp3"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, time, requests

KEY = os.environ["ALPHA_KEY"]
job = requests.post(
    "https://api.appalpha.ir/v1/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
      "model": "vocal-separate",
      "audio": "https://example.com/voice.mp3",
      "stem": "vocal",
      "format": "WAV"
    },
).json()

# اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if "error" in job:
    raise SystemExit("خطا: " + job["error"]["message"])

# تا آماده شدن خروجی صبر می‌کنیم
while True:
    time.sleep(3)
    r = requests.get(job["poll_url"],
                     headers={"Authorization": f"Bearer {KEY}"}).json()
    if r["status"] != "processing":
        break

print(r["output"]["url"] if r["status"] == "ready"
      else r["error"]["message"])

const KEY = process.env.ALPHA_KEY;

const job = await fetch("https://api.appalpha.ir/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "vocal-separate",
        "audio": "https://example.com/voice.mp3",
        "stem": "vocal",
        "format": "WAV"
      }),
}).then((r) => r.json());

// اگر درخواست پذیرفته نشود، به‌جای شناسه یک پیام فارسی برمی‌گردد
if (job.error) throw new Error(job.error.message);

// تا آماده شدن خروجی صبر می‌کنیم
let out;
do {
  await new Promise((r) => setTimeout(r, 3000));
  out = await fetch(job.poll_url, {
    headers: { Authorization: `Bearer ${KEY}` },
  }).then((r) => r.json());
} while (out.status === "processing");

console.log(out.status === "ready" ? out.output.url : out.error.message);

import os, requests

KEY = os.environ["ALPHA_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

# تاریخچه را خودتان نگه می‌دارید و هر بار کامل می‌فرستید
history = [{"role": "user", "content": "سلام، سفارشم کی می‌رسد؟"}]

r = requests.post("https://api.appalpha.ir/v1/chat", headers=H, json={
    "model": "aya-chat",
    "system": "تو پشتیبان فروشگاه هستی و کوتاه و مؤدب جواب می‌دهی.",
    "messages": history,
}).json()

# اگر چیزی درست نباشد، سرور به‌جای reply یک پیام فارسی می‌دهد.
# بدون این چک، پایتون فقط KeyError می‌دهد و علت اصلی دیده نمی‌شود.
if "error" in r:
    raise SystemExit("خطا: " + r["error"]["message"])

print(r["reply"])                 # متن پاسخ
print(r["cost_toman"])            # همیشه ۳۰

# پاسخ را به تاریخچه اضافه کنید تا پیام بعدی کانتکست داشته باشد
history.append({"role": "assistant", "content": r["reply"]})


# ── همان گفتگو، اما کلمه‌به‌کلمه ──────────────────────────────
# فقط دو تفاوت با بالا دارد: "stream": True در بدنه، و stream=True
# در خودِ requests تا پاسخ تکه‌تکه خوانده شود.
import json

with requests.post("https://api.appalpha.ir/v1/chat", headers=H, stream=True, json={
    "model": "aya-chat",
    "messages": history,
    "stream": True,
}) as resp:
    reply = ""
    for line in resp.iter_lines(decode_unicode=True):
        if not line or not line.startswith("data:"):
            continue
        raw = line[5:].strip()
        if raw == "[DONE]":
            break
        ev = json.loads(raw)
        if ev["type"] == "delta":
            reply += ev["text"]
            print(ev["text"], end="", flush=True)      # چاپ زنده
        elif ev["type"] == "done":
            print("\nهزینه:", ev["cost_toman"], "تومان")
        elif ev["type"] == "error":
            print("\nخطا:", ev["message"])

const KEY = process.env.ALPHA_KEY;

const history = [{ role: "user", content: "سلام، سفارشم کی می‌رسد؟" }];

const r = await fetch("https://api.appalpha.ir/v1/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "aya-chat",
    system: "تو پشتیبان فروشگاه هستی و کوتاه و مؤدب جواب می‌دهی.",
    messages: history,
  }),
}).then((r) => r.json());

// اگر چیزی درست نباشد، سرور به‌جای reply یک پیام فارسی می‌دهد
if (r.error) throw new Error(r.error.message);

console.log(r.reply);
history.push({ role: "assistant", content: r.reply });


// ── همان گفتگو، اما کلمه‌به‌کلمه ──────────────────────────────
// stream: true را اضافه کنید و پاسخ را به‌جای json() تکه‌تکه بخوانید.
const res = await fetch("https://api.appalpha.ir/v1/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "aya-chat",
    messages: history,
    stream: true,
  }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "", reply = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  // یک رویداد ممکن است بین دو تکه‌ی شبکه نصف شود، پس فقط
  // رویدادهای کاملِ جداشده با خط خالی پردازش می‌شوند.
  let cut;
  while ((cut = buffer.indexOf("\n\n")) !== -1) {
    const chunk = buffer.slice(0, cut).trim();
    buffer = buffer.slice(cut + 2);
    if (!chunk.startsWith("data:")) continue;

    const raw = chunk.slice(5).trim();
    if (raw === "[DONE]") continue;

    const ev = JSON.parse(raw);
    if (ev.type === "delta") {
      reply += ev.text;
      bubble.textContent = reply;        // نمایش زنده
    } else if (ev.type === "done") {
      console.log("هزینه:", ev.cost_toman);
    } else if (ev.type === "error") {
      console.error(ev.message);
    }
  }
}