از ثبتنام تا اولین درخواست API — در کمتر از ۵ دقیقه. همه چیز را گامبهگام یاد بگیرید.
$ curl https://api.apx24.ir/v1/chat/completions \
-H "Authorization: Bearer sk-apx-..." \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"سلام"}]}'
# response
{
"model": "gpt-4o",
"choices": [{ "message": { "content": "سلام! چطور میتوانم کمک کنم؟" } }],
"usage": { "prompt_tokens": 10, "completion_tokens": 8 }
}
۵۰+
مدل
99.9%
آپتایم
<50ms
تأخیر
۲۴/۷
پشتیبانی
از ثبتنام تا اولین پاسخ هوش مصنوعی
با شماره موبایل، بدون نیاز به ایمیل
ثبتنام در اپکس۲۴ با شماره موبایل انجام میشود. نیازی به ایمیل نیست — فقط شماره را وارد کنید، کد تأیید را دریافت کنید و حساب شما ساخته میشود.
شماره موبایل خود را وارد کنید
شماره موبایل
09xx-xxx-xxxx
کلید دسترسی شما به تمام مدلهای هوش مصنوعی
sk-apx-••••••••••••••••••••ایجاد: ۱۴۰۳/۰۷/۱۸
پس از ورود به پنل کاربری، به بخش «کلیدهای API» بروید و یک کلید جدید بسازید. کلید با پیشوند sk-apx- شروع میشود.
هشدار امنیتی
کلید API فقط یکبار پس از ساخت نمایش داده میشود. آن را در جای امن ذخیره کنید. هرگز آن را در کد سمت کلاینت یا Git قرار ندهید.
مدیریت کلیدها:
موجودی حساب را شارژ کنید تا درخواستها کار کنند
اپکس۲۴ با سیستم پرداخت بهاستفاده کار میکند. قبل از ارسال درخواست، موجودی حساب را شارژ کنید. هزینه هر درخواست پس از اجرای موفق از موجودی کسر میشود.
حداقل شارژ
۱۰۰٬۰۰۰ تومان
نرخ تبدیل
۲۷۰٬۰۰۰ ت/دلار
روشهای پرداخت:
موجودی فعلی
۵٬۴۰۰٬۰۰۰ تومان
درخواستها
۱۲۸
توکن مصرفی
۴۸٬۲۰۰
کد آماده را کپی کنید و اجرا کنید
حالا که کلید API دارید و اعتبار شارژ شده، اولین درخواست را بفرستید. فرمت API با استاندارد OpenAI کاملاً سازگار است — فقط base_url و کلید را تغییر دهید.
curl https://api.apx24.ir/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-apx-..." \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "سلام!"}
]
}'پاسخ در قالب استاندارد Chat Completions بازگردانده میشود. فیلد usage تعداد توکنهای مصرفی و هزینه را نشان میدهد.
{
"model": "gpt-4o",
"choices": [{
"message": {
"role": "assistant",
"content": "سلام! چطور میتوانم کمک کنم؟"
}
}],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 8,
"total_tokens": 18
}
}همان کلید، همان احراز هویت، سه endpoint تازه
مدلهای چندرسانهای با فرمت استاندارد OpenAI در دسترساند. قیمت این مدلها بهجای توکن، به ازای هر تصویر، هر ثانیهٔ ویدیو یا هر درخواست گفتار محاسبه میشود و در همان لحظه از موجودی کسر میگردد.
مدل تصویری را از کاتالوگ انتخاب کنید. n تعداد تصویر (حداکثر ۱۰) و صورتحساب به ازای هر تصویر است.
curl https://api.apx24.ir/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-apx-..." \
-d '{
"model": "gemini-nano-banana-2.1",
"prompt": "a single indigo square on white",
"n": 1
}'ساخت ویدیو یک شناسهٔ کار برمیگرداند. وضعیت را با همان مدل پیگیری کنید؛ صورتحساب به ازای هر ثانیه و بر اساس فیلد seconds است. برخی مدلها مقدار seconds را محدود میکنند (مثلاً MiniMax H3 فقط ۶ یا ۱۰) — محدودیت هر مدل در /v1/models زیر apx.video_seconds_allowed اعلام میشود.
curl https://api.apx24.ir/v1/videos \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-apx-..." \
-d '{"model":"kling-3.0","prompt":"slow pan, indigo studio","seconds":6}'
curl "https://api.apx24.ir/v1/videos/task_abc123?model=kling-3.0" \
-H "Authorization: Bearer sk-apx-..."
# دانلود فایل پس از completed — با همان کلید، از خود درگاه
curl "https://api.apx24.ir/v1/videos/task_abc123/content?model=kling-3.0" \
-H "Authorization: Bearer sk-apx-..." \
--output video.mp4آدرس دانلود در پاسخها به خود درگاه اشاره میکند و دانلود مجدد هزینهٔ جداگانه ندارد.
تصویر به ویدیو: مدلهایی که در apx.video_image_input مقدار input_reference دارند (مثل Kling 3.0)، یک تصویر فریم اول میپذیرند — تصویر باید درونخطی (data:image/...;base64,...) در فیلد input_reference بیاید؛ آدرس http برای تصویر منبع fetch نمیشود. فیلدهای image / image_url با مقدار data-URL هم شفاف به همین فیلد نگاشت میشوند (هدر X-APX-Note اعلام میکند). مدلهایی که مقدار false دارند فقط متن میپذیرند (MiniMax H3).
پاسخ یک فایل صوتی (audio/mpeg) است. برخی مدلها هر درخواست و برخی هر کاراکتر محاسبه میشوند.
curl https://api.apx24.ir/v1/audio/speech \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-apx-..." \
-d '{"model":"tts-1","input":"سلام، اپکس۲۴.","voice":"alloy"}' \
--output speech.mp3همان کلاینت OpenAI کافی است؛ فقط base_url را تغییر دهید.
from openai import OpenAI
client = OpenAI(
base_url="https://api.apx24.ir/v1",
api_key="sk-apx-...",
)
image = client.images.generate(
model="gemini-nano-banana-2.1",
prompt="a single indigo square on white",
n=1,
)
print(image.data[0].b64_json[:40])
audio = client.audio.speech.create(
model="tts-1",
voice="alloy",
input="سلام، اپکس۲۴.",
)
audio.write_to_file("speech.mp3")مدل را انتخاب کنید، پیام بزنید و نتیجه را ببینید — بدون نیاز به نصب چیزی.
اپکس۲۴ با تمام ابزارهای سازگار با OpenAI/Anthropic کار میکند. یک تب را انتخاب کنید و راهاندازی را دنبال کنید.
curl https://api.apx24.ir/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-apx-..." \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "سلام!"}
]
}'نحوه محاسبه هزینه و مدیریت موجودی
هزینه بر اساس توکنهای ورودی و خروجی محاسبه میشود. هر توکن تقریباً ۴ کاراکتر است.
قیمت هر مدل بهازای ۱ میلیون توکن مشخص است. قیمت نهایی = (توکن ورودی × قیمت ورودی) + (توکن خروجی × قیمت خروجی).
پس از هر درخواست موفق، هزینه از موجودی حساب کسر میشود. موجودی کافی = درخواست موفق.
هزینه دلاری محاسبه و با نرخ روز به تومان تبدیل میشود. موجودی به تومان است.
فرمول محاسبه هزینه:
cost = (input_tokens / 1,000,000 × input_price) + (output_tokens / 1,000,000 × output_price)برای استفاده بهینه و امن از API
خطاهای ۴۲۹ (rate limit) و ۵xx را با retry و exponential backoff مدیریت کنید. خطاهای ۴xx را retry نکنید.
برای پاسخهای طولانی از "stream": true استفاده کنید تا کاربر پاسخ را زنده ببیند.
اپکس۲۴ بهصورت خودکار بین مسیرهای پشتیبان سوئیچ میکند. نیازی به مدیریت failover در سمت کلاینت نیست.
کلید API را در متغیرهای محیطی ذخیره کنید. هرگز آن را در کد سمت کلاینت یا Git قرار ندهید.
قبل از درخواستهای حجیم، موجودی را چک کنید. خطای ۴۰۲ یعنی موجودی ناکافی.
هر کلید دارای محدودیت RPM (درخواست در دقیقه) و TPM (توکن در دقیقه) است. هدر X-RateLimit-* را بررسی کنید.
به صفحه /account/login بروید، شماره موبایل خود را وارد کنید و کد تأیید را دریافت کنید. پس از ثبتنام، به پنل کاربری دسترسی خواهید داشت.
پس از ورود، به صفحه «کلیدهای API» در پنل کاربری بروید و یک کلید جدید بسازید. کلید با پیشوند sk-apx- شروع میشود و فقط یکبار نمایش داده میشود.
حداقل مبلغ شارژ ۱۰۰٬۰۰۰ تومان است. پرداخت از طریق درگاه بانکی و کارتبهکارت انجام میشود.
بله. فرمت API کاملاً با استاندارد OpenAI و Anthropic سازگار است. فقط آدرس base_url و کلید API را تغییر دهید.
هزینه = (توکن ورودی × قیمت ورودی) + (توکن خروجی × قیمت خروجی). قیمتها بهازای ۱ میلیون توکن و به تومان است.
درخواست با خطای ۴۰۲ (insufficient_balance) رد میشود. موجودی را شارژ کنید تا درخواستها دوباره کار کنند.
بله. با "stream": true پاسخ بهصورت SSE جریانی ارسال میشود. سازگار با OpenAI SDK و فرمت استاندارد.
بیش از ۵۰ مدل از خانوادههای GPT، Claude، Gemini، Mistral و سایر مدلهای متنباز. لیست کامل در صفحه قیمتها.
در کمتر از ۵ دقیقه ثبتنام کنید، کلید API بسازید و اولین درخواست هوش مصنوعی خود را ارسال کنید.