مستندات API

راهنمای کامل استفاده از سرویس AmirCode API — سازگار با OpenAI SDK

مقدمه احراز هویت مدل‌ها Chat Completions نمونه Python نمونه cURL خطاها محدودیت‌ها

مقدمه

AmirCode API یک سرویس چت هوش مصنوعی است که با استاندارد OpenAI سازگار است. کافی است base_url و api_key را تنظیم کنید.

Base URL: https://api.amircoder.isfpardaz.ir/v1

هر کاربر یک توکن دارد که برای همه مدل‌ها قابل استفاده است. تا قبل از تأیید ایمیل، توکن کار نمی‌کند.

احراز هویت

تمام درخواست‌ها باید هدر Authorization داشته باشند:

Authorization: Bearer sk-amircode-xxxxxxxxxxxxxxxx

توکن خود را از داشبورد یا صفحه تنظیمات دریافت کنید.

مدل‌های موجود

لیست مدل‌ها از طریق GET /v1/models نیز قابل دریافت است.

شناسه مدل (model)	نام	هزینه هر درخواست	حداکثر ورودی	حداکثر خروجی
`minimax-m3`	Minimax M3	2 توکن	8,192	4,096
`step-3.7-flash`	Step 3.7 Flash	1 توکن	16,384	4,096
`qwen3.8-27b`	Qwen 3.8 27B	3 توکن	32,768	8,192
`qwen3.6-35b-a3b`	Qwen 3.6 35B A3B	4 توکن	32,768	8,192
`qwen3-32b`	Qwen 3 32B	3 توکن	32,768	8,192
`gemma-4-31b-it`	Gemma 4 31B IT	2 توکن	8,192	4,096
`gemma-4-26b-a4b-it`	Gemma 4 26B A4B IT	2 توکن	8,192	4,096
`gpt-oss-120b`	GPT OSS 120B	5 توکن	32,768	8,192
`gpt-oss-20b`	GPT OSS 20B	1 توکن	8,192	4,096

Chat Completions

Endpoint: POST /v1/chat/completions

پارامترها

model (الزامی) — شناسه مدل از جدول بالا
messages (الزامی) — آرایه پیام‌ها با role و content
temperature — بین ۰ تا ۲ (پیش‌فرض ۰.۷)
max_tokens — حداکثر توکن خروجی (محدود به سقف مدل)
stream — باید false باشد (استریم پشتیبانی نمی‌شود)

نمونه بدنه درخواست

{
  "model": "gemma-4-31b-it",
  "messages": [
    {"role": "system", "content": "شما یک دستیار مفید هستید."},
    {"role": "user", "content": "سلام!"}
  ],
  "temperature": 0.7,
  "max_tokens": 1024,
  "stream": false
}

نمونه Python (OpenAI SDK و requests)

با کتابخانه openai

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-amircode-YOUR_TOKEN",
    base_url="https://api.amircoder.isfpardaz.ir/v1"
)

# یک کلید برای همه مدل‌ها
response = client.chat.completions.create(
    model="gemma-4-31b-it",
    messages=[
        {"role": "user", "content": "یک شعر کوتاه بگو"}
    ],
    temperature=0.7,
    max_tokens=512,
    stream=False
)

print(response.choices[0].message.content)

# لیست مدل‌ها
models = client.models.list()
for m in models.data:
    print(m.id)

با کتابخانه requests

# pip install requests
import requests

r = requests.post(
    "https://api.amircoder.isfpardaz.ir/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-amircode-YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemma-4-31b-it",
        "messages": [{"role": "user", "content": "سلام"}],
        "stream": False
    },
    timeout=60
)
print(r.json()["choices"][0]["message"]["content"])
            

نمونه cURL

curl -X POST "https://api.amircoder.isfpardaz.ir/v1/chat/completions" \
  -H "Authorization: Bearer sk-amircode-YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-32b",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'

کدهای خطا

401 — توکن نامعتبر یا ارسال نشده
403 — ایمیل تأیید نشده یا حساب مسدود
402 — موجودی توکن کافی نیست
400 — پارامتر اشتباه (مثلاً stream=true یا مدل ناموجود)
503 — سرویس موقتاً در دسترس نیست

فرمت خطا:

{
  "error": {
    "message": "پیام خطا",
    "type": "invalid_request_error",
    "code": 400
  }
}

محدودیت‌ها و اعتبار

روزانه 300 توکن رایگان به حساب اضافه می‌شود.
اگر در یک روز کمتر از 100 توکن مصرف کنید، روز بعد اعتبار رایگان داده نمی‌شود.
هر درخواست بسته به مدل، مقدار مشخصی توکن از موجودی کم می‌کند.
خروجی استریم (stream) پشتیبانی نمی‌شود.
یک توکن API برای تمام مدل‌ها قابل استفاده است.