Z.AI API رایگان

هدف استفاده و نیت جست‌وجو

Z.AI برای توسعه‌دهنده‌ای مناسب است که یک API سازگار با OpenAI برای چت و تولید متن می‌خواهد. وضعیت سهمیه و دسترسی ایران باید از خلاصه فنی و Evidence تاریخ‌دار همین صفحه خوانده شود.

مراحل ثبت‌نام

1. از صفحه رسمی Z.AI وارد حساب شوید و کلید API بسازید.
2. کلید را در متغیر محیطی ذخیره کنید و آن را در کد یا مخزن Git قرار ندهید.
3. پیش از انتخاب مدل، مستندات API را بررسی کنید.

نمونه اولین درخواست API

curl https://api.z.ai/v1/chat/completions \
  -H "Authorization: Bearer ${ZAI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"model":"default","messages":[{"role":"user","content":"یک پاسخ کوتاه فارسی بنویس"}]}'

نمونه از Endpoint سازگار با OpenAI استفاده می‌کند. شناسه مدل باید با مستندات رسمی تطبیق داده شود.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-08-05

خطاهای رایج و رفع اشکال

• 401 — کلید API نامعتبر یا ارسال‌نشده

  وجود متغیر ZAI_API_KEY را بررسی کنید و هدر Bearer را درست بسازید. منبع رسمی (2026-08-05)

• 429 — عبور از Rate Limit

  هدر Retry-After را بخوانید و درخواست‌ها را با تأخیر ارسال کنید. منبع رسمی (2026-08-05)

چه زمانی این Provider انتخاب مناسبی نیست؟

• وقتی وضعیت دسترسی نمایش‌داده‌شده در همین صفحه با الزامات پروژه شما سازگار نیست.
• وقتی بدون بررسی مدل و محدودیت حساب، به ظرفیت ثابت و SLA تضمین‌شده نیاز دارید.

راهنماهای مرتبط

• openai-sdk-custom-base-url
• free-coding-api

آخرین بازبینی محتوای این صفحه: 2026-08-05