MiMo-V2.5 API'si Nasıl Kullanılır: Eksiksiz Geliştirici Kılavuzu

TL;DR

CometAPI'de MiMo-V2.5 API kodlama, çok modlu anlayış ve ajan iş yükleri için Xiaomi'nin seyrek uzmanlar karması modeline erişim sağlar. Bir projede 1 milyon belirteçlik bağlam penceresi, yerel çok modlu girdi ve düşük belirteç maliyeti gerektiğinde pratik varsayılan MiMo-V2.5 API'dir; fiyat yerine zorlayıcı kodlama, akıl yürütme veya uzun ufuklu araç kullanımı daha önemliyse MiMo-V2.5 Pro daha uygundur. Bu kılavuz, API'yi CometAPI üzerinden çağırmayı, yanıtları akış olarak iletmeyi, çok modlu istekleri yapılandırmayı, maliyeti tahmin etmeyi ve üretim entegrasyonunu sağlamlaştırmayı gösterir.

Temel Çıkarımlar

• MiMo-V2.5 modeli toplam 310B parametre kullanır, belirteç başına 15B aktif parametreye sahiptir ve 1M belirteçlik bağlam penceresini destekler.
• Çok modlu işler, geniş bağlam analizi ve maliyet duyarlı ajanlar için MiMo-V2.5 rotasını; en zorlayıcı kodlama ve akıl yürütme görevleri için MiMo-V2.5 Pro'yu kullanın.
• OpenAI uyumlu uç nokta geçişi kolaylaştırır, ancak üretim sistemlerinde yine de zaman aşımları, yeniden deneme mantığı, belirteç bütçeleri ve sağlayıcı tarafı yetenek kontrolleri gerekir.
• Belirtilen CometAPI tarifelerinde, 10.000 giriş belirteci ve 2.000 çıkış belirteci içeren bir istek MiMo-V2.5 rotasında yaklaşık $0.001568 tutar.

MiMo-V2.5 Modeline Genel Bakış

Xiaomi modeli 22 Nisan 2026'da tanıttı. CometAPI'de MiMo-V2.5 API onu OpenAI uyumlu bir chat-completions arayüzü üzerinden sunar, bu nedenle mevcut istemciler genellikle temel URL'yi, API anahtarını ve model tanımlayıcısını değiştirerek geçiş yapabilir.

Resmi model kartına göre, model seyrek MoE dil omurgasını özel görsel ve ses kodlayıcılarla birleştirir. Metin, görüntü, video ve ses girdilerini kabul ederken metin çıktısı üretir. Geniş bağlam penceresi depo ölçeğinde kod incelemesi, belge setleri, uzun dökümler ve çok adımlı ajanlar için kullanışlıdır.

Aşağıdaki resmi çok modlu kıyaslama görseli, görüntü anlama, çok modlu ajan ve video anlama görevlerindeki sonuçları raporlar.

Resmi Xiaomi MiMo-V2.5 çok modlu kıyaslama karşılaştırması

Sağlayıcı rotaları, altta yatan modelin desteklediğinden daha dar bir ortam formatı kümesini sunabilir. Çok modlu bir özelliği yayına almadan önce etkin uç noktaya karşı tam görüntü, ses ve video yük formatını doğrulayın.

MiMo-V2.5 Kıyaslama Performansı

Xiaomi, kodlama, terminal kullanımı ve çok modlu ajan değerlendirmesinde güçlü sonuçlar bildiriyor. Bu sayılar modeli konumlandırmak için faydalıdır, ancak kendi istemleriniz, araçlarınız, gecikme hedefleriniz ve hata koşullarınız üzerinde yapılan testlerin yerine geçmez.

Resmi kodlama karşılaştırması, Terminal-Bench 2.0'da 65.8 ve SWE-Bench Pro'da 56.1 gösterirken modeli daha geniş bir kodlama-ajan karşılaştırmasına da yerleştirir.

Resmi Xiaomi MiMo-V2.5 kodlama kıyaslama karşılaştırması

