Source: https://ailoot.ai/docs/vi/api/responses/ Canonical: https://ailoot.ai/docs/vi/api/responses/ Language: vi [API](https://ailoot.ai/docs/vi/) # Responses [Markdown](https://ailoot.ai/docs/vi/api/responses/index.md) Định dạng mới của OpenAI: một đầu vào, đầu ra có kiểu dữ liệu, công cụ và suy luận. Codex CLI sử dụng định dạng này. POST`https://api.ailoot.ai/v1/responses` Responses ```bash curl https://api.ailoot.ai/v1/responses \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.1-sol", "instructions": "Trả lời ngắn gọn.", "input": "TCP khác UDP ở điểm nào?" }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]) resp = client.responses.create( model="gpt-6.1-sol", instructions="Trả lời ngắn gọn.", input="TCP khác UDP ở điểm nào?", ) print(resp.output_text) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY }); const resp = await client.responses.create({ model: "gpt-6.1-sol", instructions: "Trả lời ngắn gọn.", input: "TCP khác UDP ở điểm nào?", }); console.log(resp.output_text); ``` 200 OK ```json { "id": "resp_67f1…", "object": "response", "status": "completed", "model": "gpt-6.1-sol", "output": [ { "type": "message", "role": "assistant", "content": [ { "type": "output_text", "text": "TCP bảo đảm việc truyền dữ liệu và thứ tự, còn UDP thì không, nhưng nhanh hơn…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## Xác thực | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `Authorization` | header | bắt buộc | Khóa có dạng `Bearer sk-…`. Cũng có thể dùng các header `x-api-key` hoặc `x-goog-api-key`. | ## Phần thân yêu cầu | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `model` | string | bắt buộc | ID mô hình hỗ trợ định dạng Responses. Danh mục có 53 mô hình như vậy: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Các mô hình Gemini không khả dụng ở định dạng này. | | `input` | string \| array | bắt buộc | Văn bản yêu cầu hoặc mảng tin nhắn và các phần (văn bản, hình ảnh). | | `instructions` | string | không bắt buộc | Chỉ dẫn hệ thống. | | `stream` | boolean | không bắt buộc | Luồng sự kiện SSE; sự kiện cuối cùng là `response.completed`. Văn bản tính phí được gửi thành một khối sau khi tính chi phí. | | `max_output_tokens` | integer | không bắt buộc | Số token tối đa của phản hồi, bao gồm suy luận. Nếu không chỉ định, Ailoot đặt 4096 (hoặc thấp hơn nếu giới hạn phản hồi của mô hình thấp hơn). Với phản hồi dài, hãy chỉ định giới hạn rõ ràng. Các yêu cầu có `previous_response_id` và các yêu cầu dùng công cụ tích hợp `web_search` hoặc `code_interpreter` với yêu cầu văn bản mới sẽ xét riêng các ước tính cho ngữ cảnh đã lưu và hoạt động của công cụ, thay vì tự động chuyển sang chi phí của toàn bộ cửa sổ đầu vào. Các khoản tạm giữ đã được chấp thuận trước đây giữ nguyên điều kiện ban đầu. Với đầu ra hình ảnh, video và âm thanh, toàn bộ chi phí của kết quả được tạm giữ. Nếu khoản tạm giữ đã tính vượt quá số dư khả dụng hoặc hạn mức của khóa, với mô hình và phương thức được hỗ trợ, Ailoot có thể giảm `max_tokens` (`max_output_tokens` trong Responses) đến mức có thể thanh toán, nhưng không thấp hơn 256 token hoặc mức tối thiểu cao hơn của phương thức đó, và thông báo qua tiêu đề `X-Ailoot-Max-Tokens-Capped`. Khả năng giảm giới hạn được kiểm tra cho mô hình văn bản cụ thể và phương thức. Cơ chế này áp dụng cho các tuyến văn bản Gemini được hỗ trợ ở định dạng Gemini gốc và định dạng Anthropic Messages; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — ở các định dạng Chat Completions và Messages (nếu mô hình hỗ trợ các định dạng đó). **Đầu ra** được ước tính theo độ dài câu trả lời thông thường và các điều kiện đã chấp thuận để tính khoản tạm giữ cho một yêu cầu văn bản mới. Giới hạn yêu cầu được đặt qua `max_tokens` (`max_output_tokens` trong Responses). Giới hạn yêu cầu không tự động bằng số token dùng để tính khoản tạm giữ, và không bảo đảm độ dài câu trả lời thực tế của mô hình không có cơ chế giới hạn đáng tin cậy. Giá trị ban đầu 4096 chỉ áp dụng cho các tuyến tương ứng; quy tắc cụ thể phụ thuộc vào mô hình và phương thức. | | `reasoning` | object | không bắt buộc | `{"effort": "low" \| "medium" \| "high"}` dành cho các mô hình suy luận. | | `tools` | array | không bắt buộc | Các hàm mà mô hình có thể gọi. | | `text` | object | không bắt buộc | Định dạng phản hồi, ví dụ `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | không bắt buộc | Mức độ ngẫu nhiên của phản hồi, nếu mô hình hỗ trợ. | ## Phản hồi | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `output` | array | | Các phần tử phản hồi: tin nhắn (`message`), suy luận, lời gọi hàm. Trong SDK, cách lấy tiện lợi là `output_text`. | | `status` | string | | `completed`, `incomplete` (đã chạm giới hạn) hoặc `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai) ## Ailoot · Công ty và danh mục dự án của công ty Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục. Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng. Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.