راهنمای اتصال به API

اتصال Continue به 1ai؛ تنظیم config.yaml برای چت، ویرایش و تکمیل خودکار

Continue دستیار متن‌باز برنامه‌نویسی برای VS Code و JetBrains است و همه‌ی مدل‌هایش را از یک فایل `config.yaml` می‌خواند. با وان ای آی (1ai) کافی است در همان فایل provider را `openai` و `apiBase` را `https://1ai.ir/v1` بگذارید تا با یک کلید به Claude، GPT، Gemini، DeepSeek و Qwen دسترسی داشته باشید. اعتبار را با پرداخت ریالی می‌خرید و برای هر کلید سقف مصرف می‌گذارید. در این راهنما یک config آماده، دو تنظیم ضروری که بیشتر راهنماها جا می‌اندازند و نکته‌های تکمیل خودکار را می‌بینید.

اتصال Continue به 1ai با فایل config.yaml در VS Code و انتخاب مدل برای چت و تکمیل خودکار

چرا با 1ai

یک فایل، همه‌ی نقش‌ها

برای chat، edit، apply، autocomplete و embed در `config.yaml` مدل جدا بگذارید؛ همه با یک کلید و یک اعتبار.

پرداخت ریالی

اعتبار را با پرداخت ریالی می‌خرید و هزینه‌ی هر درخواست به اندازه‌ی توکن‌هایش کم می‌شود؛ حساب و کارت خارجی لازم نیست.

سقف مصرف برای هر کلید

برای کلید Continue سقف ماهانه و مدل‌های مجاز تعیین کنید؛ مخصوصاً وقتی تکمیل خودکار روشن است و درخواست‌ها زیاد می‌شوند.

Agent با فراخوانی ابزار

حالت Agent در Continue به tool calling نیاز دارد و `chat/completions` در 1ai آن را با استریم پشتیبانی می‌کند.

لاگ و مصرف

در پنل توسعه‌دهنده می‌بینید هر کلید چقدر مصرف کرده و کدام درخواست‌ها خطا داده‌اند.

در چند قدم

  1. ۱

    Continue را نصب کنید

    افزونه‌ی Continue را از Extensions در VS Code یا از Plugins در JetBrains نصب کنید.

  2. ۲

    کلید API بسازید

    در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با سقف ماهانه بسازید و همان لحظه کپی کنید.

  3. ۳

    config.yaml را ویرایش کنید

    از منوی config بالای چت، کنار Local Config روی چرخ‌دنده بزنید و مدل‌ها را با provider openai و apiBase تعریف کنید.

  4. ۴

    مدل را انتخاب کنید

    فایل را ذخیره کنید؛ Continue خودش بارگذاری می‌کند. مدل را از انتخابگر بالای چت برگزینید و یک سؤال بفرستید.

مدل‌های مناسب Continue (با پشتیبانی از ابزار)

همه‌ی مدل‌ها

GPT-6.1 Sol

اوپن‌ای‌آی
گفتگو

پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای

۱٫۵ اعتبار / ۱۰۰۰ توکن خروجی
API

Claude Sonnet 5.5

آنتروپیک
گفتگو

نویسندگی روان و برنامه‌نویسی دقیق

۱٫۵ اعتبار / ۱۰۰۰ توکن خروجی
API
گفتگو

سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند

۰٫۵۶۲۵ اعتبار / ۱۰۰۰ توکن خروجی
API

Claude Haiku 5.5

آنتروپیک
گفتگو

سریع‌ترین کلود؛ در سهمیه‌ی رایگان روزانه

۰٫۰۷۵ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI
گفتگو

سبک و ارزان؛ در سهمیه‌ی رایگان روزانه

۰٫۳۷۵ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI

DeepSeek V4.1 Flash

دیپ‌سیک
گفتگو

سریع و بسیار ارزان؛ در سهمیه‌ی رایگان روزانه

۰٫۰۹ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI

نمونه پرامپت‌ها

پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.

توضیح کد انتخاب‌شده

Explain what the selected code does, line by line, then list two edge cases it does not handle.

کد را انتخاب کنید و با Cmd/Ctrl + L به چت بفرستید.

ویرایش درجا

Convert this function to async/await, keep the same behaviour and add JSDoc comments.

برای ویرایش درجا، کد را انتخاب کنید و Cmd/Ctrl + I را بزنید.

کار با Agent

Find where [نام قابلیت، مثلاً user login] is implemented in this project, add input validation for [فیلد] and update the related tests.

پیام commit

Write a Conventional Commits message for my current changes. Keep the subject under 60 characters and explain why in the body.

پرسش فارسی درباره‌ی کد

به فارسی توضیح بده این ماژول چه وابستگی‌هایی دارد و اگر بخواهم [کتابخانه‌ی فعلی] را با [کتابخانه‌ی جدید] عوض کنم، کدام فایل‌ها باید تغییر کنند.

Continue چیست و چرا با 1ai؟

Continue دستیار متن‌باز برنامه‌نویسی است که در VS Code و JetBrains چت، ویرایش درجا، حالت Agent و تکمیل خودکار کد می‌دهد. مدل‌ها را خودتان انتخاب می‌کنید و 1ai همان API را با شکل OpenAI و با پرداخت ریالی فراهم می‌کند؛ توضیح کلی در صفحه‌ی توسعه‌دهندگان آمده است.

پیش‌نیازها:

  • افزونه‌ی Continue روی VS Code یا JetBrains
  • حساب 1ai با اعتبار و یک کلید sk-1ai-…
  • شناسه‌ی مدل‌ها با پیشوند سازنده، از مدل‌های گفتگو

فایل تنظیمات محلی این‌جاست: ~/.continue/config.yaml در macOS و لینوکس و %USERPROFILE%\.continue\config.yaml در ویندوز.

نمونه‌ی config.yaml برای 1ai

yaml
name: 1ai
version: 1.0.0
schema: v1
models:
  - name: Claude Sonnet (1ai)
    provider: openai
    model: anthropic/claude-sonnet-5.5
    apiBase: https://1ai.ir/v1
    apiKey: sk-1ai-...
    useLegacyCompletionsEndpoint: false
    capabilities:
      - tool_use
      - image_input
    roles:
      - chat
      - edit
      - apply
  - name: GPT (1ai)
    provider: openai
    model: openai/gpt-6.1-sol
    apiBase: https://1ai.ir/v1
    apiKey: sk-1ai-...
    useResponsesApi: false
    capabilities:
      - tool_use
    roles:
      - chat
  - name: Autocomplete (1ai)
    provider: openai
    model: deepseek/deepseek-v4.1-flash
    apiBase: https://1ai.ir/v1
    apiKey: sk-1ai-...
    useLegacyCompletionsEndpoint: false
    roles:
      - autocomplete
    autocompleteOptions:
      debounceDelay: 400
      maxPromptTokens: 1024

سه نکته‌ی ضروری:

  • useResponsesApi: false برای مدل‌های GPT: Continue برای نام‌هایی که gpt-5 به بالا در آن‌ها هست سراغ /v1/responses می‌رود که 1ai ندارد.
  • useLegacyCompletionsEndpoint: false: نمی‌گذارد Continue درخواست را به /v1/completions قدیمی بفرستد؛ 1ai فقط chat/completions دارد.
  • capabilities: [tool_use]: Continue توانایی مدل‌های ناشناخته را تشخیص نمی‌دهد و بدون آن حالت Agent غیرفعال می‌ماند.

تکمیل خودکار (autocomplete) با 1ai چطور کار می‌کند؟