Sonuçların önerdiği şey: model, kod, araçlar ve karma ortamları birleştiren uygulamalar için özellikle caziptir. Deterministik üretim kararları için, görev başarısını, belirteç kullanımını, uçtan uca gecikmeyi, yeniden deneme sıklığını ve insan düzeltme oranını ölçen dahili bir değerlendirme çalıştırın.

MiMo-V2.5 ve MiMo-V2.5 Pro: Çok Boyutlu Karşılaştırma

Karşılaştırma sonucu: kararınızı maliyet, verim veya çok modlu kapsama sürüklüyorsa MiMo-V2.5 rotasıyla başlayın. Zor kodlama, akıl yürütme veya araç kullanımı vakalarında anlamlı bir doğruluk artışı gösterdiğinde seçili istekleri MiMo-V2.5 Pro'ya taşıyın. Her isteği MiMo-V2.5 Pro'ya göndermek yerine kademeli bir yönlendirici genellikle daha iyi bir maliyet-kalite dengesi sağlar.

MiMo-V2.5 API'sini Nasıl Çağırırsınız

API, tanıdık chat-completions şemasını izler. Anahtarı sunucunuzda tutun, bir ortam değişkeninden yükleyin ve asla tarayıcı veya mobil koda gömmeyin.

API anahtarını ayarlayın

export COMETAPI_KEY="your_api_key_here"

$env:COMETAPI_KEY = "your_api_key_here"

### Bir cURL isteği gönderin

curl https://api.cometapi.com/v1/chat/completions
-H "Authorization: Bearer $COMETAPI_KEY"
-H "Content-Type: application/json"
-d '{
"model": "mimo-v2.5",
"messages": [
{"role": "system", "content": "You are a careful coding assistant."},
{"role": "user", "content": "Explain the bug and propose a minimal patch."}
],
"temperature": 0.2
}'

### OpenAI SDK ile Python kullanın

import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
model="mimo-v2.5",
messages=[
{"role": "system", "content": "You are a precise engineering assistant."},
{"role": "user", "content": "Review this migration plan for hidden risks."},
],
temperature=0.2,
)

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

> API anahtarlarını, tam yetkilendirme başlıklarını veya hassas istem içeriğini günlüğe kaydetmeyin. Üretimde bir gizli anahtar yöneticisi kullanın ve kimlik bilgilerini tanımlı bir takvime göre döndürün.

## MiMo-V2.5 API Yanıtlarını Nasıl Yayınlarsınız (Stream)

Yayınlama, uzun yanıtlar için algılanan gecikmeyi azaltır. Hizmet artımlı olaylar döndürür ve SDK bunları parça olarak sunar.

stream = client.chat.completions.create(
model="mimo-v2.5",
messages=[{"role": "user", "content": "Draft a safe database migration checklist."}],
stream=True,
)

for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)

Bir web hizmetinde, delta'ları Server-Sent Events veya WebSocket ile iletin, istemci bağlantı kesilmelerini ele alın ve kullanıcı iptal ettiğinde yukarı akış üretimini durdurun.

## MiMo-V2.5 API Çok Modlu ve Yapılandırılmış İş Akışları

Görüntü farkındalığı gereken görevlerde, aynı kullanıcı mesajında bir metin talimatı ile bir görüntü nesnesi gönderin. Kabul edilen kesin ortam temsili sağlayıcı rotasına göre değişebilir, bu nedenle bunu bir yük kalıbı olarak ele alın ve mevcut rota desteğini doğrulayın.

{
"model": "mimo-v2.5",
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "Extract the visible error and suggest the next diagnostic step."},
{"type": "image_url", "image_url": {"url": "https://example.com/error.png"}}
]
}
]
}

Makine tarafından okunabilir çıktı için, kompakt bir JSON nesnesi isteyin ve bunu kendi şemanıza karşı doğrulayın. Sırf ayrıştırıldığı için oluşturulan JSON'un güvenli olduğunu varsaymayın.

import json

raw = response.choices[0].message.content
result = json.loads(raw)

required = {"summary", "risks", "next_action"}
missing = required - result.keys()
if missing:
raise ValueError(f"Missing fields: {sorted(missing)}")

