۱۳ آبان ۱۴۰۵مرتضی شایق — مارکتینگ هوشامنبع: docs.hoosha.com، console.hoosha.com، Ahrefs

استراتژی جذب مشتری برای API هوشا

جذب باید Docs-led و Search-first باشد، نه تبلیغات عمومی. کسی که دنبال API است قصد خرید روشن دارد و با یک «آموزش اتصال» یا «قیمت تومانی» تصمیم می‌گیرد. اما قبل از خرج روی تبلیغ، چند شکاف محصولی باید بسته شود؛ وگرنه CAC بالا و نرخ تبدیل پایین می‌شود.

یک کلید سازگار با OpenAI برای چت، تصویر، ویدیو، موسیقی و صدای فارسی؛ با پرداخت ریالی، هزینه شفاف در هر درخواست و بدون جایگزینی پنهان مدل.

۵مدل چت در API (بدون Claude)

۲۵+مدل تصویر، ویدیو، موسیقی و گفتار

۳۰صدای فارسی ElevenLabs

۱٫۱۸ متومان؛ کمترین شارژ فعلی (بدون اعتبار تست)

پنج تصمیم کلیدی

لندینگ تجاری مستقل hoosha.com/api/ بسازیم.
docs برای دولوپرِ قانع‌شده است؛ صفحه‌ای که رتبه بگیرد، قیمت تومانی بدهد و ثبت‌نام بگیرد نداریم.
Claude را به API اضافه کنیم.
ترجیحاً با endpoint سازگار Anthropic برای Claude Code. بزرگ‌ترین تقاضای دولوپرهای ایرانی همین است و الان در API نیست.
اعتبار تست + شارژ خُرد مخصوص API.
الان سهمیه رایگان نیست و کمترین بسته ۱٬۱۸۰٬۰۰۰ تومان است؛ مانع جدی برای دولوپری که فقط می‌خواهد یک ریکوئست تست بزند.
تمایز روی Media API، نه تعداد مدل.
رقیب ادعای ۴۵۰+ مدل دارد؛ اما Veo 3.1، Kling 3، Seedance 2.5، Suno V6 و ElevenLabs فارسی با یک کلید، مزیت واقعی ماست.
سهم ثابت محتوا.
۶ هفته اول ۸ محتوا در هفته برای ساخت هسته، بعد دائماً ۴ محتوا در هفته. تبلیغ پولی فقط بعد از آماده‌شدن لندینگ و ترکینگ کل قیف.

نقشه راه ۹۰ روزه و مسیر همه کارها

هر فاز فقط وقتی شروع می‌شود که دروازه قبلی رد شده باشد؛ بودجه تبلیغات قبل از دروازه ۱ خرج نمی‌شود. تولید محتوا از هفته اول موازی جلو می‌رود چون رتبه‌گرفتن زمان می‌برد. تیک کارها در همین مرورگر ذخیره می‌شود.

مسئول: مدیریتفنیمارکتینگمحتوا و سئو

۰ از ۰ کار انجام شده

فاز ۰

آماده‌سازی

هفته ۱ تا ۲هدف: قیف کامل و قابل اندازه‌گیری قبل از هر ریال تبلیغ

تصمیم درباره اعتبار تست (۱۰ تا ۲۰ اعتبار با احراز شماره) و بسته شارژ خُرد APIمدیریتP0
تصمیم و زمان‌بندی افزودن Claude به API + endpoint سازگار AnthropicمدیریتفنیP0
سئوی فنی docs: robots.txt و sitemap.xml واقعی، canonical خودارجاع، hreflang بین / و /en، 404 واقعی، description اختصاصی هر صفحهفنیP0
تأیید مسیر /api/ روی دامنه اصلی بدون تداخل با route اپ (جایگزین: /developers/)فنیP0
ترکینگ cross-domain بین hoosha.com، docs و console + رویدادهای api_key_created، api_first_request، api_first_topup سمت سرورمارکتینگفنیP0
اعتبارسنجی کیوردها در Keyword Planner (فارسی) و ساخت شیت «کیورد ← کلاستر ← URL»محتوا و سئوP1
بررسی دستی SERP کیوردهای P0 (نوع صفحه برنده: لندینگ، مقاله یا docs)محتوا و سئوP1
اکانت تست با اعتبار داخلی برای اجرای همه نمونه‌کدهامدیریتP1
ورودی «API» در منو و فوتر سایت و داخل اپ هوشافنیمارکتینگP1

دروازه ۱: قیف «ساخت کلید ← اولین ریکوئست ← اولین شارژ» در GA4 دیده می‌شود و اعتبار تست فعال است.

فاز ۱

هسته و لانچ نرم

هفته ۳ تا ۶هدف: اولین کاربران پولی API از کانال‌های ارزان