مستندات Continue می‌گوید بهترین مدل‌های تکمیل خودکار با قالب fill-in-the-middle آموزش دیده‌اند و مدل‌های چت در این کار ضعیف‌ترند. 1ai مسیر جداگانه‌ی FIM ندارد، پس تکمیل خودکار از راه chat/completions و با یک مدل چت انجام می‌شود:

  • یک مدل سریع و ارزان بگذارید، مثل deepseek/deepseek-v4.1-flash یا google/gemini-3.8-flash.
  • debounceDelay را بالاتر ببرید (مثلاً ۴۰۰ میلی‌ثانیه) تا با هر حرف درخواست نرود.
  • اگر کیفیت پیشنهادها راضی‌تان نکرد، مدل autocomplete را حذف کنید و از چت و ویرایش درجا استفاده کنید.

هر پیشنهاد یک درخواست جداست؛ پس برای کلید این کار حتماً سقف ماهانه بگذارید.

کدام مدل برای هر نقش Continue مناسب است؟

نقشModel ID پیشنهادی
chat و Agentanthropic/claude-sonnet-5.5، openai/gpt-6.1-sol، qwen/qwen3.8-max
edit و applyanthropic/claude-sonnet-5.5، google/gemini-3.8-flash
autocompletedeepseek/deepseek-v4.1-flash
embed (اختیاری)openai/text-embedding-3-small

برای Agent فقط مدل‌های دارای tools را بگذارید. اگر مدلی تصویر می‌پذیرد، image_input را هم به capabilities اضافه کنید.

برای نقش embed این مورد را هم به فهرست models اضافه کنید؛ مسیر /v1/embeddings در 1ai فعال است:

yaml
  - name: Embeddings (1ai)
    provider: openai
    model: openai/text-embedding-3-small
    apiBase: https://1ai.ir/v1
    apiKey: sk-1ai-...
    roles:
      - embed

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

رفع خطاهای Continue و کنترل هزینه

  • 401 invalid_api_key: کلید اشتباه، باطل یا منقضی است.
  • 404 model_not_found: پیشوند سازنده جا افتاده؛ claude-sonnet-5.5 باید anthropic/claude-sonnet-5.5 باشد.
  • 404 با پیام Unknown endpoint: Continue به /responses یا /completions رفته؛ دو تنظیم بالا را اضافه کنید.
  • پاسخ HTML: apiBase باید دقیقاً https://1ai.ir/v1 باشد.
  • Agent در فهرست حالت‌ها نیست: tool_use را در capabilities بگذارید.
  • 402 یا 429: اعتبار یا سقف ماهانه‌ی کلید تمام شده، یا سقف درخواست در دقیقه پر شده و باید به اندازه‌ی retry-after صبر کنید.

برای کنترل هزینه، برای Continue کلید جدا با سقف ماهانه و مدل‌های مجاز بسازید و مصرف را در پنل ببینید. راهنمای کامل: کلیدها و کنترل هزینه.

ابزارهای آماده

توضیح کد و رفع باگ

کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید

ساخت عبارت باقاعده (Regex)

الگوی Regex با توضیح و نمونه‌ی آزمون

ساخت کوئری SQL

درخواست فارسی، کوئری درست و توضیح‌داده‌شده

دستیارهای مرتبط

برنامه‌نویس ارشد

نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن

  • «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
  • «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»

سوالات متداول

آیا Continue با 1ai هزینه دارد؟

خود افزونه‌ی Continue متن‌باز است. هزینه‌ی مدل‌ها به اندازه‌ی توکن‌های هر درخواست از اعتبار 1ai کم می‌شود و اعتبار را با پرداخت ریالی می‌خرید. تکمیل خودکار بیشترین تعداد درخواست را می‌سازد.

کلید API را کجای config.yaml بنویسم که امن باشد؟

فایل ~/.continue/config.yaml در پوشه‌ی کاربر است، نه در مخزن پروژه؛ پس با git منتشر نمی‌شود. اگر config را با تیم به اشتراک می‌گذارید، کلید را از آن حذف کنید و برای هر نفر کلید جدا با سقف مصرف بسازید.

