Kimi API ব্যবহারের বিস্তারিত নির্দেশিকা: Kimi K2.5 মডেল গাইড

উন্নত AI সক্ষমতা, ২৫৬K কনটেক্সট এবং সাশ্রয়ী মূল্যে আপনার অ্যাপ্লিকেশনকে আরও শক্তিশালী করুন।

Kimi API পরিচিতি শুরু করার ধাপ মূল্য তালিকা রেট লিমিট মাল্টিমোডাল গাইড বিকল্প পদ্ধতি FAQ

Kimi API ব্যবহারের বিস্তারিত নির্দেশিকা

Kimi API বর্তমানে Moonshot AI-এর Kimi K2.5 মডেল ব্যবহারের সুযোগ দেয়। এটি ১ ট্রিলিয়ন প্যারামিটারের একটি MoE মডেল যা মাল্টিমোডাল ক্ষমতা, ২৫৬K টোকেন কনটেক্সট উইন্ডো এবং উন্নত এজেন্টিক ফিচার সমৃদ্ধ। এই REST-ভিত্তিক ইন্টারফেসটি ব্যবহার করে ডেভেলপাররা তাদের অ্যাপ্লিকেশনে জটিল যুক্তি বিশ্লেষণ, ভিশন আন্ডারস্ট্যান্ডিং এবং ডকুমেন্ট বিশ্লেষণের মতো কাজগুলো সহজে যুক্ত করতে পারেন। বর্তমানে ২০২৬ সালে এটি Moonshot প্ল্যাটফর্মের পাশাপাশি OpenRouter, Together AI এবং NVIDIA NIM-এর মতো থার্ড-পার্টি মাধ্যমেও উপলব্ধ।

OpenAI ইকোসিস্টেমে অভ্যস্ত ডেভেলপারদের জন্য এই মাইগ্রেশন অত্যন্ত সহজ। এই API সম্পূর্ণভাবে OpenAI SDK-র কাঠামোর সাথে সামঞ্জস্যপূর্ণ, যেখানে শুধুমাত্র base URL এবং API key পরিবর্তন করতে হয়। কানেকশনের জন্য স্ট্যান্ডার্ড Bearer token অথরাইজেশন পদ্ধতি ব্যবহার করা হয়। Python এবং Node.js-এর জন্য অফিসিয়াল SDK অনুরোধগুলো পরিচালনা করে। এছাড়া যারা নিজেদের ইনফ্রাস্ট্রাকচারে পূর্ণ নিয়ন্ত্রণ চান, তারা Hugging Face থেকে ওপেন-সোর্স মডেল ওয়েটস ব্যবহার করে নিজস্ব পরিবেশে এটি ডেপ্লয় করতে পারেন।

এই API অন্যদের থেকে আলাদা হওয়ার কারণ হলো এর ২৫৬K কনটেক্সট উইন্ডো এবং নেটিভ ভিশন ক্ষমতা। এটি Claude Opus 4.5 এর তুলনায় প্রায় ৪ গুণ সাশ্রয়ী। যখন একটি মডেল একবারে পুরো ডকুমেন্ট সেট প্রসেস করতে পারে এবং ছবি বা চার্ট বুঝতে সক্ষম হয়, তখন জটিল RAG পাইপলাইনগুলো তৈরি করা অনেক সহজ হয়ে যায়। Kimi প্ল্যাটফর্মের এই সুবিধাগুলো এখন ইন্টারফেসের পাশাপাশি সরাসরি প্রোগ্রামিংয়ের মাধ্যমেও উপভোগ করা সম্ভব।

বৈশিষ্ট্য	বিস্তারিত তথ্য
বর্তমান মডেল	Kimi K2.5 (kimi-k2.5)
কনটেক্সট উইন্ডো	২৬২,১৪৪ টোকেন (২৫৬K)
ইনপুট ধরণ	টেক্সট, ছবি, ভিডিও, ডকুমেন্ট
অথরাইজেশন	Authorization হেডারের মাধ্যমে Bearer token
SDK সমর্থন	Python, Node.js (OpenAI সাপেক্ষ)
প্রদানকারী	Moonshot Official, OpenRouter, Together AI, NVIDIA NIM