لندینگ /api/ (کد، گرید مدل‌ها با قیمت تومانی، FAQ، CTA ساخت کلید)مارکتینگفنیP0
صفحه /api/pricing/ + ماشین‌حساب هزینه توکن به تومانمارکتینگفنیP0
صفحات مدل: /api/gpt/، /api/gemini/، /api/coding-agents/محتوا و سئوP0
صفحات مدیا: /api/video/، /api/image/، /api/tts/محتوا و سئوP1
۸ آموزش اول موج محتوا (Cline، Claude Code، n8n، ربات تلگرام و…)محتوا و سئوP1
ریپوی نمونه‌کد در گیت‌هاب: ربات تلگرام، چت‌بات سایت، تمپلیت n8n، Media APIفنیP1
اعلام به کاربران فعلی: بنر داخل اپ، کانال و بات تلگرام، ایمیل/پیامکمارکتینگP1
تست کوچک: ۵ کانال تلگرام برنامه‌نویسی (UTM جدا) + کمپین Google Ads سرچمارکتینگP1

دروازه ۲: «کلید ← اولین ریکوئست» بالای ٪۶۰ و اولین شارژهای API ثبت شده است.

فاز ۲

مقیاس کانال‌های برنده

هفته ۷ تا ۱۰هدف: افزایش بودجه فقط جایی که CAC قابل قبول است

افزایش بودجه فقط روی کمپین‌ها و کانال‌های با CAC قابل قبول؛ قطع بقیهمارکتینگP1
Telegram Ads روی کانال‌های برنامه‌نویسی و AI (از طریق ریسلر)مارکتینگP1
۲ تا ۳ اسپانسری یوتیوبر/مدرس برنامه‌نویسی با اعتبار اختصاصیمارکتینگP1
رپورتاژ زومیت و دیجیاتو با زاویه دولوپریمارکتینگP2
کمپین Media API (Veo، Kling، Suno، صدای فارسی) برای سازندگان بات و اپمارکتینگP1
۸ آموزش دوم + صفحات مقایسه (جایگزین API OpenAI در ایران)محتوا و سئوP1
ریتارگتینگ یکتانت روی بازدیدکنندگان /api/ و docsمارکتینگP2

دروازه ۳: CAC هر کانال کمتر از درآمد API ماه اول همان کاربر است.

فاز ۳

سازمانی و ماندگاری

هفته ۱۱ به بعدهدف: LTV بالاتر با B2B و مصرف تکرارشونده

صفحه /api/enterprise/، فاکتور رسمی، سقف بالاتر از ۴ هم‌زمان / ۶۰ در دقیقهمدیریتفنیP1
فروش مستقیم به استارتاپ‌ها؛ برنامه معرفی با اعتبار هدیهمارکتینگP2
کمپین لانچ Claude در API به‌محض آماده‌شدن + صفحه /api/claude/مارکتینگمحتوا و سئوP0
status page عمومی (status.hoosha.com) و سابقه uptimeفنیP2
Responses API (پشتیبانی Cursor Agent و Codex CLI)فنیP2
ریتم دائمی: ۴ محتوا در هفته + به‌روزرسانی ماهانه قیمت و مدل‌هامحتوا و سئوP1

اگر دروازه‌ای رد نشد: اول مشکل قیف را حل می‌کنیم (معمولاً docs، اعتبار تست یا پیام لندینگ) و بعد بودجه را بالا می‌بریم.

وضعیت فعلی API و شکاف‌های قبل از پروموت

API از نظر فنی کامل است (سازگار با OpenAI، مستندات فارسی، کنسول با لاگ و هزینه)، اما ۴ شکاف دارد که مستقیم روی نرخ تبدیل اثر می‌گذارد.

آنچه داریم (Fact)

بخش	وضعیت فعلی	ارزش بازاریابی
چت	سازگار با OpenAI Chat Completions روی `api.hoosha.com/v1`. مدل‌ها: GPT 6.1 Terra، Gemini 3.8 Flash، DeepSeek V4.1 Flash، GLM 5.3 FlashX، Muse Spark 1.3. همه tool calling، استریم، ورودی تصویر و JSON دارند.	«کد فعلی را با تغییر یک خط وصل کنید»
ایجنت کدنویسی	راهنمای Cline، Roo Code، Claude Code (با روتر)، OpenCode، Continue، Aider، Zed	ورود به ترند AI coding
مدیا	تصویر: Nano Banana 2.1، ChatGPT Image 2.5، Flux Kontext، SeeDream 4.5. ویدیو: Veo 3.1، Kling 3.0، Seedance 2.5، Runway، Lipsync. موسیقی: Suno V6. گفتار: ElevenLabs v4 با ۳۰ صدای فارسی.	تمایز اصلی؛ رقبا عمدتاً متن‌محورند
صورتحساب	اعتبار مشترک با اپ؛ `cost_credits` در هر پاسخ؛ درخواست ناموفق رایگان؛ بازگشت خودکار اعتبار مدیای ناموفق؛ بدون انقضا	شفافیت هزینه
اعتماد	هر مدل روی پرووایدر ثابت؛ هرگز به مدل دیگری منتقل نمی‌شود	پاسخ به ترس «مدل جایگزین» در سرویس‌های واسط

قیمت تومانی هر ۱ میلیون توکن (Data)

با قیمت هر اعتبار بین ۲٬۳۲۲ (Ultra) و ۲٬۷۷۶ تومان (Basic):