می‌توانم provider را anthropic بگذارم و کلید 1ai بدهم؟

خیر. provider anthropic به API اختصاصی Anthropic وصل می‌شود که 1ai ندارد. برای Claude هم provider را openai و model را anthropic/claude-sonnet-5.5 بگذارید.

Continue در JetBrains هم با همین تنظیمات کار می‌کند؟

بله. افزونه‌ی JetBrains همان config.yaml را می‌خواند؛ فقط میان‌بر باز کردن چت در JetBrains Cmd/Ctrl + J است.

چرا تکمیل خودکار Continue کند است؟

هر پیشنهاد یک درخواست کامل به مدل چت است. مدل سبک‌تری بگذارید، maxPromptTokens را کم نگه دارید و اگر شبکه کند است، debounceDelay را بیشتر کنید.

Continue را به Cline ترجیح بدهم یا برعکس؟

Continue برای چت، ویرایش درجا و تکمیل خودکار در کنار کدنویسی خودتان راحت است. Cline بیشتر برای سپردن یک کار کامل به عامل ساخته شده است. هر دو با یک کلید 1ai کار می‌کنند؛ تنظیم Cline در راهنمای Cline آمده است.

چطور پیش از Continue مطمئن شوم کلید و آدرس درست است؟

در ترمینال curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..." را اجرا کنید. اگر فهرست مدل‌ها برگشت، مشکل از config است و باید تورفتگی YAML، مقدار provider و پیشوند سازنده‌ی مدل را دوباره بررسی کنید. اگر 401 گرفتید، کلید تازه بسازید.

می‌توانم در Continue تصویر یا اسکرین‌شات بفرستم؟

بله، برای مدل‌هایی که تصویر می‌پذیرند، مثل Claude، GPT و Gemini. image_input را در capabilities همان مدل بگذارید تا Continue پیوست تصویر را در چت فعال کند؛ برای مدل‌های فقط‌متنی این گزینه را اضافه نکنید.

مطالب مرتبط

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
توسعه‌دهندگان

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL

چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.

۴ دقیقه مطالعه
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
توسعه‌دهندگان

کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه

چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدل‌های مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.

۴ دقیقه مطالعه
مقایسه ChatGPT، Claude و Gemini: کدام مدل برای چه کاری؟
کاربردها

مقایسه ChatGPT، Claude و Gemini: کدام مدل برای چه کاری؟

سه خانواده‌ی مطرح مدل‌های زبانی، یعنی GPT از OpenAI، Claude از Anthropic و Gemini از گوگل، هر کدام کجا می‌درخشند و چطور برای کار خودتان بهترین را انتخاب کنید.

۴ دقیقه مطالعه
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
مفاهیم هوش مصنوعی

مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی

LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدل‌های باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.

۱۱ دقیقه مطالعه
همه‌ی امکانات

اتصال Cline

افزونه‌ی Cline را با گزینه‌ی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.

اتصال Cursor

کلید 1ai را در Cursor بگذارید و در حالت Ask با Qwen، DeepSeek، Kimi و GPT گفتگو کنید؛ با توضیح صریح این‌که Tab و Agent چه وضعیتی دارند.

اتصال Aider

Aider را با دو متغیر محیطی به 1ai وصل کنید و در ترمینال، روی مخزن git خودتان، با Claude، GPT، DeepSeek و Qwen کد بنویسید و commit بگیرید.

برنامه‌نویسی با هوش مصنوعی

کد بنویسید، خطا پیدا کنید، SQL و Regex بسازید و با API سازگار با OpenAI مدل‌ها را به ابزارهای خودتان وصل کنید.

اتصال Continue به 1ai؛ تنظیم config.yaml برای چت، ویرایش و تکمیل خودکار

Continue را با چند خط config.yaml به API سازگار با OpenAI در 1ai وصل کنید و برای چت، ویرایش، Agent و تکمیل خودکار مدل جداگانه بگذارید.

ساخت کلید API