এই API এন্ডপয়েন্টগুলো চ্যাট কমপ্লিশন, JSON রেসপন্স এবং স্ট্রিমিং আউটপুটের জন্য OpenAI-এর কাঠামোর অনুকরণ করে। K2.5 মডেলের মাধ্যমে ব্যবহারকারীরা চারটি মোড ব্যবহার করতে পারেন: Instant, Thinking, Agent এবং Agent Swarm। মডেলের সংস্করণগুলো নিয়মিত আপডেট করা হয় যাতে পারফরম্যান্স উন্নত থাকে।

OpenAI-সামঞ্জস্যপূর্ণ REST এন্ডপয়েন্ট ব্যবহারের ফলে কোড পরিবর্তনের ঝামেলা অনেক কমে যায়।
স্ট্রিমিং রেসপন্স ব্যবহারের ফলে জেনারেট হওয়ার সময় প্রগ্রেসিভ UI আপডেট দেওয়া সম্ভব হয়।
ফাংশন কলিং সমর্থনের মাধ্যমে টুল ব্যবহার এবং স্ট্রাকচারড আউটপুট পাওয়া সহজ হয়।
নেটিভ মাল্টিমোডাল ইনপুট ব্যবহারের ফলে টেক্সটের পাশাপাশি ছবি ও ভিডিও বিশ্লেষণ করা যায়।
স্বয়ংক্রিয় কনটেক্সট ক্যাশিং সুবিধা ইনপুট খরচ প্রায় ৭৫ শতাংশ পর্যন্ত কমিয়ে আনে।

কিভাবে API ব্যবহার শুরু করবেন

রেজিস্ট্রেশন প্রক্রিয়া সম্পন্ন করতে মাত্র কয়েক মিনিট সময় লাগে। প্রথমে platform.moonshot.ai সাইটে গিয়ে ইমেল ভেরিফিকেশনের মাধ্যমে একটি অ্যাকাউন্ট তৈরি করুন। সেখানে ডেভেলপার ড্যাশবোর্ডে গিয়ে API key সেকশনটি খুঁজে নিন। প্ল্যাটফর্মটিতে ইংরেজি এবং চীনা উভয় ভাষাতেই ডকুমেন্টেশন এবং কোড উদাহরণ দেওয়া আছে।

প্রথমে platform.moonshot.ai সাইটে নিবন্ধন করুন এবং আপনার ইমেল এড্রেসটি যাচাই করুন।
ডেভেলপার ড্যাশবোর্ডের API Keys সেকশনে প্রবেশ করুন।
আপনার প্রথম API key তৈরি করুন এবং এটি সুরক্ষিতভাবে সংরক্ষণ করুন কারণ এটি পুনরায় দেখা যাবে না।
OpenAI Python SDK ইনস্টল করুন অথবা সরাসরি cURL কমান্ড ব্যবহার করে কাজ শুরু করুন।

from openai import OpenAI

client = OpenAI(
    api_key="your_moonshot_api_key",
    base_url="https://api.moonshot.cn/v1"
)

response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain the MoE architecture."}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

এই কোডটি হুবহু OpenAI API কলের মতো কাজ করে। GPT মডেল থেকে সুইচ করার জন্য আপনাকে শুধু base_url এবং api_key প্যারামিটারগুলো আপডেট করতে হবে। এর ফলে বর্তমানের এরর হ্যান্ডলিং বা রিট্রাই লজিক কোনো পরিবর্তন ছাড়াই কাজ করবে।

সার্ভিসের মূল্য তালিকা

Kimi K2.5 বিভিন্ন প্রোভাইডারের মাধ্যমে অত্যন্ত প্রতিযোগিতামূলক মূল্যে পরিষেবা প্রদান করে। বর্তমানে অফিসিয়াল API-তে স্বয়ংক্রিয় কনটেক্সট ক্যাশিং সুবিধা রয়েছে যা পুনরায় ব্যবহৃত কনটেক্সটের ইনপুট খরচ অনেক কমিয়ে দেয়।