مدل	ورودی	خروجی
GPT 6.1 Terra	۲۸۲ تا ۳۳۷ هزار	۱٫۴۱ تا ۱٫۶۸ میلیون
Gemini 3.8 Flash	۲۱۱ تا ۲۵۳ هزار	۱٫۰۶ تا ۱٫۲۶ میلیون
GLM 5.3 FlashX	۱۰۴ تا ۱۲۵ هزار	۳۵۲ تا ۴۲۱ هزار
DeepSeek V4.1 Flash	۴۲ تا ۵۱ هزار	۱۶۹ تا ۲۰۲ هزار
Muse Spark 1.3	۲۸ تا ۳۴ هزار	۵۶ تا ۶۷ هزار

مدیا: Veo 3.1 (۸ ثانیه) ۳۰ اعتبار ≈ ۷۰ تا ۸۳ هزار تومان؛ ElevenLabs v4 حدود ۱۲ اعتبار برای هر ۱۰۰۰ کاراکتر ≈ ۲۸ تا ۳۳ هزار تومان.

شکاف‌های حیاتی

شکاف	اثر روی بازاریابی	پیشنهاد	اولویت
Claude در API نیست (در اپ هست)	تقاضای اصلی دولوپرها (Claude Code، «خرید اکانت کلاد») را از دست می‌دهیم	افزودن Claude Sonnet/Opus + endpoint سازگار Anthropic Messages	P0
بدون اعتبار تست؛ حداقل خرید ۱٫۱۸ میلیون تومان	افت شدید بین ساخت کلید و اولین ریکوئست؛ CAC بالا	۱۰ تا ۲۰ اعتبار تست با احراز شماره + بسته شارژ خُرد API	P0
سئوی فنی docs: robots و sitemap صفحه اصلی را با ۲۰۰ برمی‌گردانند؛ canonical و hreflang نیست؛ description تکراری	ایندکس کند و ناقص	robots و sitemap واقعی، canonical، hreflang، description اختصاصی، 404 واقعی	P0
سقف ۴ هم‌زمان و ۶۰ در دقیقه (چت)، ۱۰ در دقیقه (مدیا)	اعتراض فروش برای استارتاپ و B2B	صفحه افزایش سقف / پلن سازمانی	P1
Cursor Agent و Codex CLI پشتیبانی نمی‌شوند	دو ابزار پرجستجو قابل هدف‌گیری نیستند	Responses API در رودمپ فنی	P1
فاکتور رسمی برای شرکت‌ها مشخص نیست	B2B بدون فاکتور خرید نمی‌کند	صفحه «API برای سازمان‌ها» + فاکتور رسمی	P1
status page و SLA عمومی نیست	اعتماد پایین برای production	`status.hoosha.com`	P2

چه کسانی در ایران به API نیاز دارند

سه سگمنت اول (دولوپر مستقل، کاربر ایجنت کدنویسی، سازنده بات و اپ مدیا) حجم دارند، سریع می‌خرند و مصرف تکرارشونده دارند؛ تمرکز ۹۰ روز اول روی همین‌هاست. ریشه مشترک نیاز: OpenAI، Anthropic و Google ایران را پشتیبانی نمی‌کنند، پرداخت ارزی عملاً ممکن نیست، اکانت‌های واسطه بن می‌شوند و سرور داخل ایران برای اتصال به پروکسی نیاز دارد.

سگمنت	درد اصلی	دنبال چه می‌گردد	ارزش پیشنهادی هوشا	حجم / LTV	اولویت
۱. دولوپر مستقل و فریلنسر پایتون، Node، PHP/لاراول	بن‌شدن اکانت OpenAI، نبود کارت ارزی، فیلتر IP سرور	API چت جی پی تی، خرید API OpenAI، API جمنای	تغییر یک خط `base_url`، پرداخت ریالی	زیاد / متوسط	P1
۲. کاربر ایجنت کدنویسی Cline، Roo Code، Claude Code، Aider	اکانت مشترک Claude می‌خرد و بن می‌شود	خرید اکانت کلاد، Claude Code ایران، بهترین AI برای برنامه‌نویسی	یک کلید برای همه ایجنت‌ها، پرداخت به اندازه مصرف	متوسط / بالا	P1 (با Claude در API: P0)
۳. سازنده بات تلگرام/بله و اپ AI	برای هر مدل مدیا قرارداد و پرداخت ارزی جدا	API ساخت ویدیو، API Veo، API Nano Banana، API Suno	تصویر، ویدیو، موسیقی و صدا با یک کلید؛ بازگشت اعتبار شکست‌ها	متوسط / بسیار بالا	P1
۴. اتوماسیون و No-code n8n، Make	نود OpenAI کلید می‌خواهد	n8n هوش مصنوعی، اتصال n8n به ChatGPT	تمپلیت آماده n8n	متوسط / متوسط	P1
۵. استارتاپ و شرکت نرم‌افزاری	پایداری، فاکتور رسمی، سقف بالاتر	وب سرویس هوش مصنوعی، API برای کسب‌وکار	داشبورد مصرف، کلید جدا برای هر محیط	کم / بسیار بالا	P2
۶. آژانس و تولیدکننده محتوا	کار دستی و پراکندگی ابزار	API تبدیل متن به صدا فارسی، عکس محصول با AI	۳۰ صدای فارسی + تصویر/ویدیو در یک پایپ‌لاین	کم / بالا	P2
۷. دانشجو، پژوهشگر، مدرس	هزینه و دسترسی	API رایگان هوش مصنوعی	مدل ارزان (Muse، DeepSeek)، مستندات فارسی	زیاد / کم	P3

