اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال Harnes
Android · ۵ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
دانلود و نصب
فایل APK را روی گوشی دانلود و بازش کنید. اگر گوشی اجازهی نصب خواست، گزینهی «اجازه از این منبع» (Install unknown apps) را برای مرورگر روشن کنید و دوباره
Installرا بزنید.حجم برنامه کمتر از ۱ مگابایت است و روی اندروید ۶ به بالا نصب میشود.
-
۳
وارد کردن کلید
در اولین اجرا، پنجرهی تنظیمات خودکار باز میشود (بعداً از منوی ☰ ←
تنظیمات). کلید را در کادرکلید APIبچسبانید:کلید APIsk-...دکمهی
تست اتصالرا بزنید. اگر «اتصال برقرار است» آمد،ذخیرهرا بزنید. آدرس سرویس داخل برنامه ثابت است و لازم نیست چیزی وارد کنید. -
۴
انتخاب مدل و گفتگو
روی نام مدل در بالای صفحه بزنید و مدل دلخواه را انتخاب کنید (مثلاً
Claude Sonnet 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 استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.