Gọi GetAPI.ONE từ Python
Cài SDK Python OpenAI chính thức, trỏ đến URL cơ sở ONE, thực hiện yêu cầu Responses có kiểm soát và xác minh kết quả mà không đưa thông tin xác thực vào mã nguồn.
Chuẩn bị dự án và thông tin xác thực
- Python 3.10 trở lên và môi trường ảo.
- Khóa API GetAPI.ONE đang bật với thời hạn và hạn mức được đặt chủ động.
- Mã mô hình sao chép từ danh mục hiện tại có điểm cuối được công bố là Responses.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openaiCấu hình và gửi yêu cầu
- Đặt GETAPI_ONE_API_KEY trong môi trường tiến trình; không dán khóa vào tệp.
- Tạo ứng dụng khách với https://www.getapi.one/v1 làm base_url.
- Thay giá trị mô hình giữ chỗ nổi bật bằng đúng mã hiện tại trong danh mục có công bố Responses.
- Chỉ chạy tập lệnh khi bạn chấp nhận yêu cầu có thể bị tính phí.
- Lần xác minh đầu tiên tắt thử lại của SDK. Chỉ thêm thử lại có giới hạn và có thể quan sát sau khi xác định thao tác nào an toàn để lặp.
import os
from openai import OpenAI
api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")
with OpenAI(
api_key=api_key,
base_url="https://www.getapi.one/v1",
timeout=30.0,
max_retries=0,
) as client:
response = client.responses.create(
model="<MODEL_ID_FROM_CURRENT_CATALOG>",
input="Reply with one short readiness check.",
)
print(response.output_text)Hiểu đặc tả
| Trường | Giá trị bắt buộc |
|---|---|
| base_url | https://www.getapi.one/v1 |
| api_key | GETAPI_ONE_API_KEY từ môi trường máy chủ |
| model | Mã chính xác từ danh mục hiện tại |
| method | client.responses.create |
Xác minh kết quả mong đợi
- Tiến trình kết thúc mà không có lỗi xác thực hoặc điểm cuối.
- response.output_text chứa câu trả lời ngắn được yêu cầu.
- Bảng điều khiển GetAPI.ONE hiển thị bản ghi yêu cầu hoặc mức sử dụng khớp với khóa.
Sửa lỗi thường gặp
| Triệu chứng | Kiểm tra |
|---|---|
| 401 hoặc lỗi xác thực | Sao chép lại khóa ONE, xác nhận khóa được bật và biến môi trường thuộc về tiến trình này. |
| 404 | Giữ đúng một /v1 trong base_url và chỉ dùng phương thức Responses cho mô hình công bố điểm cuối đó. |
| Mô hình không khả dụng hoặc không tương thích | Sao chép lại đúng mã từ danh mục hiện tại; không suy đoán bí danh. |
Giữ tích hợp an toàn
- Chỉ chạy SDK trong mã công cụ cục bộ hoặc máy chủ đáng tin cậy, không chạy trong JavaScript trình duyệt.
- Loại trừ tệp .env khỏi quản lý phiên bản và thay khóa ngay nếu bị lộ.
- Dùng khóa riêng có phạm vi giới hạn cho môi trường phát triển và sản xuất.
Các bước tiếp theo
- Truyền luồng phản hồiXử lý các sự kiện vòng đời SSE và kết quả kết thúc.
- Chọn mô hìnhĐối chiếu tác vụ với đặc tả điểm cuối trong danh mục.