نکته استراتژیک: سگمنت ۳ عملاً «فروش عمده» به رقبای خرده‌فروش هوشاست. پیشنهاد: بپذیریم؛ درآمد عمده بدون CAC مصرف‌کننده نهایی است و اگر ما نفروشیم، رقیب می‌فروشد. برای حجم بالا قیمت پلکانی و قرارداد جدا.

رقبا و جایگاه‌یابی

در ذهن دولوپر ایرانی GapGPT و AvalAI جا افتاده‌اند؛ در تعداد مدل متنی به آن‌ها نمی‌رسیم، پس روی «مدیا + اعتماد + برند ۳ میلیون کاربری» جایگاه می‌گیریم. «gapgpt api» حدود ۱٬۸۰۰ جستجوی ماهانه دارد.

رقیب	آنچه دیدیم	قوت	جای حمله ما
GapGPT	API سازگار OpenAI؛ رتبه ۱ تا ۳ «چت جی پی تی»؛ درایور پیش‌فرض در پکیج‌های متن‌باز ایرانی	برند و حضور در کد دولوپرها	Media API، صدای فارسی، شفافیت هزینه در هر ریکوئست
AvalAI	ادعای ۴۵۰+ مدل، بسته اعتباری API؛ رپورتاژ در زومیت و دیجیاتو	تنوع مدل و PR	«مدل‌های درست، روی پرووایدر ثابت، بدون جایگزینی پنهان»
Metis	پلتفرم ساخت بات با RAG، پرداخت ریالی، SDK پایتون	ابزار ساخت بات	API خالص سازگار OpenAI برای کنترل کامل کد
سرویس‌های کوچک (1xAi و…)	آموزش در ویرگول، حداقل شارژ بسیار پایین	ورود ارزان	اعتبار تست + برند معتبر
OpenRouter و درگاه‌های خارجی	حجم جهانی بالا؛ پرداخت ارزی یا کریپتو	تعداد مدل و قیمت دلاری	پرداخت ریالی، پشتیبانی فارسی، بدون ریسک بسته‌شدن حساب

ستون‌های پیامسادگی — یک خط تغییر، یک کلید، یک موجودی
اعتماد — پرووایدر ثابت، شکست بی‌هزینه، +۳ میلیون کاربر
قدرت مدیا — Veo، Kling، Seedance، Suno، ElevenLabs فارسی

پیامی که نمی‌دهیم«ارزان‌ترین»؛ مگر بعد از مقایسه قیمت واقعی با رقبا در همان روز. «نامحدود» و «تضمین» هرگز.

رویکرد محتوا و پیام هر سگمنت

«آموزش اتصال = تبلیغ». هر محتوا باید دولوپر را تا اولین ریکوئست موفق ببرد؛ کد قابل کپی، کلید نمونه sk-hoosha-… و لینک ساخت کلید در همان صفحه.

هفت نوع محتوا، به ترتیب اثر روی درآمد

صفحات تجاری API هر مدل یا قابلیت — قیمت تومانی، کد ۱۰ خطی، محدودیت‌ها، CTA ساخت کلید.
راهنماهای اتصال ابزار — Cline، Roo Code، Claude Code، OpenCode، Continue، Aider، Zed، n8n، LangChain، Vercel AI SDK، Open WebUI، LibreChat، Dify، افزونه‌های AI وردپرس.
آموزش کاربردی با ریپوی گیت‌هاب — ربات تلگرام، چت‌بات پشتیبانی، توضیح محصول ووکامرس، ویدیو با Veo، پادکست فارسی.
محتوای مسئله‌محور — خطای unsupported_country، بن‌شدن اکانت، خطای 429 و 402.
مقایسه و تصمیم — بهترین مدل برای کدنویسی، هزینه مدل‌ها به تومان، جایگزین API OpenAI در ایران.
ابزار رایگان — ماشین‌حساب هزینه توکن به تومان و توکن‌شمار متن فارسی (بک‌لینک طبیعی).
محتوای ماشین‌خوان برای AEO/GEO — llms.txt، نسخه Markdown صفحات docs، FAQ با پاسخ ۴۰ تا ۶۰ کلمه‌ای.

پیام کلیدی هر سگمنت

سگمنت	پیام اصلی	اثبات	CTA
دولوپر مستقل	«کدت را عوض نکن؛ فقط `base_url` را عوض کن.»	نمونه کد Python/Node/curl	ساخت کلید API
ایجنت کدنویسی	«Cline و Claude Code را بدون اکانت خارجی و بدون ترس از بن راه بینداز.»	راهنمای ۳ مرحله‌ای، context یک‌میلیونی	اتصال در ۲ دقیقه
سازنده بات و اپ مدیا	«Veo، Kling، Suno و ۳۰ صدای فارسی؛ یک کلید، یک موجودی.»	قیمت هر تسک، بازگشت اعتبار شکست‌ها	دیدن قیمت مدیا
n8n و اتوماسیون	«ایجنت n8n با GPT و Gemini، با پرداخت ریالی.»	تمپلیت آماده	دانلود تمپلیت
استارتاپ و شرکت	«AI را در محصولت بگذار؛ با داشبورد مصرف و فاکتور رسمی.»	کنسول، لاگ، پرووایدر ثابت	درخواست پلن سازمانی
آژانس محتوا	«صداگذاری فارسی و عکس محصول را خودکار کن.»	نمونه صوت ۳۰ گوینده	شنیدن نمونه‌ها