## CometAPI'de MiMo-V2.5 API Fiyatlandırması ve Maliyet Kontrolü

| Rota                          | 1M belirteç başına giriş | 1M belirteç başına çıkış | 100 istek örneği |
| ----------------------------- | ------------------------ | ------------------------ | ---------------- |
| MiMo-V2.5                     | $0.112                   | $0.224                   | $0.1568          |
| MiMo-V2.5 Pro                 | $0.348                   | $0.696                   | $0.4872          |
| Xiaomi kullanıma göre ödeme referansı | $0.14             | $0.28                    | $0.1960          |

Örnek, her biri 10.000 giriş belirteci ve 2.000 çıkış belirteci içeren 100 isteği varsayar. Bu varsayımlar altında MiMo-V2.5 rotası MiMo-V2.5 Pro'ya göre yaklaşık %68 daha ucuzdur. Xiaomi'nin [yayınladığı kullanıma göre ödeme tarifeleri](https://platform.xiaomimimo.com/docs/zh-CN/integration/roocode) yararlı bir referans sağlar; gerçek faturalar dağıtımdan önce etkin sağlayıcı fiyatına karşı doğrulanmalıdır.

MiMo-V2.5 input: 100 × 10,000 / 1,000,000 × $0.112 = $0.1120
MiMo-V2.5 output: 100 × 2,000 / 1,000,000 × $0.224 = $0.0448
MiMo-V2.5 total: $0.1568

Pro input: 100 × 10,000 / 1,000,000 × $0.348 = $0.3480
Pro output: 100 × 2,000 / 1,000,000 × $0.696 = $0.1392
Pro total: $0.4872

Maliyeti maksimum çıktı sınırları, istem sıkıştırma, önbelleğe alınmış bağlam, istek sınıflandırma ve yalnızca zor görevleri yükselten bir yönlendirici ile kontrol edin. İstek başına maliyet yerine başarılı görev başına maliyeti izleyin; tekraren başarısız olan daha ucuz bir istek总体de daha pahalı olabilir.

## Uzun Bağlamlı MiMo-V2.5 API İstekleri Nasıl Tasarlanır

1M belirteçlik pencere daha büyük girdileri mümkün kılar, ancak alım ve dikkat ödünleşimlerini ortadan kaldırmaz. Modelin ilgili kanıtları hızla bulabilmesi için istemi oluşturun.

* Görevi, çıktı sözleşmesini ve karar kriterlerini başa yakın yerleştirin.
* Belgeleri kalıcı tanımlayıcılar ve net sınırlayıcılarla ayırın.
* Yalnızca yanıtı etkileyebilecek kanıtları dahil edin.
* Modelden sonucunda belge tanımlayıcılarını veya satır referanslarını alıntılamasını isteyin.
* Bağlam büyüdükçe doğruluğu ölçün; maksimum bağlamı ideal bağlam olarak görmeyin.

> Uzun bağlam hem belirteç maliyetini artırır hem de alakasız materyalin modeli dikkatini dağıtma olasılığını yükseltir. Tüm külliyat sığsa bile alma, özetleme ve hiyerarşik istemleme önemini korur.

## Üretim Güvenilirliği

### Yalnızca geçici hataları yeniden deneyin

Oran sınırlamaları ve geçici sunucu hatalarını üstel geri çekilme ve jitter ile yeniden deneyin. Geçersiz kimlik doğrulama, hatalı biçimlendirilmiş yükler veya politika hatalarını otomatik olarak yeniden denemeyin.

import random
import time

def delay_for(attempt: int) -> float:
return min(30.0, (2 ** attempt) + random.random())

for attempt in range(5):
try:
result = call_model()
break
except TransientAPIError:
if attempt == 4:
raise
time.sleep(delay_for(attempt))

### Operasyonel korumalar ayarlayın

* Bağlantı ve genel istek zaman aşımlarını kullanın.
* Harici yan etkileri olan iş akışlarına bir idempotency anahtarı ekleyin.
* Model kimliği, gecikme, giriş ve çıkış belirteçleri, yeniden deneme sayısı ve nihai durumu kaydedin.
* Günlüklemeye geçmeden önce sırları ve kişisel verileri redakte edin.
* Yıkıcı eylemler için araç izin listeleri ve onay gerektirin.
* Sağlayıcı kesintilerinde bir yedek model veya kuyruk bulundurun.

## MiMo-V2.5 API Yaygın Hatalar ve Çözümleri

| Belirti      | Olası neden                                   | Önerilen eylem                                                |
| ------------ | ---------------------------------------------- | ------------------------------------------------------------- |
| 401 veya 403 | Eksik, geçersiz veya yetkisiz API anahtarı     | Sunucu tarafı sırrı ve proje izinlerini doğrulayın.           |
| 400          | Hatalı mesajlar veya desteklenmeyen medya nesnesi | JSON'u doğrulayın ve rota özelinde yük desteğini teyit edin. |
| 413          | İstek gövdesi çok büyük                        | Medya boyutunu küçültün veya girişi bölün.                    |
| 429          | Oran veya kota limiti                          | Jitter ile geri çekilin ve istemci tarafı eşzamanlılık sınırlarını uygulayın. |
| 5xx          | Geçici sağlayıcı hatası                        | Sınırlı bir bütçe dahilinde yeniden deneyin veya alternatif yola geçin. |
| Yavaş yanıt  | Büyük bağlam, uzun çıktı veya araç gecikmesi   | Çıktıyı yayınlayın (stream), belirteçleri sınırlayın ve her aşamayı profilleyin. |
| Geçersiz JSON| Oluşturma sapması                               | Doğrulayın, güvenliyse bir kez onarın ve kalıcı hataları reddedin. |

## Sonuç

MiMo-V2.5 modeli, çok modlu girdi, geniş bağlam ve agresif maliyet kontrolüne ihtiyaç duyan ekipler için en güçlü başlangıç noktasıdır. Pro, ölçülen kalite kazanımlarının daha yüksek fiyatı haklı çıkardığı görevler için kasıtlı bir yükseltme yolu olmalıdır. Küçük bir değerlendirme setiyle başlayın, her isteği enstrümante edin ve gerçek yükler, uzun bağlam davranışı, yeniden deneme işleme ve hata kurtarma test edildikten sonra entegrasyonu yayına alın.

## SSS

### Hangi uç noktayı kullanmalıyım?

`/api.cometapi.com/v1/chat/completions` kullanın veya OpenAI uyumlu bir SDK'da temel URL olarak `/api.cometapi.com/v1`'i ayarlayın.

### Hangi model tanımlayıcısını göndermeliyim?

MiMo-V2.5 rotası için `mimo-v2.5` kullanın. Hesabınız sağlayıcıya özgü bir takma ad kullanıyorsa, yayına almadan önce geçerli tanımlayıcıyı teyit edin.

### MiMo-V2.5 Pro'yu ne zaman seçmeliyim?

Değerlendirmeniz, zorlayıcı kodlama, akıl yürütme veya uzun süreli araç görevlerinde anlamlı bir avantaj gösterdiğinde MiMo-V2.5 Pro'yu seçin. Kalitesi yeterli olduğunda rutin veya çok modlu trafiği MiMo-V2.5 rotasında tutun.

### 1M belirteçlik bir bağlam, her şeyi göndermem gerektiği anlamına mı gelir?

Hayır. Büyük bağlam bir kapasite sınırıdır, istem tasarımı hedefi değildir. Yanıtı etkileyebilecek kanıtları alın ve düzenleyin, ardından giriş büyüdükçe kalite ve maliyeti ölçün.

### API'yi doğrudan bir tarayıcıdan çağırabilir miyim?

Gizli bir API anahtarını ön uç kodunda açığa çıkarmayın. Sağlayıcıyı aramayı arka ucunuzdan yapın ve kimlik doğrulama, oran sınırlama, günlükleme ve veri denetimlerini orada uygulayın.

### Çok modlu desteği nasıl doğrularım?

Kesin ortam yükünü etkin sağlayıcı rotasına karşı test edin. Altta yatan modelin yerel kipleri, her rotanın her formatı aynı şekilde sunduğu garantisini vermez.