Gửi yêu cầu API GetAPI.ONE

Điều kiện tiên quyết và giới hạn

• Khóa GetAPI.ONE có phạm vi giới hạn, được lưu trong GETAPI_ONE_API_KEY.
• Mô hình hiện tại trong danh mục liệt kê rõ loại điểm cuối bạn muốn gọi.
• Môi trường dòng lệnh đã cài curl và cho phép HTTPS đi ra www.getapi.one.
• Ngân sách cho một yêu cầu thực tối thiểu, có thể phát sinh phí sử dụng.

• Tạo và nạp khóa
• Chọn mô hình tương thích với điểm cuối

1. Chọn điểm cuối được công bố

Các dòng giao thức khác dùng đường dẫn và nội dung yêu cầu khác nhau. Làm theo điểm cuối hiển thị trên trang mô hình đã chọn; không chuyển mọi lệnh gọi Anthropic, Gemini, ảnh hoặc video về hai ví dụ ở trên.

2. Ví dụ Responses API

Chỉ dùng sau khi chọn mô hình danh mục liệt kê điểm cuối Responses. Thay YOUR_RESPONSES_MODEL trước khi chạy.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Ví dụ Chat Completions

Chỉ dùng khi mô hình danh mục đã chọn liệt kê điểm cuối OpenAI Chat. Thay YOUR_CHAT_MODEL trước khi chạy.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Kiểm tra kết quả

1. Đọc trạng thái HTTP trước. Trạng thái 2xx nghĩa là cổng API đã chấp nhận và hoàn tất yêu cầu HTTP, nhưng ứng dụng khách vẫn phải kiểm tra đối tượng phản hồi để tìm đầu ra mong đợi.
2. Với Responses, kiểm tra cấu trúc trạng thái/đầu ra phản hồi trả về. Với Chat Completions, kiểm tra cấu trúc choices trả về. Không giả định hai giao thức dùng cùng một cấu trúc phản hồi.
3. Mở nhật ký yêu cầu hoặc mức sử dụng GetAPI.ONE và đối chiếu thời gian, điểm cuối, mô hình cùng mã định danh yêu cầu nếu có.

Truyền luồng và thử lại

Truyền luồng thay đổi cách truyền phản hồi và xử lý sự kiện; khả năng hỗ trợ phụ thuộc điểm cuối và mô hình đã chọn. Bắt đầu bằng yêu cầu không truyền luồng, rồi xem tài liệu giao thức và trang mô hình trước khi thêm tham số stream.

• Không tự động thử lại lỗi xác thực, hạn mức, quyền hoặc chọn mô hình.
• Trước khi thử lại yêu cầu hết thời gian chờ hoặc lỗi thượng nguồn, xác định liệu yêu cầu ban đầu có thể đã được xử lý và thao tác có an toàn để lặp lại hay không.
• Dùng số lần thử lại có giới hạn và thời gian chờ tăng dần trong ứng dụng; giữ mã định danh yêu cầu và dấu thời gian để chẩn đoán.

Các trường hợp lỗi

• Danh sách kiểm tra khắc phục sự cố
• Chuẩn bị báo cáo hỗ trợ