کیوردها و کلاسترهای سئو

هسته تجاری ۴ کلاستر است: «خرید API هوش مصنوعی»، «API + نام مدل»، «ایجنت کدنویسی» و «API مدیا». هر کلاستر یک صفحه مقصد اصلی دارد و مقاله‌ها پشتیبان آن‌اند.

هشدار داده: Ahrefs دیتابیس ایران ندارد؛ اعداد، حجم جهانی ماهانه و فقط برای مقایسه نسبی‌اند. کیوردهای انگلیسی عمدتاً غیرایرانی‌اند و فارسی‌ها معمولاً کم‌برآورد. با Keyword Planner و Impressions سرچ کنسول اعتبارسنجی شود.

کلاستر	کیوردهای نمونه (حجم جهانی)	Intent	صفحه مقصد	اولویت
خرید API هوش مصنوعی	خرید api هوش مصنوعی (۷۰۰)، api رایگان هوش مصنوعی (۵۰۰)، api هوش مصنوعی رایگان (۲۰۰)، api هوش مصنوعی (۹۰)، api هوش مصنوعی ایرانی (۸۰)، وب سرویس هوش مصنوعی (۴۰)	تجاری	`/api/`	P0
API چت‌جی‌پی‌تی / OpenAI	api chatgpt (۷٫۶K، مختلط)، api gpt (۲٫۸K)، خرید api chatgpt (۴۵۰)، api چت جی پی تی (۱۵۰)، خرید api openai (۱۵۰)	تجاری	`/api/gpt/`	P0
API جمنای	api gemini (۵٫۴K، مختلط)، خرید api gemini (۲۰۰)، api جمنای (۲۰)	تجاری	`/api/gemini/`	P0
API کلاد و ایجنت کدنویسی	خرید اکانت claude (۴٫۳K)، خرید اکانت کلاد (۲٫۴K)، خرید اشتراک claude (۱٫۱K)، بهترین هوش مصنوعی برای برنامه نویسی (۹۰۰)، کلاد کد (۴۵۰)، هوش مصنوعی برای برنامه نویسی (۴۰۰)، خرید api claude (۱۵۰)	تجاری + مقایسه‌ای	`/api/coding-agents/`	P0
API دیپ‌سیک و مدل ارزان	api deepseek (۵٫۳K، مختلط)، api دیپ سیک (۶۰)	تجاری	`/api/deepseek/`	P1
API تصویر	api nano banana (۵۰۰)، api ساخت تصویر	تجاری	`/api/image/`	P1
API ویدیو	api veo 3 (۲۰۰)، api kling (۸۰)، api veo (۴۰)	تجاری	`/api/video/`	P1
API موسیقی و صدا	api suno (۴۰۰)، api elevenlabs (۲۰۰)، api تبدیل متن به صدا فارسی	تجاری	`/api/music/`، `/api/tts/`	P1
اتوماسیون و ایجنت	ایجنت هوش مصنوعی (۹۰۰)، n8n هوش مصنوعی (۶۰)، ساخت ربات تلگرام با chatgpt	آموزشی-تجاری	بلاگ + `/api/n8n/`	P1
پایه و آموزشی	api چیست (۲K)، انواع api (۹۰)، api key چیست (۷۰)	اطلاعاتی	بلاگ	P2
برند رقبا	gapgpt api (۱٫۸K)، متیس (۷۰۰)، avalai (۳۰۰)	مقایسه‌ای	صفحه مقایسه + Google Ads	P2

قواعد کنیبالیزیشن: /chatgpt/ فقط «چت جی پی تی» مصرف‌کننده؛ /api/gpt/ فقط عبارت‌های دارای «API، کلید، توکن، توسعه‌دهنده». مقاله بلاگ هم‌عنوان صفحه تجاری نمی‌شود. کیورد انگلیسی خالص فقط با قید فارسی یا ایران.

معماری صفحات و ساختار URL

صفحات تجاری روی دامنه اصلی (hoosha.com/api/…) تا اعتبار دامنه را بگیرند؛ docs مرجع فنی بماند و از هر صفحه تجاری لینک بگیرد. مثل /ai/ و /chatgpt/ دستی کدنویسی و با همان rewrite به ریشه بیایند.

