Cohere API رایگان

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

Cohere برای ارزیابی Chat، Embedding، Rerank و Tool Use با API اختصاصی v2 مناسب است. کلید Trial رایگان است اما برای ارزیابی و Proof of Concept طراحی شده، سقف ماهانه و محدودیت endpoint دارد و OpenAI-compatible نیست؛ بنابراین نمونه‌ها باید مستقیماً با قرارداد Cohere نوشته شوند. وضعیت دسترسی مستقیم ایران نیز طبق Evidence فعلی Catalog مسدود ثبت شده است.

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

1. در Dashboard Cohere حساب بسازید و یک Trial API Key دریافت کنید. این کلید را فقط برای ارزیابی در نظر بگیرید و مقدار آن را در متغیر محیطی COHERE_API_KEY یا secret manager نگهداری کنید.
2. مدل و endpoint مناسب را از مستندات v2 انتخاب کنید؛ محدودیت Chat با Embed و Rerank یکسان نیست. پیش از توسعه، سقف همان endpoint و محدودیت ۱۰۰۰ فراخوانی ماهانه Trial را کنترل کنید.
3. یک درخواست کوتاه آزمایشی بفرستید و پاسخ meta و billed_units را برای اندازه‌گیری مصرف ثبت کنید. برای Production باید کلید Production، شرایط استفاده و محدودیت‌های مناسب workload جداگانه بررسی شوند.

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

curl https://api.cohere.com/v2/chat \
  -H "Authorization: Bearer $COHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"command-a-03-2025","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}]}'

این API قرارداد اختصاصی Cohere v2 دارد و صرفاً با تغییر Base URL جای OpenAI SDK نمی‌نشیند. مدل نمونه با Catalog پروژه هماهنگ است؛ فهرست مدل‌های فعال را پیش از اجرای مجدد کنترل کنید.

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

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

• 401/403 — کلید نامعتبر یا درخواست از مسیر پشتیبانی‌نشده

  وجود COHERE_API_KEY و هدر Bearer را بررسی کنید. کلید افشاشده را revoke کنید. با توجه به Evidence فعلی پروژه، درخواست مستقیم از ایران به‌عنوان گزینه قابل اتکا معرفی نمی‌شود و این متن هیچ روش دورزدن محدودیت ارائه نمی‌کند. منبع رسمی (2026-07-16)

• 400/404 — بدنه درخواست یا مدل معتبر نیست

  ساختار messages، نقش‌ها و شناسه مدل را با API v2 تطبیق دهید. نمونه‌های API v1 را بدون Migration استفاده نکنید و با یک درخواست حداقلی فیلد نامعتبر را جدا کنید. منبع رسمی (2026-07-16)

• 429 — عبور از Rate Limit یا سقف Trial

  محدودیت endpoint و مدل را از جدول رسمی بخوانید، concurrency را کاهش دهید و retry را با exponential backoff و jitter انجام دهید. محدودیت ماهانه Trial با retry بیشتر رفع نمی‌شود. منبع رسمی (2026-07-16)

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

• زمانی که پروژه به Free Tier دائمی یا workload تولیدی رایگان نیاز دارد؛ Trial برای ارزیابی است و Production قرارداد جدا دارد.
• زمانی که کد موجود باید بدون Adapter با OpenAI SDK اجرا شود؛ Cohere v2 قرارداد و response structure اختصاصی دارد.
• زمانی که اجرای مستقیم و قابل اتکا از ایران شرط اصلی است؛ Evidence تاریخ‌دار فعلی پروژه پاسخ ۴۰۳ با کلید معتبر را نشان می‌دهد.

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

• free-tier-vs-trial-vs-credit
• free-embedding-api
• best-free-llm-api-iran

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