Codestral 2508 là mô hình lập trình của Mistral AI dành cho các tác vụ hoàn thiện và tạo mã thường xuyên, nhạy với độ trễ. Mô hình nhận mã nguồn và yêu cầu bằng văn bản, rồi trả về văn bản có thể chứa phần triển khai, đoạn hoàn thiện, bản sửa hoặc lời giải thích. Phiên bản 2508 được nêu tập trung vào ngữ cảnh chỉnh sửa hiện tại của lập trình viên, thay vì tự nó là mô hình embedding hay tác nhân hoàn chỉnh cho kho mã.
Hoàn thiện mã và bản cập nhật 2508
Nhà sản xuất định vị Codestral cho hoàn thiện bằng cách điền phần giữa và chỉnh sửa nhiều dòng. Bản phát hành mô tả cải tiến hành vi hoàn thiện, bao gồm giảm tình trạng sinh mã kéo dài ngoài ý muốn, cùng cải tiến khả năng làm theo chỉ dẫn và tác vụ mã trong chế độ hội thoại. Đây là những thay đổi của phiên bản Codestral này; khả năng truy xuất và tác nhân tự động của bộ công cụ lập trình bao quanh thuộc về các thành phần được đặt tên riêng.
Với tác vụ hoàn thiện, hãy giữ chữ ký hàm, khai báo và ngữ cảnh lời gọi liên quan cùng vị trí con trỏ. Xác định kết quả mong muốn chỉ là đoạn mã còn thiếu hay cả hàm đã chỉnh sửa. Một yêu cầu kiểu trình soạn thảo có thể đề nghị phần thân vòng lặp giữ kiểu trả về hiện có, giữ các giá trị trùng lặp và không thay đổi đầu vào của bên gọi. Khi đó, kết quả có vị trí chèn cụ thể và hành vi được xác định.
Chuẩn bị tác vụ điền phần giữa
Trong giao diện FIM của nhà sản xuất, prompt cung cấp văn bản hoặc mã cần hoàn thiện, còn suffix tùy chọn cung cấp phần sau khoảng trống. Khi có cả hai, mô hình điền phần nằm giữa chúng. Khi không có suffix, mô hình tiếp tục từ prompt. Điều này khác với yêu cầu hội thoại thông thường đề nghị thay đổi mã và giải thích; mỗi cách chuẩn bị xác định một hợp đồng đầu ra khác nhau.
Đầu vào hữu ích cho điền khoảng trống gồm phần đầu hàm, đoạn mã phải xuất hiện sau phần chèn và các định nghĩa kiểu hoặc hàm hỗ trợ liên quan. Giữ thụt lề và dấu phân cách để văn bản được trả về có thể khớp với đoạn hiện có. Nếu tác vụ chỉ cần phần thân còn thiếu, hãy yêu cầu đúng phần thân đó thay vì viết lại toàn bộ tệp. Một câu hỏi hội thoại riêng có thể giải thích vì sao đoạn hoàn thiện đáp ứng yêu cầu.
Tài liệu FIM chính thức cho phép đặt ngân sách token đầu ra và yêu cầu prompt cộng ngân sách đó nằm trong ngữ cảnh của mô hình. Tài liệu cũng mô tả chuỗi dừng và truyền nội dung được tạo theo luồng. Chọn quy trình hoàn thiện khi kết quả phải khớp khoảng trống trong mã, và quy trình hội thoại khi tác vụ yêu cầu mã đi kèm giải thích.
Ngữ cảnh và các tính năng hỗ trợ
Trang mô hình nêu cửa sổ ngữ cảnh 128k. Dùng ngữ cảnh để giữ mã nguồn và khai báo quyết định thay đổi dự định, đồng thời nêu rõ tác vụ chỉnh sửa thực tế. Với yêu cầu sửa lỗi, hãy cung cấp hàm bị ảnh hưởng, đầu vào cụ thể gây lỗi, kết quả mong đợi và lỗi hoặc hành vi quan sát được. Yêu cầu bản sửa đề xuất tách biệt với lời giải thích và ví dụ.
Trang cũng liệt kê đầu ra có cấu trúc, gọi hàm, đầu ra dự đoán, hỏi đáp tài liệu, tiền tố câu trả lời và xử lý theo lô bên cạnh khả năng hội thoại và FIM. Với kết quả đánh giá mã có cấu trúc, hãy xác định các trường như ký hiệu bị ảnh hưởng, điểm sai lệch quan sát được, thay đổi đề xuất và giả định còn cần làm rõ. Hướng dẫn đầu ra có cấu trúc của Mistral phân biệt chế độ JSON với lược đồ tùy chỉnh, trong đó định dạng JSON mong muốn được nêu trong prompt.
Đầu ra dự đoán dành cho nội dung mà phần đáng kể của câu trả lời đã được biết trước. Có thể dùng tính năng này khi tạo lại tài liệu hoặc tệp mã với chỉnh sửa giới hạn, đồng thời giữ phần nội dung còn lại. Hãy chỉ rõ thay đổi chính xác và tài liệu phải giữ nguyên. Ngược lại, tiền tố câu trả lời cung cấp phần mở đầu đã biết để quá trình sinh tiếp tục từ đó; nó khác cả phần thân hoàn chỉnh đã biết lẫn suffix của FIM.
Câu hỏi về tài liệu có thể dùng quy trình xử lý tài liệu của nhà sản xuất để chuẩn bị văn bản và cấu trúc bằng OCR trước khi phân tích bằng mô hình ngôn ngữ. Với tài liệu lập trình đã có ở dạng văn bản, hãy cung cấp các đoạn liên quan và hỏi điều kiện nào chi phối việc triển khai. Giữ mỗi yêu cầu được trích xuất gắn với phần nguồn của nó để mã hoặc lời giải thích được tạo vẫn liên hệ với đặc tả đã cung cấp.
Công cụ và kết quả thực tế
Gọi hàm cho phép ứng dụng cung cấp các thao tác được mô tả cùng tham số. Mô hình chuẩn bị lời gọi, ứng dụng thực thi và kết quả trả về trở thành ngữ cảnh cho câu trả lời tiếp theo. Trợ lý mã có thể nhận kết quả tra cứu hoặc tính toán qua chu trình đó, nhưng biên dịch, kiểm thử hay áp dụng thay đổi đề xuất vẫn cần môi trường phát triển bao quanh.
Với bản sửa thực tế, hãy xác định giao diện công khai phải giữ tương thích và yêu cầu đoạn mã đã sửa, giải thích súc tích cùng đầu vào mẫu và đầu ra mong đợi. Với hàm được tạo, hãy nêu các kiểu dữ liệu được chấp nhận và điều kiện biên. Với phần giải thích, hãy cung cấp đầu vào cần lần theo để câu trả lời liên hệ đường thực thi cụ thể với giá trị được trả về.
Codestral tạo văn bản. Mô hình không thừa hưởng vector tìm kiếm mã từ Codestral Embed, tự động hóa kho mã từ Devstral hay tạo ảnh từ mô hình thị giác. Trang chính xác của mô hình 2508 không công bố số tham số hoặc độ dài câu trả lời tối đa độc lập có thể mượn từ bản phát hành khác. Giữ đúng phiên bản được nêu, ngữ cảnh lập trình và sản phẩm cần có khi chuẩn bị quy trình trình soạn thảo hoặc hội thoại có thể lặp lại.
", "aboutText": "Codestral 2508 là mô hình lập trình của Mistral AI dành cho các tác vụ hoàn thiện và tạo mã thường xuyên, nhạy với độ trễ. Mô hình nhận mã nguồn và yêu cầu bằng văn bản, rồi trả về văn bản có thể chứa phần triển khai, đoạn hoàn thiện, bản sửa hoặc lời giải thích. Phiên bản 2508 được nêu tập trung vào ngữ cảnh chỉnh sửa hiện tại của lập trình viên, thay vì tự nó là mô hình embedding hay tác nhân hoàn chỉnh cho kho mã.\n\nHoàn thiện mã và bản cập nhật 2508\n\nNhà sản xuất định vị Codestral cho hoàn thiện bằng cách điền phần giữa và chỉnh sửa nhiều dòng. Bản phát hành mô tả cải tiến hành vi hoàn thiện, bao gồm giảm tình trạng sinh mã kéo dài ngoài ý muốn, cùng cải tiến khả năng làm theo chỉ dẫn và tác vụ mã trong chế độ hội thoại. Đây là những thay đổi của phiên bản Codestral này; khả năng truy xuất và tác nhân tự động của bộ công cụ lập trình bao quanh thuộc về các thành phần được đặt tên riêng.\n\nVới tác vụ hoàn thiện, hãy giữ chữ ký hàm, khai báo và ngữ cảnh lời gọi liên quan cùng vị trí con trỏ. Xác định kết quả mong muốn chỉ là đoạn mã còn thiếu hay cả hàm đã chỉnh sửa. Một yêu cầu kiểu trình soạn thảo có thể đề nghị phần thân vòng lặp giữ kiểu trả về hiện có, giữ các giá trị trùng lặp và không thay đổi đầu vào của bên gọi. Khi đó, kết quả có vị trí chèn cụ thể và hành vi được xác định.\n\nChuẩn bị tác vụ điền phần giữa\n\nTrong giao diện FIM của nhà sản xuất, prompt cung cấp văn bản hoặc mã cần hoàn thiện, còn suffix tùy chọn cung cấp phần sau khoảng trống. Khi có cả hai, mô hình điền phần nằm giữa chúng. Khi không có suffix, mô hình tiếp tục từ prompt. Điều này khác với yêu cầu hội thoại thông thường đề nghị thay đổi mã và giải thích; mỗi cách chuẩn bị xác định một hợp đồng đầu ra khác nhau.\n\nĐầu vào hữu ích cho điền khoảng trống gồm phần đầu hàm, đoạn mã phải xuất hiện sau phần chèn và các định nghĩa kiểu hoặc hàm hỗ trợ liên quan. Giữ thụt lề và dấu phân cách để văn bản được trả về có thể khớp với đoạn hiện có. Nếu tác vụ chỉ cần phần thân còn thiếu, hãy yêu cầu đúng phần thân đó thay vì viết lại toàn bộ tệp. Một câu hỏi hội thoại riêng có thể giải thích vì sao đoạn hoàn thiện đáp ứng yêu cầu.\n\nTài liệu FIM chính thức cho phép đặt ngân sách token đầu ra và yêu cầu prompt cộng ngân sách đó nằm trong ngữ cảnh của mô hình. Tài liệu cũng mô tả chuỗi dừng và truyền nội dung được tạo theo luồng. Chọn quy trình hoàn thiện khi kết quả phải khớp khoảng trống trong mã, và quy trình hội thoại khi tác vụ yêu cầu mã đi kèm giải thích.\n\nNgữ cảnh và các tính năng hỗ trợ\n\nTrang mô hình nêu cửa sổ ngữ cảnh 128k. Dùng ngữ cảnh để giữ mã nguồn và khai báo quyết định thay đổi dự định, đồng thời nêu rõ tác vụ chỉnh sửa thực tế. Với yêu cầu sửa lỗi, hãy cung cấp hàm bị ảnh hưởng, đầu vào cụ thể gây lỗi, kết quả mong đợi và lỗi hoặc hành vi quan sát được. Yêu cầu bản sửa đề xuất tách biệt với lời giải thích và ví dụ.\n\nTrang cũng liệt kê đầu ra có cấu trúc, gọi hàm, đầu ra dự đoán, hỏi đáp tài liệu, tiền tố câu trả lời và xử lý theo lô bên cạnh khả năng hội thoại và FIM. Với kết quả đánh giá mã có cấu trúc, hãy xác định các trường như ký hiệu bị ảnh hưởng, điểm sai lệch quan sát được, thay đổi đề xuất và giả định còn cần làm rõ. Hướng dẫn đầu ra có cấu trúc của Mistral phân biệt chế độ JSON với lược đồ tùy chỉnh, trong đó định dạng JSON mong muốn được nêu trong prompt.\n\nĐầu ra dự đoán dành cho nội dung mà phần đáng kể của câu trả lời đã được biết trước. Có thể dùng tính năng này khi tạo lại tài liệu hoặc tệp mã với chỉnh sửa giới hạn, đồng thời giữ phần nội dung còn lại. Hãy chỉ rõ thay đổi chính xác và tài liệu phải giữ nguyên. Ngược lại, tiền tố câu trả lời cung cấp phần mở đầu đã biết để quá trình sinh tiếp tục từ đó; nó khác cả phần thân hoàn chỉnh đã biết lẫn suffix của FIM.\n\nCâu hỏi về tài liệu có thể dùng quy trình xử lý tài liệu của nhà sản xuất để chuẩn bị văn bản và cấu trúc bằng OCR trước khi phân tích bằng mô hình ngôn ngữ. Với tài liệu lập trình đã có ở dạng văn bản, hãy cung cấp các đoạn liên quan và hỏi điều kiện nào chi phối việc triển khai. Giữ mỗi yêu cầu được trích xuất gắn với phần nguồn của nó để mã hoặc lời giải thích được tạo vẫn liên hệ với đặc tả đã cung cấp.\n\nCông cụ và kết quả thực tế\n\nGọi hàm cho phép ứng dụng cung cấp các thao tác được mô tả cùng tham số. Mô hình chuẩn bị lời gọi, ứng dụng thực thi và kết quả trả về trở thành ngữ cảnh cho câu trả lời tiếp theo. Trợ lý mã có thể nhận kết quả tra cứu hoặc tính toán qua chu trình đó, nhưng biên dịch, kiểm thử hay áp dụng thay đổi đề xuất vẫn cần môi trường phát triển bao quanh.\n\nVới bản sửa thực tế, hãy xác định giao diện công khai phải giữ tương thích và yêu cầu đoạn mã đã sửa, giải thích súc tích cùng đầu vào mẫu và đầu ra mong đợi. Với hàm được tạo, hãy nêu các kiểu dữ liệu được chấp nhận và điều kiện biên. Với phần giải thích, hãy cung cấp đầu vào cần lần theo để câu trả lời liên hệ đường thực thi cụ thể với giá trị được trả về.\n\nCodestral tạo văn bản. Mô hình không thừa hưởng vector tìm kiếm mã từ Codestral Embed, tự động hóa kho mã từ Devstral hay tạo ảnh từ mô hình thị giác. Trang chính xác của mô hình 2508 không công bố số tham số hoặc độ dài câu trả lời tối đa độc lập có thể mượn từ bản phát hành khác. Giữ đúng phiên bản được nêu, ngữ cảnh lập trình và sản phẩm cần có khi chuẩn bị quy trình trình soạn thảo hoặc hội thoại có thể lặp lại.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a808ab2960c306224a94d3e03bc5d11faff39534a3eca7dbeec7704e5615ff3d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "vi", "methods": [ { "html": "mistralai/codestral-2508:batchCodestral 2508 là mô hình văn bản của Mistral AI dành cho tạo mã và hoàn thiện mã theo ngữ cảnh. Mô hình được tối ưu cho các tác vụ thường xuyên trong trình soạn thảo, bao gồm điền phần giữa và chỉnh sửa nhiều dòng, với ngữ cảnh 128k do nhà sản xuất công bố cùng các tính năng hội thoại, đầu ra có cấu trúc và công cụ được mô tả trong tài liệu.
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Codestral 2508 là mô hình lập trình của Mistral AI dành cho các tác vụ hoàn thiện và tạo mã thường xuyên, nhạy với độ trễ. Mô hình nhận mã nguồn và yêu cầu bằng văn bản, rồi trả về văn bản có thể chứa phần triển khai, đoạn hoàn thiện, bản sửa hoặc lời giải thích. Phiên bản 2508 được nêu tập trung vào ngữ cảnh chỉnh sửa hiện tại của lập trình viên, thay vì tự nó là mô hình embedding hay tác nhân hoàn chỉnh cho kho mã.
Hoàn thiện mã và bản cập nhật 2508
Nhà sản xuất định vị Codestral cho hoàn thiện bằng cách điền phần giữa và chỉnh sửa nhiều dòng. Bản phát hành mô tả cải tiến hành vi hoàn thiện, bao gồm giảm tình trạng sinh mã kéo dài ngoài ý muốn, cùng cải tiến khả năng làm theo chỉ dẫn và tác vụ mã trong chế độ hội thoại. Đây là những thay đổi của phiên bản Codestral này; khả năng truy xuất và tác nhân tự động của bộ công cụ lập trình bao quanh thuộc về các thành phần được đặt tên riêng.
Với tác vụ hoàn thiện, hãy giữ chữ ký hàm, khai báo và ngữ cảnh lời gọi liên quan cùng vị trí con trỏ. Xác định kết quả mong muốn chỉ là đoạn mã còn thiếu hay cả hàm đã chỉnh sửa. Một yêu cầu kiểu trình soạn thảo có thể đề nghị phần thân vòng lặp giữ kiểu trả về hiện có, giữ các giá trị trùng lặp và không thay đổi đầu vào của bên gọi. Khi đó, kết quả có vị trí chèn cụ thể và hành vi được xác định.
Chuẩn bị tác vụ điền phần giữa
Trong giao diện FIM của nhà sản xuất, prompt cung cấp văn bản hoặc mã cần hoàn thiện, còn suffix tùy chọn cung cấp phần sau khoảng trống. Khi có cả hai, mô hình điền phần nằm giữa chúng. Khi không có suffix, mô hình tiếp tục từ prompt. Điều này khác với yêu cầu hội thoại thông thường đề nghị thay đổi mã và giải thích; mỗi cách chuẩn bị xác định một hợp đồng đầu ra khác nhau.
Đầu vào hữu ích cho điền khoảng trống gồm phần đầu hàm, đoạn mã phải xuất hiện sau phần chèn và các định nghĩa kiểu hoặc hàm hỗ trợ liên quan. Giữ thụt lề và dấu phân cách để văn bản được trả về có thể khớp với đoạn hiện có. Nếu tác vụ chỉ cần phần thân còn thiếu, hãy yêu cầu đúng phần thân đó thay vì viết lại toàn bộ tệp. Một câu hỏi hội thoại riêng có thể giải thích vì sao đoạn hoàn thiện đáp ứng yêu cầu.
Tài liệu FIM chính thức cho phép đặt ngân sách token đầu ra và yêu cầu prompt cộng ngân sách đó nằm trong ngữ cảnh của mô hình. Tài liệu cũng mô tả chuỗi dừng và truyền nội dung được tạo theo luồng. Chọn quy trình hoàn thiện khi kết quả phải khớp khoảng trống trong mã, và quy trình hội thoại khi tác vụ yêu cầu mã đi kèm giải thích.
Ngữ cảnh và các tính năng hỗ trợ
Trang mô hình nêu cửa sổ ngữ cảnh 128k. Dùng ngữ cảnh để giữ mã nguồn và khai báo quyết định thay đổi dự định, đồng thời nêu rõ tác vụ chỉnh sửa thực tế. Với yêu cầu sửa lỗi, hãy cung cấp hàm bị ảnh hưởng, đầu vào cụ thể gây lỗi, kết quả mong đợi và lỗi hoặc hành vi quan sát được. Yêu cầu bản sửa đề xuất tách biệt với lời giải thích và ví dụ.
Trang cũng liệt kê đầu ra có cấu trúc, gọi hàm, đầu ra dự đoán, hỏi đáp tài liệu, tiền tố câu trả lời và xử lý theo lô bên cạnh khả năng hội thoại và FIM. Với kết quả đánh giá mã có cấu trúc, hãy xác định các trường như ký hiệu bị ảnh hưởng, điểm sai lệch quan sát được, thay đổi đề xuất và giả định còn cần làm rõ. Hướng dẫn đầu ra có cấu trúc của Mistral phân biệt chế độ JSON với lược đồ tùy chỉnh, trong đó định dạng JSON mong muốn được nêu trong prompt.
Đầu ra dự đoán dành cho nội dung mà phần đáng kể của câu trả lời đã được biết trước. Có thể dùng tính năng này khi tạo lại tài liệu hoặc tệp mã với chỉnh sửa giới hạn, đồng thời giữ phần nội dung còn lại. Hãy chỉ rõ thay đổi chính xác và tài liệu phải giữ nguyên. Ngược lại, tiền tố câu trả lời cung cấp phần mở đầu đã biết để quá trình sinh tiếp tục từ đó; nó khác cả phần thân hoàn chỉnh đã biết lẫn suffix của FIM.
Câu hỏi về tài liệu có thể dùng quy trình xử lý tài liệu của nhà sản xuất để chuẩn bị văn bản và cấu trúc bằng OCR trước khi phân tích bằng mô hình ngôn ngữ. Với tài liệu lập trình đã có ở dạng văn bản, hãy cung cấp các đoạn liên quan và hỏi điều kiện nào chi phối việc triển khai. Giữ mỗi yêu cầu được trích xuất gắn với phần nguồn của nó để mã hoặc lời giải thích được tạo vẫn liên hệ với đặc tả đã cung cấp.
Công cụ và kết quả thực tế
Gọi hàm cho phép ứng dụng cung cấp các thao tác được mô tả cùng tham số. Mô hình chuẩn bị lời gọi, ứng dụng thực thi và kết quả trả về trở thành ngữ cảnh cho câu trả lời tiếp theo. Trợ lý mã có thể nhận kết quả tra cứu hoặc tính toán qua chu trình đó, nhưng biên dịch, kiểm thử hay áp dụng thay đổi đề xuất vẫn cần môi trường phát triển bao quanh.
Với bản sửa thực tế, hãy xác định giao diện công khai phải giữ tương thích và yêu cầu đoạn mã đã sửa, giải thích súc tích cùng đầu vào mẫu và đầu ra mong đợi. Với hàm được tạo, hãy nêu các kiểu dữ liệu được chấp nhận và điều kiện biên. Với phần giải thích, hãy cung cấp đầu vào cần lần theo để câu trả lời liên hệ đường thực thi cụ thể với giá trị được trả về.
Codestral tạo văn bản. Mô hình không thừa hưởng vector tìm kiếm mã từ Codestral Embed, tự động hóa kho mã từ Devstral hay tạo ảnh từ mô hình thị giác. Trang chính xác của mô hình 2508 không công bố số tham số hoặc độ dài câu trả lời tối đa độc lập có thể mượn từ bản phát hành khác. Giữ đúng phiên bản được nêu, ngữ cảnh lập trình và sản phẩm cần có khi chuẩn bị quy trình trình soạn thảo hoặc hội thoại có thể lặp lại.
POST /v1/batchestexttext| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngendpoint | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn /v1/chat/completions | Mặc định— |
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn mistralai/codestral-2508:batch | Mặc định— |
Trườngrequests | Loạibatch_item[] | Yêu cầuBắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 | Mặc định— |
Trườngrequests[].custom_id | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngrequests[].body.messages | Loạimessage[] | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngcompletion_window | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 24h | Mặc định— |
Trườngprovider | Loạiobject|null | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngrequests[].body.model | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn mistralai/codestral-2508:batch, mistralai/codestral-2508 | Mặc định— |
Trườngprovider.only | Loạistring[] | Yêu cầuKhông bắt buộc | Giá trị & giới hạn mistral | Mặc định— |
Trườngprovider.allow_fallbacks | Loạiboolean|null | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false, null | Mặc định— |
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngendpoint, model, requests |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrepresentation | Hợp đồngrequests[] nội tuyến; mỗi phần tử có custom_id và body |
Tham sốrequest_endpoint_profile | Hợp đồng/v1/chat/completions |
Tham sốfile_material | Hợp đồngBên gọi có thể đọc dữ liệu JSONL UTF-8 thực tế trên máy cục bộ vào requests[]. Không sử dụng mục đích tải lên, input_file_id hay tham chiếu tệp. Nếu thiếu tài liệu của khách hàng hoặc tài liệu rỗng, dừng khâu chuẩn bị trước POST. |
Tham sốserialization_order | Hợp đồngendpoint, model, provider (nếu được cung cấp), completion_window (nếu được cung cấp), requests ở cuối |
Tham sốoptional_controls | Hợp đồngprovider.only, provider.allow_fallbacks, completion_window |
Tham sốschema_scope | Hợp đồngPhần thân yêu cầu Chat Completions dạng văn bản trong cấu trúc Batch nội tuyến được mô tả trong tài liệu. |
Vòng đời: asynchronous
GET /v1/batches/{operation_id} · response.id thực tế từ phản hồi tạo gốc; cùng người dùng/khóa/nhóm
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.0003 / 1K token Đầu ra · Token đầu ra $0.0009 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.00003 / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.0003 / 1K token Đầu ra · Token đầu ra $0.0009 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.00003 / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=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}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n 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")\n return {"endpoint":"/v1/chat/completions", "model":"mistralai/codestral-2508:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n 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")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nJSON nội tuyến tại results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nLưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Giữ lại toàn bộ JSON trạng thái gốc, mọi kết quả/custom_id và toàn bộ phần thân phản hồi hoặc lỗi. Lưu results[] đã hoàn tất dưới dạng JSONL mà không lọc.
Giữ nguyên ID thao tác gốc. Phản hồi 503 result_pending_check có X-Should-Retry:false; tuyệt đối không gửi lại lô gốc có trạng thái chưa xác định.
| Trường | Loại |
|---|---|
Trườngresults[].custom_id | Loạistring |
Trườngresults[].response.body.choices[].message.content | Loạistring|null |
Trườngresults[].error | Loạiobject|null |
Trườngusage | Loạiobject|null |
Trườngid | Loạistring |
Trườngmodel | Loạistring |
Trườngendpoint | Loạistring |
Trườngstatus | Loạistring |
Trườngrequest_counts | Loạiobject |
Trườngresults[].id | Loạistring |
Trườngresults[].response.status_code | Loạiinteger |
Trườngresults[].response.request_id | Loạistring |
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnCấu trúc nội tuyến không đúng tài liệu, có khóa trùng, định danh phần tử không hợp lệ hoặc xung đột với khả năng đã cấu hình của mô hình. | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi bất kỳ yêu cầu mới nào. |
Phản hồi401 · authentication_error | Điều kiệnKhóa API không hợp lệ. | Bước tiếp theoSử dụng khóa Ailoot đã được cấp quyền. |
Phản hồi403 · permission_error | Điều kiệnNhóm xử lý hàng loạt không khả dụng. | Bước tiếp theoKiểm tra quyền sử dụng của khóa/nhóm. |
Phản hồi422 · invalid_request_error | Điều kiệnXử lý hàng loạt tính phí từ số dư; yêu cầu tạo qua gói thuê bao bị từ chối. | Bước tiếp theoSử dụng nhóm đã được cấp quyền và tính phí từ số dư. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể báo giá cho dữ liệu đầu vào của lô. | Bước tiếp theoGiữ lại phản hồi; sử dụng dữ liệu đầu vào của họ API được mô tả trong tài liệu. |
Phản hồi402 · billing_error | Điều kiệnKhoản dự trữ cho xử lý hàng loạt không khả dụng. | Bước tiếp theoKhắc phục vấn đề về điều kiện tiếp nhận trước khi gửi yêu cầu mới. |
Phản hồi503 · price_unavailable | Điều kiệnGiá phương thức xử lý hàng loạt/đơn giá gốc không khả dụng. | Bước tiếp theoGiữ lại phản hồi; không thay thế đơn giá. |
Phản hồi503 · api_error | Điều kiệnTuyến cụ thể tới nhà cung cấp không khả dụng. | Bước tiếp theoGiữ lại phản hồi để sửa tuyến. |
Phản hồi503 · result_pending_check | Điều kiệnKết quả gốc cần được kiểm tra; X-Should-Retry:false. | Bước tiếp theoGiữ lại operation_id/id gốc và truy xuất trạng thái của thao tác đó; tuyệt đối không lặp lại POST gốc. |
Phản hồi404 · not_found | Điều kiệnKhông tìm thấy thao tác kiểm tra trạng thái lô hoặc thao tác thuộc một danh tính khác. | Bước tiếp theoSử dụng đúng id gốc và cùng người dùng/khóa/nhóm. |
Ailoot Ultra mistralai/codestral-2508:batch
Dùng các đường dẫn phương thức hiển thị ở trên.