URL	نقش	کیورد اصلی	CTA و نکته
`/api/`	Pillar و لندینگ تبلیغات	خرید API هوش مصنوعی	تب کد، گرید مدل‌ها با قیمت تومانی، FAQ
`/api/pricing/`	قیمت + ماشین‌حساب	قیمت API هوش مصنوعی	جدول تاریخ‌دار، به‌روزرسانی هفتگی
`/api/gpt/`، `/api/gemini/`، `/api/deepseek/`	صفحات مدل	خرید API + نام مدل	نمونه کد، مقایسه با رسمی، محدودیت‌ها
`/api/claude/`	فقط وقتی Claude در API آمد	خرید API کلاد	تا آن موقع ساخته نشود
`/api/coding-agents/`	ایجنت‌های کدنویسی	Claude Code در ایران، Cline	لینک به راهنمای هر ابزار
`/api/image/`، `/api/video/`، `/api/music/`، `/api/tts/`	Media API	API Nano Banana، API Veo، API Suno	قیمت هر تسک، نمونه خروجی و صوت واقعی
`/api/enterprise/`	سازمانی	API هوش مصنوعی برای کسب‌وکار	فرم تماس، سقف بالاتر، فاکتور رسمی
`/blog/category/developers/`	دسته بلاگ	آموزش‌ها	هر مقاله به یک صفحه تجاری لینک می‌دهد

لینک‌سازی داخلیآیتم «API» در منو و فوتر؛ بلوک «همین مدل از طریق API» در لندینگ‌های /chatgpt/، /image/، /video/، /music/؛ ورودی «API برای برنامه‌نویسان» داخل اپ — ارزان‌ترین کانال جذب.

اسکیماSoftwareApplication یا Product روی صفحات تجاری، BreadcrumbList روی همه، FAQPage برای AEO، TechArticle روی آموزش‌ها.

تسک‌های مدیر محتوا و سئو

۶ هفته اول ۸ محتوا در هفته، بعد دائماً ۴ محتوا در هفته؛ هیچ محتوایی بدون اجرای واقعی کد و قیمت تاریخ‌دار منتشر نشود.

استاندارد هر محتوای API

کد اجراشده: هر snippet روی api.hoosha.com اجرا و خروجی یا اسکرین‌شات کنسول کنارش. آیدی مدل دقیقاً از docs (gpt-6.1-terra، نه نام نمایشی).
ساختار ثابت: پاسخ مستقیم ۴۰ تا ۶۰ کلمه‌ای ← پیش‌نیازها ← مراحل شماره‌دار ← کد کامل ← جدول خطاها (401، 402، 404، 429) ← نمونه هزینه تومانی ← CTA ساخت کلید.
قیمت و مدل تاریخ‌دار: «به‌روزرسانی: تاریخ» زیر جدول؛ قیمت از docs یا GET /models در روز انتشار.
لینک داخلی: ۱ لینک به صفحه تجاری کلاستر، ۱ لینک به docs، ۲ لینک به آموزش مرتبط؛ بعد از انتشار از ۳ صفحه پرترافیک به آن لینک بده.
ادعای صادقانه: تا Claude در API نیست، «API کلاد» وعده داده نشود؛ تا اعتبار تست نیست، «رایگان» نه؛ «نامحدود» هرگز. محدودیت Cursor Agent و Codex صریح گفته شود.
بعد از انتشار: URL Inspection و Request Indexing، ثبت در شیت، چک ایندکس بعد از ۷۲ ساعت.

کار دائمی هفتگی

ترکیب ۴ محتوا: ۲ آموزش اتصال یا کاربردی، ۱ خبر مدل جدید (ظرف ۴۸ ساعت از افزوده‌شدن به API)، ۱ مسئله‌محور یا مقایسه‌ای.
سرچ کنسول: کوئری‌های شامل «api»، «کلید»، «توکن» و نام ابزارها؛ بازنویسی تایتل صفحات با Impression بالا و CTR پایین.
به‌روزرسانی ماهانه جدول قیمت و فهرست مدل‌ها در همه صفحات.
خلاصه هر آموزش در ویرگول با لینک به اصل؛ README گیت‌هاب با لینک به آموزش.
PR برای افزودن درایور هوشا به پکیج‌های متن‌باز ایرانی (مثل پکیج لاراولی که GapGPT و AvalAI را دارد).

موج اول محتوا (۱۶ عنوان)

#	عنوان پیشنهادی	کیورد هدف	نوع	لینک به
۱	اتصال Cline به هوشا: کدنویسی با ایجنت بدون اکانت خارجی	cline، آموزش cline	اتصال	`/api/coding-agents/`
۲	راه‌اندازی Claude Code با API هوشا	claude code ایران، کلاد کد	اتصال	`/api/coding-agents/`
۳	بهترین هوش مصنوعی برای برنامه‌نویسی؛ مقایسه با هزینه تومانی	بهترین هوش مصنوعی برای برنامه نویسی	مقایسه	`/api/coding-agents/`
۴	خطای unsupported_country در API OpenAI: علت و راه‌حل	خطای api openai ایران	مسئله‌محور	`/api/gpt/`
۵	ساخت ربات تلگرام با ChatGPT در پایتون (کد کامل)	ساخت ربات تلگرام با chatgpt	کاربردی	`/api/gpt/`
۶	اتصال n8n به GPT و Gemini + تمپلیت ایجنت آماده	n8n هوش مصنوعی	اتصال	`/api/`
۷	API key چیست و چطور کلید API هوش مصنوعی بسازیم	api key چیست	آموزشی	`/api/`
۸	هزینه API هوش مصنوعی را چطور حساب کنیم	هزینه api chatgpt	آموزشی + ابزار	`/api/pricing/`
۹	ساخت ویدیو با Veo 3.1 از طریق API	api veo	کاربردی	`/api/video/`
۱۰	تبدیل متن به گفتار فارسی با API؛ ۳۰ گوینده ElevenLabs	api تبدیل متن به صدا	کاربردی	`/api/tts/`
۱۱	تولید و ویرایش تصویر با Nano Banana از طریق API	api nano banana	کاربردی	`/api/image/`
۱۲	ساخت آهنگ با Suno V6 از طریق API	api suno	کاربردی	`/api/music/`
۱۳	تولید خودکار توضیح محصول ووکامرس با هوش مصنوعی	هوش مصنوعی ووکامرس	کاربردی	`/api/gpt/`
۱۴	LangChain و Vercel AI SDK با base_url هوشا	langchain فارسی	اتصال	`/api/`
۱۵	Roo Code، OpenCode و Aider با یک کلید	roo code، opencode	اتصال	`/api/coding-agents/`
۱۶	جایگزین API OpenAI در ایران؛ مقایسه منصفانه گزینه‌ها	جایگزین api openai	مقایسه	`/api/`

