Source: https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/
Canonical: https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/
Language: ja

# Mistral: Codestral Embed 2505

[Markdown](https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/index.md) · [JSON](https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/facts.json)

## [Mistral: Codestral Embed 2505](https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/)

Codestral Embed 2505は、リポジトリ検索やコーディングアシスタントの情報検索のために、コードと自然言語のクエリをベクトルで表現します。メーカーは、8,192トークンのコンテキスト、最大3,072まで設定可能な次元、浮動小数点・整数・ビットパックの出力形式を文書化しています。

- [**Ailoot Ultra · 埋め込み** `POST /v1/embeddings` `mistralai/codestral-embed-2505`](https://ailoot.ai/models/ja/mistralai-codestral-embed-2505/#method-0)

モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

Codestral Embed 2505は、コード検索に特化したMistral AIの埋め込みモデルです。ソースコードや自然言語のコード検索クエリを含むテキストを受け取り、数値ベクトルを返します。メーカーは、リポジトリ検索、コーディングアシスタントの文脈検索、類似度と重複の分析、機能や構造によるコードのグループ分けに位置付けています。固定のリリース識別子はcodestral-embed-2505です。

入力と表現

コード入力には、関数、関連するソースの断片、その他のリポジトリ内の意味のある単位を使用できます。自然言語のクエリは、正確なシンボル名を指定するのではなく、見つけたい動作を説明できます。埋め込みは比較のためにその入力を表現します。モデルは新しい実装を生成したり、受け取ったコードを実行したりしません。

公式リリースには、完全な入力コンテキストとして8,192トークンが記載されています。検索向けには、より大きなチャンクが検索に悪影響を与える可能性があるとして、メーカーは約3,000文字のチャンクに1,000文字の重なりを付けることを推奨しています。これらは検索用の準備に関する推奨値であり、3,000文字というトークン上限ではありません。検索後にアプリケーションが関連コードを返せるよう、準備した各項目にファイル、シンボル、出典の位置を対応付けてください。

出力精度と次元

コード埋め込みガイドには、float、int8、uint8、binary、ubinaryの出力型が記載されています。floatは32ビットの単精度値を使用します。int8は-128〜127の符号付き8ビット整数、uint8は0〜255の符号なし8ビット値を使用します。binaryとubinaryは、量子化した1ビット値を8ビット要素にパックして保存し、それぞれ符号付き、符号なしのコンテナーを使用します。

ビットパック表現は、返されるリストの長さを変えます。ガイドでは、論理的な埋め込み次元8個につき、パックされた要素1個になると説明しています。そのため、形式を認識した比較は、パックされたバイトを通常の浮動小数点座標として扱うこととは異なります。選択した型をベクトルとともに保持し、インデックス化したコードとそのクエリに同じ表現を使用してください。

パラメーターの文書には、既定の次元1,536、最大次元3,072と記載されています。次元は関連性の順に並び、メーカーは先頭から選んだ個数を残すことで表現サイズを選択できると説明しています。保存済みコレクションと新しいクエリで、次元を一致させてください。短い表現や量子化表現は保存と比較の動作を変えますが、入力コンテキストを増やしたり、モデルをコード生成器に変えたりするものではありません。

検索拡張によるコーディング

リリースの最初のユースケースは、コード補完、編集、説明のための文脈検索です。意味のあるコード単位を準備し、リポジトリのリビジョンとソース識別子を残してください。特定のエラーをどう処理するかという質問から、関連する関数を検索し、アプリケーションが実際の変更依頼とともにコーディングモデルへ渡せます。

実用的な結果は、ファイルパス、シンボル、動作の理解に必要な内容を持つ、順位付きのソーススニペット集合です。検索したスニペットは、開発者が開いたり、アシスタントへ渡したりできます。Codestral Embedが行うのは表現の段階です。別のコンポーネントが結果を選び、生成モデルが説明や提案コードを書きます。

意味検索と類似度比較

メーカーは、自然言語やコードのクエリでコードを検索する用途を説明しています。開発者は、関数名が依頼の表現と異なっていても、ある動作の実装を探せます。意図した実装を区別する動作や条件を含めてください。サブシステム全体についての一般的なクエリは、関連する資料を返しても、具体的な質問を解決しないことがあります。

リリースには、表現が異なっていても、ほぼ重複したコードや機能的に似たコードを見つける用途も説明されています。そのような結果は、再利用可能な実装を見つけたり、さらに確認が必要なコードを特定したりするのに役立ちます。埋め込み空間での類似は、ソースを点検するための信号です。2つの断片があらゆる入力に対して同一の動作をするという証明ではありません。

クラスタリング、分析、比較

コード埋め込みを使って、機能や構造でコードをグループ分けし、リポジトリの構成を調べられます。人や後続のアプリケーション段階がグループを解釈できるよう、元のスニペットと識別子を参照可能にしてください。クラスタは表現に基づくグループであり、自動的に検証されたアーキテクチャ記述ではありません。

メーカーの浮動小数点ベクトルの例は、単位長に正規化した埋め込みを使用し、コサイン類似度、内積、ユークリッド距離で一貫した順位が得られます。量子化出力やビットパック出力は、未加工の浮動小数点座標についての想定を引き継ぐのではなく、それぞれ固有の形式処理を維持するべきです。公開エンドポイントも入力インデックスを保持し、各ベクトルと原本項目のつながりを維持しやすくしています。

エディションと実用上の境界

この正確なモデルページには、8kというコンテキスト表記と、埋め込みおよびバッチのワークフローが記載されています。一方、リリースには8,192トークンという値が示されています。コレクションとクエリのワークフロー全体で、2505というエディション名、選択した出力次元と型を維持してください。これはコード向けのベクトル出力であり、Codestralのテキスト補完や、固定次元のMistral Embedテキストモデルとは異なります。

関連する動作を含むコード単位を準備し、ソースの位置を残し、何を見つけるための質問かを明示してください。有用な成果物は、実際のコードに結び付いた検索可能な表現です。それ自体が次の説明、編集、開発者の確認を実行することなく、それらの段階を支援します。

**Ailoot Ultra · 埋め込み** `POST /v1/embeddings` `mistralai/codestral-embed-2505`

[`mistralai/codestral-embed-2505`](https://ailoot.ai/models/ja/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

Mistral /`mistralai/codestral-embed-2505`

### はじめに

Codestral Embed 2505は、リポジトリ検索やコーディングアシスタントの情報検索のために、コードと自然言語のクエリをベクトルで表現します。メーカーは、8,192トークンのコンテキスト、最大3,072まで設定可能な次元、浮動小数点・整数・ビットパックの出力形式を文書化しています。

対応する入力

テキスト · token\_ids

結果

embedding

### Ailootで利用可能 · 入力とメソッド

**Ailoot Ultra · 埋め込み** `POST /v1/embeddings`

入力の種類

`text`, `token_ids`

出力の種類

`embedding`

コンテキスト

8,192 tokens

出力形式

json

| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
| --- | --- | --- | --- | --- |
| フィールド`model` | 種類`string` | 要件必須 | 値と制限 mistralai/codestral-embed-2505 | デフォルト— |
| フィールド`input` | 種類`string\|string[]\|integer[]\|integer[][]` | 要件必須 | 値と制限 最小項目数: 1 条件: 空でなく、要素の型が統一されたバッチ。トークン ID は非負の整数です。 入力の許容量: 最大値: 8,192 · テキスト単位: UTF8 バイト · トークン単位: トークン配列の要素 | デフォルト— |
| フィールド`encoding_format` | 種類`string` | 要件任意 | 値と制限 float | デフォルトfloat |
| フィールド`dimensions` | 種類`integer` | 要件非対応 | 値と制限 最小値: 1 | デフォルト— |
| フィールド`user` | 種類`json_value` | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
| フィールド`session_id` | 種類`json_value` | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
| フィールド`trace` | 種類`json_value` | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
| フィールド`provider` | 種類`object` | 要件任意 | 値と制限 条件: provider.options は拒否されます | デフォルト— |

入力素材の組み合わせ

**text\_to\_embedding**

メソッドのパラメータとライフサイクル

| パラメータ | 仕様 |
| --- | --- |
| パラメータ`content_type` | 仕様application/json |
| パラメータ`required` | 仕様model, input |
| パラメータ`input_shapes` | 仕様string, string\[\], nonnegative\_integer\_token\_array, nonnegative\_integer\_token\_array\[\] |
| パラメータ`encoding_format` | 仕様float |
| パラメータ`dimensions_override` | 仕様false |
| パラメータ`max_input_budget_units` | 仕様8192 |
| パラメータ`multimodal_objects` | 仕様false |
| パラメータ`material_types` | 仕様text, token\_ids |

ライフサイクル: `synchronous_json`

各ベクトルのインデックスと次元数を保存してください。

モデル名がマルチモーダルであることを示していても、この正確なパスでは画像オブジェクトは受け付けられません。

### 料金

料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。

高速モード

標準料金 高速モードが選択されている場合

Flex モード

標準料金 flex モードが選択されている場合

最大推論量

標準料金 推論量が最大で、調整に既定値（default）を使用する場合

#### Ailootの料金

#### 設定別の価格

| 設定 | 料金表 | 料金 |
| --- | --- | --- |
| 設定トークンの基本単価 | 料金表基本料金 | 料金 入力 · 入力トークン **$0.0003** / 1K トークン 出力 · 出力トークン **$0** / 1K トークン 入力 · キャッシュ読み取り **—** / 1K トークン 入力 · キャッシュ書き込み **—** / 1K トークン 入力 · キャッシュ書き込み、1時間 **—** / 1K トークン |

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。[金額の確保と精算の仕組み →](https://ailoot.ai/docs/ja/billing/reserve/)

### リクエスト例

#### Ailoot Ultra · 埋め込み

curlPython SDK

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "mistralai/codestral-embed-2505", "input": ["First document", "Second document"]}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
```

```python
from openai import OpenAI
import os

client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='mistralai/codestral-embed-2505',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
```

### 結果を受け取って保存

#### Ailoot Ultra · 埋め込み

json

##### 完了した結果をすべて保存

返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。

すべてのベクトルを、そのインデックスとともに保存してください。ベクトル数は入力数と一致し、次元数は統一されている必要があります。

##### 元のレスポンスを確認する場合

埋め込みジョブ用のエンドポイントは新設されません。

レスポンスのフィールド

| フィールド | 種類 |
| --- | --- |
| フィールド`object` | 種類string |
| フィールド`model` | 種類string |
| フィールド`data[].index` | 種類integer |
| フィールド`data[].embedding` | 種類finite float\[\] |
| フィールド`usage` | 種類object |

エラーと次の手順

| レスポンス | 条件 | 次の手順 |
| --- | --- | --- |
| レスポンス400 · `invalid_request_error` | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 |

### エイリアス

#### モデルのエイリアス

**Ailoot Ultra** [`mistralai/codestral-embed-2505`](https://ailoot.ai/models/ja/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

#### メソッドパスのエイリアス

上記に表示されたメソッドパスを使用してください。

#### 関連する呼び出し用ID

[`mistralai/codestral-embed-2505`](https://ailoot.ai/models/ja/#m=mistralai%2Fcodestral-embed-2505&route=Ultra&caller=mistralai%2Fcodestral-embed-2505&fmt=embeddings)

FAQ · Mistral: Codestral Embed 2505

利用できる入力と結果は何ですか？

`POST /v1/embeddings` · `mistralai/codestral-embed-2505`: `text`, `token_ids` → `embedding`

リクエストはどの項目を使用しますか？

`POST /v1/embeddings` · `mistralai/codestral-embed-2505`: `model`, `input`, `encoding_format`, `provider`

どの制限が適用されますか？

`POST /v1/embeddings` · `mistralai/codestral-embed-2505`: `ctx`: `8192`; `input.budget.maximum`: `8192` (UTF8 バイト); `input.min_items`: `1`

AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。

## 企業とそのプロジェクト群

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

## トークンを割引価格で購入。

継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。

サブスクリプション

定期的なリクエストに合う割引プランを選びましょう。

最大50%のプロモコード

購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。

支出を履歴で確認

各リクエストのモデル、トークン、金額が保存されます。

[サブスクリプションを選ぶ](https://ailoot.ai/docs/ja/billing/subscriptions/) · [モデルの価格を見る](https://ailoot.ai/models/ja/)

## 販売する製品に、 APIを組み込みましょう。

SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。

商用アプリ

サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。

リセラーライセンス

プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。

サイトで契約文書を確認

接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

[リセラーライセンスを申請](mailto:support@ailoot.ai) · [サービス提供条件とライセンス契約](https://ailoot.ai/legal/offer?lang=ja)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。