প্রোভাইডার	ইনপুট (প্রতি ১M টোকেন)	আউটপুট (প্রতি ১M টোকেন)	ক্যাশড ইনপুট
Moonshot Official	$0.60	$3.00	$0.15 (75% সাশ্রয়)
OpenRouter	$0.45	$2.20	পরিবর্তনশীল
Together AI	$0.50	$2.80	পরিবর্তনশীল

এই মূল্য নির্ধারণ Kimi K2.5-কে Claude Opus 4.5-এর তুলনায় প্রায় ৪ গুণ সস্তা করে তুলেছে। যখন একই সিস্টেম প্রম্পট বা ডকুমেন্টের অংশ বারবার ব্যবহার করা হয়, তখন কোনো অতিরিক্ত কোড ছাড়াই ক্যাশিং ফিচারটি সক্রিয় হয়ে যায়। ২০২৬ সালের এই মূল্যতালিকা অনুযায়ী এটি অন্যতম সাশ্রয়ী হাই-এন্ড মডেল।

রেট লিমিট এবং টিয়ার সিস্টেম

অফিসিয়াল API অ্যাকাউন্টে রিচার্জের পরিমাণের ওপর ভিত্তি করে একটি টিয়ার সিস্টেম অনুসরণ করে। উচ্চতর টিয়ারে থাকলে ব্যবহারকারীরা একই সময়ে বেশি সংখ্যক অনুরোধ বা কনকারেন্সি সুবিধা পান।

টিয়ার	মোট রিচার্জ	কনকারেন্ট রিকোয়েস্ট	প্রতি মিনিটে রিকোয়েস্ট
Tier 1	$10	50	200
Tier 2	$100	100	500
Tier 3	$500	300	2,000
Tier 5	$3,000	1,000	10,000

যেসব অ্যাপ্লিকেশনের জন্য আরও বেশি লিমিট প্রয়োজন, তারা সরাসরি Moonshot AI-এর সেলস টিমের সাথে যোগাযোগ করে এন্টারপ্রাইজ প্ল্যান গ্রহণ করতে পারেন। এতে কাস্টম রেট লিমিটের সুবিধা পাওয়া যায়।

মাল্টিমোডাল API ব্যবহারের পদ্ধতি

Kimi K2.5 মডেলটি সরাসরি ইমেজ এবং ভিডিও গ্রহণ করার ক্ষমতা রাখে। এর MoonViT-3D ভিশন এনকোডার বিভিন্ন রেজোলিউশনের ইনপুট প্রসেস করতে পারে, যার ফলে ক্লায়েন্ট সাইডে ছবির সাইজ পরিবর্তনের প্রয়োজন হয় না।

response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe this chart and extract the data."},
                {"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}}
            ]
        }
    ]
)

এই মডেলটি OCRBench-এ ৯২.৩% এবং InfoVQA-তে ৯২.৬% স্কোর অর্জন করেছে। এর ফলে ডকুমেন্ট বোঝা, চার্ট বিশ্লেষণ এবং ছবি থেকে ডেটা এক্সট্রাক্ট করার কাজে এটি অত্যন্ত কার্যকর। ভিডিও ইনপুটের ক্ষেত্রে ফ্রেম বা ভিডিও URL ব্যবহার করার সুযোগ রয়েছে।

বিকল্প অ্যাক্সেস পদ্ধতিসমূহ

অফিসিয়াল API ছাড়াও Kimi K2.5 আরও বেশ কিছু থার্ড-পার্টি প্ল্যাটফর্ম এবং সেলফ-হোস্টিং অপশনের মাধ্যমে ব্যবহার করা যেতে পারে। এটি ডেভেলপারদের জন্য নমনীয়তা নিশ্চিত করে।

OpenRouter: এটি একটি এগ্রিগেটেড প্ল্যাটফর্ম যেখানে একটি বিলিংয়ের মাধ্যমে অনেক AI প্রোভাইডারের সার্ভিস নেওয়া যায়।
Together AI: এটি কম ল্যাটেন্সি এবং সাশ্রয়ী মূল্যে ইনফারেন্স ইনফ্রাস্ট্রাকচার প্রদান করে।
NVIDIA NIM: এন্টারপ্রাইজ লেভেলে ডেপ্লয়মেন্টের জন্য এনভিডিয়ার ইনফারেন্স মাইক্রোসার্ভিস প্ল্যাটফর্মটি ব্যবহার করা যায়।
Self-hosted: Hugging Face থেকে moonshotai/Kimi-K2.5 মডেলটি ডাউনলোড করে vLLM বা Docker-এর মাধ্যমে চালানো সম্ভব। তবে ১T মডেলের জন্য শক্তিশালী GPU সার্ভার প্রয়োজন।

সাধারণ কিছু জিজ্ঞাসা

Kimi API কি OpenAI SDK সমর্থন করে?

হ্যাঁ, এটি সম্পূর্ণ সামঞ্জস্যপূর্ণ। শুধু base_url পরিবর্তন করে api.moonshot.cn/v1 লিখে আপনার Moonshot কী ব্যবহার করুন। চ্যাট কমপ্লিশন এবং ফাংশন কলিংয়ের মতো ফিচারগুলো একইভাবে কাজ করবে। কানেকশন প্যারামিটার ছাড়া কোডে অন্য কোনো সংশোধনের প্রয়োজন নেই।

এর সর্বোচ্চ কনটেক্সট উইন্ডো কত?

Kimi K2.5 প্রতি অনুরোধে সর্বোচ্চ ২৬২,১৪৪ টোকেন বা ২৫৬K সমর্থন করে। এর মাধ্যমে বিশাল কোডবেস বা দীর্ঘ ডকুমেন্ট সেট কোনো খণ্ড ছাড়াই সরাসরি প্রসেস করা সম্ভব হয়। এটি জটিল ডাটা এনালাইসিসের জন্য অত্যন্ত উপযোগী।

কনটেক্সট ক্যাশিং কিভাবে কাজ করে?

যখন একই সিস্টেম প্রম্পট বা ডকুমেন্টের অংশ বারবার অনুরোধে ব্যবহৃত হয়, তখন সিস্টেম স্বয়ংক্রিয়ভাবে সেটি ক্যাশ করে। ক্যাশড টোকেনের খরচ প্রতি মিলিয়নে মাত্র $০.১৫, যা সাধারণ খরচের চেয়ে অনেক কম। এটি ব্যাকএন্ডে স্বয়ংক্রিয়ভাবে পরিচালিত হয়।

আমি কি Kimi মডেল নিজের সার্ভারে চালাতে পারি?

Kimi K2.5 পরিবর্তিত MIT লাইসেন্সের অধীনে ওপেন-সোর্স হিসেবে লভ্য। আপনি Hugging Face থেকে মডেল ওয়েটস ডাউনলোড করে vLLM বা Transformers ব্যবহার করে ডেপ্লয় করতে পারেন। ১T মডেলটির জন্য মাল্টি-GPU সেটআপের প্রয়োজন হবে। সীমিত রিসোর্সের জন্য Kimi Linear একটি ভালো বিকল্প হতে পারে।

Kimi API কি ভিডিও ইনপুট সাপোর্ট করে?

হ্যাঁ, Kimi K2.5 একটি মাল্টিমোডাল মডেল যা ছবি এবং ভিডিও ফাইল সরাসরি বিশ্লেষণ করতে সক্ষম।

API ব্যবহারের জন্য পেমেন্ট মেথড কী?

অফিসিয়াল প্ল্যাটফর্মে ক্রেডিট রিচার্জের মাধ্যমে API কী সক্রিয় করা যায়, যেখানে বিভিন্ন টিয়ার সিস্টেম কাজ করে।