کانال‌های تبلیغاتی و پیام تبلیغاتی

اولویت به ترتیب CAC: (۱) کاربران فعلی هوشا، (۲) Google Ads سرچ، (۳) تلگرام، (۴) یوتیوبر برنامه‌نویسی، (۵) کامیونیتی و PR. یکتانت فقط برای ریتارگتینگ؛ اینستاگرام کانال اصلی API نیست.

کانال	چرا	اجرا	سهم بودجه (فرض)
داخل اپ و کاربران فعلی	+۳ میلیون کاربر، CAC تقریباً صفر	بنر در دستیار «کارشناس کدنویسی»، آیتم API در منو، ایمیل/پیامک به کاربران با سؤال کدنویسی، کانال و بات تلگرام هوشا	بدون هزینه رسانه
Google Ads سرچ	بالاترین Intent	کمپین جدا: API عمومی، API مدل‌ها، ایجنت کدنویسی، Media API، برند رقبا (تست کوچک)؛ زبان فارسی	٪۴۰
تلگرام: پست در کانال‌ها	دولوپر ایرانی در تلگرام است	کانال‌های پایتون، لاراول، JS، DevOps و اخبار AI؛ پست آموزشی کوتاه با کد؛ UTM جدا	٪۲۰
Telegram Ads	هدف‌گیری بر اساس کانال	کانال‌های برنامه‌نویسی و AI؛ متن بدون صفت عالی بی‌سند؛ به Premium نمایش داده نمی‌شود	٪۱۰
یوتیوبر و مدرس	اعتماد، محتوای ماندگار	ویدیوی اتصال Cline/n8n با اعتبار اختصاصی	٪۱۵
PR و رپورتاژ	اعتبار برند	رپورتاژ زومیت/دیجیاتو با زاویه دولوپری	٪۱۰
یکتانت	تراکم دولوپر کم	فقط ریتارگتینگ `/api/` و docs	٪۵
کامیونیتی و رویداد	تقاضای بلندمدت	گیت‌هاب، ویرگول، اسپانسری میت‌آپ و هکاتون، برنامه معرفی	هزینه اعتبار

Google Ads: تنظیمات کلیدی

اهداف تبدیل: api_key_created و api_first_request ثانویه؛ api_first_topup با ارزش واقعی اصلی. ساخت کلید رایگان است، پس بهینه‌سازی رویش فریب‌دهنده است.
استراتژی پیشنهاد: Maximize Conversions روی شارژ اول؛ اگر داده کم بود موقتاً ساخت کلید اصلی + سقف CPC؛ بعد از ۳۰ تبدیل در ماه tROAS.
نگتیو از روز اول: رایگان آنلاین، دانلود، اپلیکیشن، apk، چت آنلاین، لوله، پیامک، قیمت دلار، ارز، طلا («api» در فارسی با این‌ها قاطی است).
«خرید اکانت کلاد»: پرحجم‌ترین سیگنال، اما تا Claude در API نیامده فقط تست کوچک با پیام صادقانه و مقصد /api/coding-agents/.

نمونه پیام‌ها

تیترهای RSA گوگل (زیر ۳۰ کاراکتر)

API هوش مصنوعی با پرداخت ریالییک کلید برای GPT و Geminiسازگار با SDK اوپن‌ای‌آیفقط base_url را عوض کنیدVeo، Kling و Suno در یک APIهزینه دقیق هر درخواستبدون نیاز به اکانت خارجیساخت کلید API در ۱ دقیقه

توضیحات RSA (زیر ۹۰ کاراکتر)

کدتان را نگه دارید؛ base_url را روی هوشا بگذارید و با GPT، Gemini و DeepSeek کار کنید.
چت، تصویر، ویدیو، موسیقی و صدای فارسی با یک کلید و یک موجودی. پرداخت ریالی.
درخواست ناموفق هزینه ندارد. هزینه دقیق هر درخواست را در پاسخ API ببینید.

پست کانال تلگرام برنامه‌نویسیکد OpenAI‌تان را با تغییر یک خط به هوشا وصل کنید: base_url = https://api.hoosha.com/v1. GPT 6.1، Gemini 3.8 و DeepSeek برای چت؛ Veo، Kling، Suno و ۳۰ صدای فارسی برای مدیا؛ همه با یک کلید و پرداخت ریالی. آموزش اتصال Cline و n8n در لینک زیر.

Telegram AdsAPI سازگار با OpenAI با پرداخت ریالی؛ GPT، Gemini، Veo و صدای فارسی با یک کلید. فقط base_url را عوض کنید.

بنر داخل اپبرنامه‌نویس هستید؟ همین مدل‌ها را با API در پروژه خودتان داشته باشید.

تست A/B زاویه‌ها: «یک خط کد» (سادگی) در برابر «بدون ترس از بن» (درد) در برابر «Veo و Suno با یک کلید» (مدیا). فرضیه: «درد» برای ایجنت کدنویسی و «یک خط کد» برای دولوپر عمومی برنده می‌شود؛ داده تصمیم می‌گیرد.

۱۰

KPI، ترکینگ و گزارش‌دهی

KPI اصلی «اعتبار مصرف‌شده از طریق کلیدهای API» است، نه خرید اعتبار. اعتبار بین اپ و API مشترک است؛ درآمد واقعی API را فقط بک‌اند کنسول (مصرف به تفکیک کلید) می‌دهد.

بازدید /api/لندینگ و docs

ساخت کلیدapi_key_created

اولین ریکوئستapi_first_request

اولین شارژapi_first_topup

KPI	تعریف	منبع	هدف اولیه (فرضیه)
درآمد API	مجموع `cost_credits` همه کلیدها × قیمت میانگین اعتبار	بک‌اند کنسول	روند ماهانه رو به رشد؛ عدد پایه بعد از ماه اول
کاربر فعال API	حساب با حداقل ۱ ریکوئست موفق در ۳۰ روز	بک‌اند	رشد ماه‌به‌ماه
کلید ← اولین ریکوئست	کلیدهای با ریکوئست موفق ظرف ۲۴ ساعت	بک‌اند	بالای ٪۶۰
ریکوئست ← اولین شارژ	کاربران API که ظرف ۱۴ روز شارژ می‌کنند	بک‌اند + GA4	٪۱۵ تا ٪۳۰
ماندگاری ماه دوم	فعال‌های ماه ۱ که در ماه ۲ هم ریکوئست دارند	بک‌اند	بالای ٪۴۰
CAC کانال	هزینه کانال ÷ کاربران API با اولین شارژ	Google Ads، فاکتور تلگرام، GA4	Payback زیر ۱ ماه (دولوپر)، تا ۳ ماه (B2B)
سهم ارگانیک	کلیک سرچ کنسول روی `/api/` و آموزش‌ها	GSC	رشد هفتگی

پیاده‌سازی ترکینگ

Cross-domain بین hoosha.com، docs و console در همان property و کانتینر GTM؛ وگرنه ورود به کنسول سشن جدید referral می‌سازد.
رویدادها: api_cta_click، api_sign_up، api_key_created، api_first_request، api_first_topup با value؛ سه‌تای آخر سمت سرور (Measurement Protocol) با client_id ذخیره‌شده.
UTM تلگرام: utm_source=telegram&utm_medium=channel_post&utm_campaign=api_launch&utm_content=نام‌کانال؛ Telegram Ads با utm_medium=tg_ads.
گزارش هفتگی: قیف به تفکیک کانال (First touch و Last touch کنار هم) + مصرف اعتبار API و ۱۰ کلید پرمصرف.

۱۱

فرضیات، ریسک‌ها و داده‌های قابل تأیید

بزرگ‌ترین ریسک: شروع تبلیغات قبل از بسته‌شدن شکاف‌های P0؛ ترافیک می‌خریم و در «ساخت کلید ← شارژ ۱٫۱۸ میلیونی» از دستش می‌دهیم.

مورد	نوع	چطور تأیید یا مدیریت شود
حجم کیوردها	فرض	Keyword Planner فارسی + Impressions سرچ کنسول بعد از ۴ هفته
رقابتی‌بودن قیمت در برابر GapGPT و AvalAI	ناشناخته	مقایسه دستی همان روز برای ۳ مدل مشترک
دسترسی `api.hoosha.com` از سرور داخل ایران بدون پروکسی	فرض کلیدی	تست از دو دیتاسنتر داخلی؛ اگر برقرار نیست پیام «بدون VPN روی سرور» حذف شود
زمان افزوده‌شدن Claude به API	ناشناخته	از مدیریت/فنی؛ تا قطعی‌شدن `/api/claude/` ساخته نشود
ریسک پرووایدر بالادستی	ریسک	«تضمین» و «بدون قطعی» ننویسیم؛ status page بسازیم
Muse Spark ورودی را برای آموزش متا استفاده می‌کند	Fact	در محتوای کدنویسی و B2B پیشنهاد نشود مگر با همین هشدار
Google Ads ایران را هدف نمی‌گیرد	محدودیت	هدف‌گیری زبان فارسی، نگتیو قوی، تبدیل سمت سرور
فروش عمده به سازندگان بات رقیب	ریسک / فرصت	قیمت پلکانی و قرارداد جدا؛ تصمیم با مدیریت