API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

Harnes
اپ اختصاصی ۲۹۲۸ — پیشنهاد ما
RikkaHub
رایگان و متن‌باز
ChatterUI
رایگان و متن‌باز، نصب از GitHub
Layla
از Google Play

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال Harnes

Android · ۵ قدم
  1. ۱

    انتخاب یا ساخت کلید API

    از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

    کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

  2. ۲

    دانلود و نصب

    فایل APK را روی گوشی دانلود و بازش کنید. اگر گوشی اجازه‌ی نصب خواست، گزینه‌ی «اجازه از این منبع» (Install unknown apps) را برای مرورگر روشن کنید و دوباره Install را بزنید.

    حجم برنامه کمتر از ۱ مگابایت است و روی اندروید ۶ به بالا نصب می‌شود.

  3. ۳

    وارد کردن کلید

    در اولین اجرا، پنجره‌ی تنظیمات خودکار باز می‌شود (بعداً از منوی ☰ ← تنظیمات). کلید را در کادر کلید API بچسبانید:

    کلید API
    sk-...

    دکمه‌ی تست اتصال را بزنید. اگر «اتصال برقرار است» آمد، ذخیره را بزنید. آدرس سرویس داخل برنامه ثابت است و لازم نیست چیزی وارد کنید.

  4. ۴

    انتخاب مدل و گفتگو

    روی نام مدل در بالای صفحه بزنید و مدل دلخواه را انتخاب کنید (مثلاً Claude Sonnet 5 برای کارهای روزمره). بعد پیامتان را بنویسید. برای فرستادن عکس به مدل، آیکن عکس کنار کادر پیام را بزنید.

    گفتگوهای قبلی از منوی ☰ در دسترس‌اند و فقط روی گوشی خودتان ذخیره می‌شوند.

  5. ۵

    ساخت تصویر

    از فهرست مدل‌ها، بخش «ساخت تصویر» را انتخاب کنید (مثلاً GPT Image 2). از این به بعد هر پیام به یک تصویر تبدیل می‌شود. اگر همراه پیام عکسی پیوست کنید، همان عکس ویرایش می‌شود. برای برگشت به گفتگو، دوباره یک مدل متنی انتخاب کنید.

    ساخت هر تصویر معمولاً ۲۰ تا ۴۵ ثانیه طول می‌کشد. با زدن روی تصویر، آن را تمام‌صفحه می‌بینید.

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
«Claude Code پیدا نشد» (ویندوز)
Claude Code نصب نیست یا ویندوز مسیرش را نمی‌شناسد. در PowerShell دستور npm install -g @anthropic-ai/claude-code را اجرا کنید و Harnes را دوباره باز کنید. اگر باز هم پیدا نشد، مسیر claude.exe را در تنظیمات ← پیشرفته وارد کنید.
This model is not supported on the Chat Completions endpoint
یک مدل ساخت عکس (مثل gpt-image-2) را برای چت انتخاب کرده‌اید. مدل‌های عکس فقط از بخش ساخت تصویر برنامه کار می‌کنند، نه از صفحه‌ی چت؛ برای گفتگو یک مدل Claude یا GPT انتخاب کنید.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی