模型

Mistral: Codestral 2508 (batch)

Markdown · JSON

Mistral: Codestral 2508 (batch)

Codestral 2508 是 Mistral AI 用於程式碼生成及感知上下文補全的文字模型。它針對高頻率編輯器任務最佳化,包括中間填補與多行編輯,具備原廠提供的 128k 上下文,以及文件記載的聊天、結構化輸出與工具功能。

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。

Codestral 2508 是 Mistral AI 的程式開發模型,適用於頻繁且對延遲敏感的補全與生成任務。它接收原始碼與文字需求,回傳可包含實作、補全、修正或說明的文字。具名的 2508 版本聚焦於開發者當下的編輯上下文,本身並非嵌入模型或完整的儲存庫代理。

程式碼補全與 2508 更新

原廠將 Codestral 定位於中間填補補全與多行編輯。本次發布說明補全行為有所改善,包括減少失控的持續生成,也改善聊天模式中的指令遵循與程式碼任務。這些是此 Codestral 版本的變更;周邊程式開發技術堆疊的檢索與自主代理功能,則屬於其他具名元件。

進行補全時,請將相關函式簽章、宣告及呼叫上下文與游標位置一併提供。指出所需結果是僅包含缺少的程式碼,還是完整修訂後的函式。編輯器式請求可以要求產生迴圈本體,保留現有回傳型別、保留重複值,且不修改呼叫端的輸入。如此一來,結果就有具體插入位置與明確行為。

中間填補的準備

在原廠的 FIM 介面中,prompt 提供待補全的文字或程式碼,選用的 suffix 則提供缺口之後的材料。兩者都有提供時,模型會填補兩者之間的空間;沒有 suffix 時,則從 prompt 往下接續。這與要求程式碼變更及說明的一般對話請求不同;每種準備方式都定義了不同的輸出契約。

實用的缺口補全輸入,應包含函式開頭、插入內容之後必須接續的程式碼,以及相關型別或輔助函式定義。請保留縮排與分隔符號,讓回傳文字能嵌入現有片段。若任務只需要缺少的函式本體,就要求該本體,而非重寫整個檔案。另行提出的聊天問題則可以解釋補全片段為何符合需求。

官方 FIM 文件允許設定輸出 token 預算,並要求 prompt 加上該預算仍須位於模型上下文範圍內。文件也記載停止序列與生成內容串流。若結果必須嵌入程式碼缺口,請選擇補全工作流程;若任務要求程式碼及其說明,則選擇對話工作流程。

上下文與支援功能

模型頁面列出 128k 上下文視窗。請利用上下文保留決定預期變更的原始碼與宣告,同時明確指出實際編輯任務。提出錯誤修正請求時,請提供受影響函式、具體失敗輸入、預期結果,以及錯誤或觀察到的行為。將建議修正與其說明及範例分開要求。

頁面也在聊天與 FIM 能力之外,列出結構化輸出、函式呼叫、預測輸出、文件問答、回應前綴與批次處理。對結構化程式碼審查結果,請定義受影響符號、觀察到的不符之處、建議變更,以及仍待釐清假設等欄位。Mistral 的結構化輸出指引區分 JSON 模式與自訂結構描述,並要求在提示詞中說明期望的 JSON 格式。

預測輸出適用於大部分答案內容已知的情況。重新生成僅有少量修改的文件或程式碼檔案,並保留其他內容時,可以使用此功能。請指定確切變更及必須保留的材料。回應前綴則提供已知開頭,讓生成從該處接續;它不同於已知的完整本文,也不同於 FIM suffix。

文件問題可以先使用原廠的文件處理工作流程,透過 OCR 準備文字與結構,再交由語言模型分析。對已經以文字形式提供的程式開發材料,請提供相關文件段落,並詢問哪項條件支配該實作。讓每項擷取需求都對應其來源章節,以便生成的程式碼或說明持續連結到所提供的規格。

工具與實際結果

函式呼叫讓應用程式能提供已描述的操作及其參數。模型準備呼叫,應用程式執行,再將回傳結果作為下一次回答的上下文。程式碼助理可以透過這個循環接收查詢或計算結果,但編譯、測試或套用建議變更,仍需要周邊開發環境。

進行實際修正時,請定義必須維持相容的公開介面,並要求修訂後的片段、精簡說明,以及附有預期輸出的範例輸入。生成函式時,請說明接受的型別與邊界條件。要求說明時,請提供要追蹤的輸入,讓回答能將具體執行路徑與回傳值連結起來。

Codestral 產生文字。它不會繼承 Codestral Embed 的程式碼搜尋向量、Devstral 的儲存庫自動化,或視覺模型的影像生成能力。確切的 2508 模型頁面並未公布參數量,也沒有可從其他版本借用的獨立最大回答長度。準備可重複使用的編輯器或聊天工作流程時,請保留具名版本、程式開發上下文與所需成品。

Ailoot Ultra · 批次處理(Batch) POST /v1/batches mistralai/codestral-2508:batch

mistralai/codestral-2508:batch

Mistral /mistralai/codestral-2508:batch

入門

Codestral 2508 是 Mistral AI 用於程式碼生成及感知上下文補全的文字模型。它針對高頻率編輯器任務最佳化,包括中間填補與多行編輯,具備原廠提供的 128k 上下文,以及文件記載的聊天、結構化輸出與工具功能。

接受的輸入
文字
結果
文字

Ailoot 可用 · 輸入與方法

Ailoot Ultra · 批次處理(Batch) POST /v1/batches
輸入
text
輸出
text
輸出格式
內嵌的 results[].response.body JSON
欄位類型要求值與限制預設值
欄位endpoint類型string要求必填值與限制
/v1/chat/completions
預設值—
欄位model類型string要求必填值與限制
mistralai/codestral-2508:batch
預設值—
欄位requests類型batch_item[]要求必填值與限制
項目數下限: 1
預設值—
欄位requests[].custom_id類型string要求必填值與限制預設值—
欄位requests[].body.messages類型message[]要求必填值與限制預設值—
欄位completion_window類型string要求選填值與限制
24h
預設值—
欄位provider類型object|null要求選填值與限制預設值—
欄位requests[].body.model類型string要求選填值與限制
mistralai/codestral-2508:batch, mistralai/codestral-2508
預設值—
欄位provider.only類型string[]要求選填值與限制
mistral
預設值—
欄位provider.allow_fallbacks類型boolean|null要求選填值與限制
false, null
預設值—
方法參數與生命週期
參數規格
參數content_type規格application/json
參數required規格endpoint, model, requests
參數material_types規格text
參數representation規格內嵌的 requests[];每個項目皆含 custom_id 與 body
參數request_endpoint_profile規格/v1/chat/completions
參數file_material規格呼叫端可在本機將實際的 UTF-8 JSONL 讀入 requests[]。此流程不使用上傳用途、input_file_id 或檔案參照。若缺少客戶素材或素材為空,應在 POST 前停止準備。
參數serialization_order規格endpoint, model, provider(如有提供), completion_window(如有提供), requests 放在最後
參數optional_controls規格provider.only, provider.allow_fallbacks, completion_window
參數schema_scope規格依文件規定的內嵌 Batch 封裝格式提供文字 Chat Completions 請求主體。

生命週期: asynchronous

GET /v1/batches/{operation_id} · 原始建立回應中實際回傳的 response.id;使用相同使用者/金鑰/群組

方案

費率資訊不會增加請求選項。支援的參數列於所選方法中。

快速模式
未指定 選取快速模式時
flex 模式
未指定 選取 flex 模式時
最高推理強度
未指定 最高推理強度採用 default 調整值時
顯式快取計價
未啟用 請求顯式快取時

Ailoot 費率

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定費率表上下文 Token 數大於上下文 Token 數小於或等於費用
設定詞元基本費率費率表基本費率上下文 Token 數大於—上下文 Token 數小於或等於無上限費用
輸入 · 輸入 Token $0.0003 / 1K Token
輸出 · 輸出 Token $0.0009 / 1K Token
輸入 · 讀取快取 $0.00003 / 1K Token
輸入 · 寫入快取 — / 1K Token
輸入 · 寫入快取,1 小時 — / 1K Token
設定請求長度級距 1費率表—上下文 Token 數大於0上下文 Token 數小於或等於無上限費用
輸入 · 輸入 Token $0.0003 / 1K Token
輸出 · 輸出 Token $0.0009 / 1K Token
輸入 · 讀取快取 $0.00003 / 1K Token
輸入 · 寫入快取 — / 1K Token
輸入 · 寫入快取,1 小時 — / 1K Token

Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot Ultra · 批次處理(Batch)

curl · 保留的測試資料Python HTTP · 客戶實際的 JSONLPython · 儲存每個已完成的結果
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"mistralai/codestral-2508:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['mistralai/codestral-2508:batch', 'mistralai/codestral-2508']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"mistralai/codestral-2508:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

接收並儲存結果

Ailoot Ultra · 批次處理(Batch)

內嵌的 results[].response.body JSON

  • GET /v1/batches/{operation_id}
查看工作狀態
curl · 原始作業狀態
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
保留所有已完成的結果

請保留所有完整傳回的回應、檔案與內容區塊。

保留完整的原始狀態 JSON、每個結果/custom_id,以及完整的回應或錯誤主體。將已完成的 results[] 儲存為 JSONL,不得篩除任何項目。

需要檢查原始回應時

保留原始作業 ID。503 result_pending_check 回應帶有 X-Should-Retry:false;請勿重新提交狀態不明的原始批次。

回應欄位
欄位類型
欄位results[].custom_id類型string
欄位results[].response.body.choices[].message.content類型string|null
欄位results[].error類型object|null
欄位usage類型object|null
欄位id類型string
欄位model類型string
欄位endpoint類型string
欄位status類型string
欄位request_counts類型object
欄位results[].id類型string
欄位results[].response.status_code類型integer
欄位results[].response.request_id類型string
錯誤與後續步驟
回應條件下一步
回應400 · invalid_request_error條件文件規定的內嵌封裝格式無效、索引鍵重複、項目識別有誤,或與已設定的模型能力衝突。下一步再次提交前,請先修正指出的欄位。
回應401 · authentication_error條件API 金鑰無效。下一步使用已獲授權的 Ailoot 金鑰。
回應403 · permission_error條件批次處理群組無法使用。下一步檢查金鑰/群組的使用權限。
回應422 · invalid_request_error條件批次處理採用餘額計費;透過訂閱建立批次的請求會遭拒絕。下一步使用已獲授權、以餘額計費的群組。
回應422 · price_unavailable條件無法為批次輸入估價。下一步保留回應;使用文件規定的該 API 家族輸入格式。
回應402 · billing_error條件批次處理的預留額度無法取得。下一步提交新請求前,請先解決請求受理問題。
回應503 · price_unavailable條件批次處理方法的價格/原生費率無法取得。下一步保留回應;請勿替換價格。
回應503 · api_error條件指定的供應商路由無法使用。下一步保留回應,以供修復路由。
回應503 · result_pending_check條件原始結果需要檢查;X-Should-Retry:false。下一步保留原始 operation_id/id 並讀取其狀態;請勿重複原始 POST。
回應404 · not_found條件查詢批次狀態所需的作業不存在,或屬於其他身分。下一步使用完全相同的原始 id,以及相同的使用者/金鑰/群組。

別名

模型別名

Ailoot Ultra mistralai/codestral-2508:batch

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 ID

mistralai/codestral-2508:batch

FAQ · Mistral: Codestral 2508 (batch)
可以使用哪些輸入與結果?

POST /v1/batches · mistralai/codestral-2508:batch: text → text

請求使用哪些欄位?

POST /v1/batches · mistralai/codestral-2508:batch: endpoint, model, requests, completion_window, provider

適用哪些限制?

POST /v1/batches · mistralai/codestral-2508:batch: requests.min_items: 1

更多詳情

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

公司及其專案組合

公司及其專案組合:數百萬客戶,每月銷售額達數十億。

優惠購買 token。

訂閱優惠適合持續工作,折扣碼購買 token 最高可折 50%。

訂閱
為定期請求選擇優惠方案。
最高 50% 折扣碼
購買時輸入代碼,價格依活動重算。
歷史中的費用
每次請求保存模型、token 與金額。

選擇訂閱 · 查看模型價格

將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人;轉售請申請經銷授權。

商用應用程式
在付費功能加入文字、圖片、影片與聲音生成。
經銷授權
提供專案說明與存取方式,要求書面使用和轉售條件。
網站文件
串接前可閱讀正式服務條款、授權合約與資料處理政策。

申請經銷授權 · 正式服務條款與授權合約